Command alias
Adapter commands can be specified by using an execution command string on the command line or by creating a command file that contains adapter commands dictating the desired execution settings. For information about all of the options you can use with the execution commands for adapters or how to create a command file, see the Execution Commands documentation.
Use the Input Source Override - Message execution command (-IM) and the Output Target Override - Message execution command (-OM) with the appropriate MSMQ Adapter-specific alias. 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 alias and execution commands.
Adapter | Alias | As Input | As Output |
---|---|---|---|
MSMQ | MSMQ | -IMMSMQcard_num | -OMMSMQcard_num |
When using an adapter alias with the execution command, the MSMQ 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 the MSMQ environment might be:
-IMMSMQ1 '-QN .\topqueue -T'
This sample execution command string specifies a local queue named topqueue as the source for this card's data. The Trace command (-T) indicates that a trace file will be created to report adapter activity information, recording the events that occur while the adapter is retrieving this data.