Command aliases
Adapter commands can be specified by using a command string on the command line or by creating a command file that contains adapter commands. The execution command syntax is:
-IM[ alias } card_num
-OM[ alias ] card_num
where -IM is the Input Source - Override execution command and -OM is the Output Target - Override execution command, alias is the adapter alias, and card_num is the number of the input or output card, respectively. The following table shows the adapter aliases and execution commands.
Adapter | Alias | As Input | As Output |
---|---|---|---|
IBM® MQ (client) | MQSC | -IMMQSCcard_num | -OMMQSCcard_num |
IBM® MQ (server) | MQS | -IMMQScard_num | -OMMQScard_num |
When using an adapter alias with the execution command, the IBM® MQ adapter commands can be issued on the command line or in a command file. Use the adapter commands to specify adapter functions such as:
- specifying a particular message identifier
- allowing output data to be broken up into multiple messages
- retrieving a logical message from a source queue with a correlation identifier
For example, to override the adapter commands defined in output card 1, the command string for the adapter in an IBM® MQ server environment might be:
-IMMQS1 '-QMN queuemgr -QN topqueue -T'
This sample execution command string specifies the queue manager named queuemgr and the queue named topqueue as the source for this card's data. The -T command dictates that a trace file be created to report adapter activity information, recording the events that occur while the adapter is retrieving this data.