CDServer configurable service

You can use configurable services if, for example, you have different CDOutput nodes addressing more than one Connect:Direct® server.

To change the CDServer configurable service properties, you must specify the broker name and -c CDServer.

The -o parameter is set to the name of the configurable service you are using.

You can edit the predefined configurable service, named Default, to alter the default behavior of the CDInput and CDOutput nodes.

Alternatively, you can create your own configurable service, name it (for example, -o myCDServer), and reference this configurable service in the CDServer configurable service property of the CDInput or CDOutput node; for more information, see CDInput node and CDOutput node.

The hostname and port properties are mandatory; all the other properties are optional.

-n hostname

The host name of the Connect:Direct server

• Value type - string
• Initial value - localhost
• Other valid value:
  • Host name of the machine running the Connect:Direct server.

-n port

The API port of the Connect:Direct server.

• Value type - string
• Initial value - 1363
• Other valid value:
  • API port on which the Connect:Direct server is listening.

-n brokerPathToStagingDir

The high level path used by the CDOutput node for staging files to transfer. The CDOutput node creates directories and files under this path.

The path given is used by the broker on the machine running the IBM Integration Bus. The Connect:Direct server must have access to these files and if it is on a different machine, the directory must be mounted on the remote machine.

If the remote path to the mounted directory is different on the IBM Sterling Connect:Direct machine, the cdPathToStagingDir must be set to the correct value.

• Value type - string
• Initial value - ""

  If not set, the broker uses the following default location: $MQSI_WORKPATH/common/CD/Tranfers

• Other valid value:
  • Any path on the brokers machine to which the broker user has both read and write access.

-n cdPathToStagingDir

The high level path used by the Connect:Direct server node for accessing files staged by the CDOutput node. The CDOutput node creates directories and files under this path which the Connect:Direct server must have access to. The path given is used by the Connect:Direct server on the machine running the Connect:Direct server.

• Value type - string
• Initial value - ""

  If not set, the value uses the default location set in brokerPathToStagingDir

• Other valid value:
  • The path on the Connect:Direct server machine that allows access to the files staged by the CDOutput node.

-n cdPathToInputDir

The directory, including all subdirectories, on the Connect:Direct server machine that contains the files transferred by CD in which this configurable service is interested. Transfers to any other directory are ignored.

For IBM Integration Bus to be able to process the files transferred to this directory, this directory must be accessible toIBM Integration Bus.

If the directory is remote, the directory must be mounted to the IBM Integration Bus machine. If the mounted file system has a different path on the IBM Integration Bus machine, the brokerPathToInputDir must be set to the correct value.

• Value type - string
• Initial value - ""

  The CDInput node uses the file path sent by the Connect:Direct server.

• Other valid value:
  • A path to a directory structure on the Connect:Direct server machine.

-n brokerPathToInputDir

The file path to reach files transferred to cdPathToInputDir from the IBM Integration Bus machine.

• Value type - string
• Initial value - ""

  The CDInput node uses the file path sent by the Connect:Direct server.

• Other valid value:
  • A path to a directory structure on the IBM Integration Bus machine.

-n queuePrefix

A queue prefix for use when IBM Integration Bus stores data on WebSphere® MQ about this Connect:Direct server. Two queues are used to store state:

• SYSTEM.BROKER.CD.STATS
• SYSTEM.BROKER.CD.TRANSFERS

If you give a prefix, use the following queue name formats:

• SYSTEM.BROKER.CD.<queuePrefix>.STATS
• SYSTEM.BROKER.CD.<queuePrefix>.TRANSFERS

• Value type - string
• Initial value - ""

  The SYSTEM.BROKER.CD.STATS queue and SYSTEM.BROKER.CD.TRANSFERS queue are used.

• Other valid value:
  • The queues are created and used with the <queuePrefix> inserted. The <queuePrefix> must:
    • Be a maximum length of 16 characters
    • Be a valid value for a queue name
    • Not begin or end in a period.

-n securityIdentity

A security identity used to connect to the Connect:Direct server.

• Value type - string
• Initial value - default

  The default security identity is used.

• Other valid value:
  • Any valid security identity that is defined on the broker. You must define the identity by using the syntax cd::<name>.

See the mqsichangeproperties command for examples of its use.