Command set method for dequeuing shared queues messages

The non-interactive method of dequeueing requires that you code your own DEQUEUE command set and submit it to an online server or a batch Message Advisor server. To use the online server approach, perform the following steps:

  1. From the Message Advisor Primary Menu, select option 1.
  2. Because the Build feature of the panels does not support any keywords for shared queues, BMC Software recommends that you use the edit function (select E on a member name, or type E member on the command line) to change or create a member and to set up one or more command sets with IMSIDs that identify IMS systems which use shared queues.Here are some tips for creating and executing a DEQUEUE command set for shared queues:

    • For a simple dequeue of a destination, BMC Software recommends by using the DEST, AFFINITY, and QTYPE keywords on a SELECT subcommand. Processing will be more efficient if all three keywords are specified, since they can be used to construct a complete shared queues key.

      Example
      DEQUEUE IMSID=IMSA
       SELECT DEST=L3960T2,QTYPE=LTERM5,AFFINITY=&NONE
      END
    • Avoid using the DESTYPE and QUEUE keywords. Use the AFFINITY and/or QTYPE keyword with the SELECT subcommand instead. Use these keywords only with command sets that specify an IMSID of a shared queues system; otherwise, the command set terminates with an error message.

    • Use SCOPE to limit processing and/or improve efficiency; otherwise, SCOPE defaults to ALLQ, which processes both local and shared queues.

      Note

      When a multi-record message is selected for dequeue, the middle-in-chain and last-in-chain records are dequeued even if they exist in a different structure and the structure was excluded with the PRIMARY value or the OVERFLOW value with the SCOPE keyword. If the first-in-chain record is selected, all remaining records are also processed.

    • You can use the QTYPE keyword with the SELECT subcommand, with other keywords such as DEST (with or without masking), to target one or more destinations to be dequeued. You can also use the QTYPE keyword on the REJECT subcommand.
    • You can use MODE=VALIDATE to determine the extent of work that Message Advisor would perform with the default value MODE=DEQUEUE. MODE=VALIDATE is similar to executing an UNLOAD command without the unload data set. This is a good practice when dequeueing more than a single destination.

Related topic

Dequeueing-shared-queues-messages



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*