mqsicreateworkdir command

Use the mqsicreateworkdir command to create a work directory to be used by an IBM® App Connect Enterprise integration server.

Purpose

You use the mqsicreateworkdir command to create a new directory to be used as an integration server's work directory.

This command creates a work directory, containing a default configuration file called server.conf.yaml. This YAML file contains the default settings for your new integration server. For information about modifying this configuration file, see Configuring an integration server by modifying the server.conf.yaml file.

The mqsicreateworkdir command also creates three subdirectories in the specified work directory, which are used by the integration server when it is running: config, overrides, and run. For example, if you deploy a BAR file to the integration server by using the mqsibar command, the contents of the BAR file are unpacked into the run directory that is created by the mqsicreateworkdir command.

For more information about starting an integration server and deploying a BAR file to it, see Starting an integration server and Deploying integration solutions to a production environment.

Usage notes

  • The directory that you specify with this command must be a new directory; if the directory that you specify already exists in the file system, an error occurs.
  • You must specify the full path to the directory that you want to create; for example:
    mqsicreateworkdir c:\mywrk\myaceworkdir

For more information about using the mqsicreateworkdir command, see Configuring an integration server by modifying the server.conf.yaml file.

Parameters

workDir
(Required) This parameter specifies the full path to the directory that you want to create as the integration server's work directory.
The following example shows how to create a work directory called c:\mywrk\myaceworkdir:
mqsicreateworkdir c:\mywrk\myaceworkdir

 

Examples

Always enter the command on a single line.

The following example shows how to create an integration server work directory called c:\mywrk\myaceworkdir:
mqsicreateworkdir c:\mywrk\myaceworkdir