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 Oracle AQ 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 |
|---|---|---|---|
| Oracle AQ | AQ | -IMAQcard_num | -OMAQcard_num |
When using an adapter alias with the execution command, the Oracle AQ Adapter commands can be issued on the command line or in a command file. Use the adapter commands to specify adapter functions such as:
- Setting a priority level of a message.
- Identifying subscribers and recipients when using multi-consumer queues.
- 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 Oracle AQ environment might be:
-OMAQ1 '-Q DEV.ITQUE -C 4aq -US wb -PW y4i6 -EQ ERR.ITQUE -T'
This example execution command string defines the Oracle AQ Adapter as the data target. The required Queue Name adapter command (-Q DEV.ITQUE) specifies a queue named DEV.ITQUE. The required connect string 4AQ is specified using the Connect String adapter command (-C 4AQ). The user ID wb is specified using the required User ID adapter command (-US wb). The password y4i6 is specified using the required Password adapter command (-PW y4i6). The Exception Queue adapter command (-EQ ERR.ITQUE) specifies an exception queue ERR.ITQUE, in which the message is moved if it is not successfully processed. The Trace adapter 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.