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(*)
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 BMC-AMI-Ops-Automation-for-MQ-BBI-commands.