Example of specifying queues in AAOMQLxx

BMC recommends that you use the following figure as a model for your specifications.

Figure 1. Example of coding in AAOMQLxx member

*----------------------------------------------------------------------
* PARAMETER(DEFAULT)    VALUES ---------- DESCRIPTION -----------------
*
* TYPE(INCL)                   TYPE ABBREVIATED WITH 'T'.
*                        INCL  INCLUDE THIS QUEUE FOR RULES (INCL) OR
*                              ABBREVIATE WITH 'I'.
*                              EXAMPLE: T(I)
*                        EXCL  EXCLUDE (EXCL) THIS QUEUE FOR RULES.
*                              ABBREVIATE WITH 'E'.
*                              EXAMPLE: T(E)
*
* QMGR                         QMGR ABBREVIATED WITH 'M'.
*                              NAME OF IBM MQ QUEUE MANAGER. NO
*                              DEFAULT, THIS PARAMETER MUST BE CODED.
*                              EXAMPLE: M(CSQ1)
*
* QUEUE                        QUEUE ABBREVIATED WITH 'U'.
*                              NAME OF IBM MQ QUEUE. NO DEFAULT,
*                              THIS PARAMETER MUST BE CODED.
*                              EXAMPLE: U(SYSTEM.ADMIN.QMGR.EVENT)
*
* OPEN(S,I)                    OPEN ABBREVIATED WITH 'O'.
*                   EXCLUSIVE  QUEUE OPENED WITH MQOO_INPUT_EXCLUSIVE
*                              OPTION.  ABBREVIATE WITH 'E'.
*
*                      SHARED  QUEUE OPENED WITH MQOO_INPUT_SHARED
*                              OPTION.  ABBREVIATE WITH 'S'.  THIS IS
*                              A DEFAULT OPTION.
*
*                  PROCESSOLD  ROUTE ALL EXISTING MESSAGES FOUND ON
*                              THE QUEUE AT OPEN TIME THROUGH THE RULE
*                              PROCESSOR TO ALLOW AUTOMATION TO BE
*                              PERFORMED ON THEM.  ABBREVIATE WITH 'P'.
*
*                   IGNOREOLD  IGNORE (DO NOT PROCESS) ANY EXISTING
*                              MESSAGES FOUND ON THE QUEUE AT OPEN TIME.
*                              ABBREVIATE WITH 'I'.  THIS IS A DEFAULT
*                              OPTION.
*
*                              EXAMPLE 1: OPEN(EXCLUSIVE,PROCESSOLD) OR
*                              O(E,P) INDICATES THE QUEUE IS TO BE
*                              OPENED WITH THE MQOO_INPUT_EXCLUSIVE
*                              OPTION AND ALL EXISTING MESSAGES FOUND ON
*                              THE QUEUE AT OPEN TIME SHOULD BE ROUTED
*                              THROUGH THE RULE PROCESSOR FOR
*                              AUTOMATION.
*
*                              EXAMPLE 2: OPEN(SHARED,IGNOREOLD) OR
*                              O(S,I) INDICATES THE QUEUE IS TO BE
*                              OPENED WITH THE MQOO_INPUT_SHARED OPTION
*                              AND ALL EXISTING MESSAGES FOUND ON THE
*                              QUEUE AT OPEN TIME SHOULD BE IGNORED.
*
*----------------------------------------------------------------------
* IBM MQ SYSTEM EVENT QUEUES
*----------------------------------------------------------------------
TYPE(INCL) QMGR(*) QUEUE(SYSTEM.ADMIN.*.EVENT)
*
*----------------------------------------------------------------------
* IBM MQ SYSTEM EVENT'S FROM distributed QUEUE MANAGERS
*----------------------------------------------------------------------
TYPE(INCL) QMGR(*) QUEUE(SYSTEM.DISTRIB.EVENTS)
*
*----------------------------------------------------------------------
* REMAINDER OF QUEUES *DO NOT OPEN*
*----------------------------------------------------------------------
TYPE(EXCL) QMGR(*) QUEUE(*)

Note

In the list, you must separately list the queues eligible for automation from the queues that will be excluded from automation.

For each IBM MQ queue manager, MainView AutoOPERATOR matches the list of existing queues to the contents of the active AAOMQLxx member. It sequentially scans the AAOMQLxx member and evaluates the QMGR(queue manager name) and QUEUE(queue name) specifications until a match is found.

When a match is found MainView AutoOPERATOR will either include or exclude the queue based on the TYPE(INCL|EXCL) setting. If two (or more) statements overlap or conflict, the first definition encountered will be used.

Any queue not included in the AAOMQLxx member will not be eligible for automation. If you code a Rule for an excluded queue, the Rule will never fire.

The AAOMQLxx is processed:

  • At BBI-SS PAS startup

  • When the BBI commands .RESET MQ or .RESET QM are issued

For more information about BBI commands for MainView AutoOPERATOR for MQ, refer to MainView AutoOPERATOR for MQ BBI commands.

Note

While MainView AutoOPERATOR has a queue opened, no other application can open exclusively or delete that queue.

Was this page helpful? Yes No Submitting... Thank you

Comments