Newer version of documentation BMC provides a newer version of the documentation for this version of the product. As a result, BMC no longer accepts comments in this space.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see bao8301.

(optional) Modifying AAOMQLxx parameter settings

Review the parameter settings in BBPARM member AAOMQLxx.

The parameters in this member specify which IBM MQ queues can be monitored (or listened to) by BMC AMI Ops Automation for MQ automation. The parameters are as follows:

  • TYPE=(INCL|EXCL) or T=(I | E)

    Specifies whether BMC AMI Ops Automation for MQ should include or exclude this queue in the set of queues that is eligible for automation

    Possible values are as follows:

    Value

    Description

    INCL | I

    Specifies that BMC AMI Ops Automation should make this queue eligible for possible automation

    This is the default setting.

    EXCL | E

    Specifies that BMC AMI OpsA should not make this queue eligible for automation

    The following example shows this option used with abbreviations:

    T(I) or T(E)

  • QMGR(queue manager name) or M(queue manager name)

    Specifies the four-character ID for a local z/OS queue manager that BMC AMI OpsA will monitor

    You must specify a queue manager name or a partial queue manager name. There is no default value for this parameter.

    The abbreviation for QMGR is M; for example:

    M(CSQ1)

  • QUEUE(queue name) or U(queue name)

    Specifies the 48-character name of the queue that BMC AMI OpsA will make eligible for automation

    You must specify a queue name or a partial queue name. There is no default value for this parameter.

    The abbreviation for QUEUE is U; for example:

    U(SYSTEM.ADMIN.QMGR.EVENT)

  • OPEN or O

    Specifies how the queue is opened and what to do with the messages in the queue after it is opened

    The abbreviation for OPEN is O and O can be used with the following subparameters:

    Subparameter for OPEN

    Description

    Combination 1

    EXCLUSIVE | E

    Indicates the queue should be opened with the MQOO_INPUT_EXCLUSIVE open option

    Other applications are unable to open the queue while BMC AMI OpsA has it open. It also means that if another application has the queue opened, BMC AMI OpsA will be unable to open it. The abbreviation is E.

    SHARED | S

    Indicates the queue should be opened with the MQOO_INPUT_SHARED option

    This subparameter is the default for option 1. The abbreviation is S.

    Combination 2

    PROCESSOLD | P

    Indicates that all messages found on the queue when it is opened should be routed through the Rule Processor to allow automation to take place

    This parameter is useful for processing messages that were put on the queue while the queue was not opened by BMC AMI OpsA. The abbreviation is P.

    IGNOREOLD | I

    Indicates that BMC AMI OpsA will not process the existing messages on the queue and no automation takes place for those messages

    This subparameter is the default for option 2. The abbreviation is I.

Examples

The following examples show different options for opening the queue.

Example

This example shows that the queue will be opened with the MQOO_INPUT_EXCLUSIVE option, and that all existing messages found on the queue at open time should be routed through the Rule Processor for automation.

OPEN(EXCLUSIVE,PROCESSOLD)

or

O(E,P)
Example

This example shows that the queue will be opened with the MQOO_INPUT_SHARED option, and that all existing messages found on the queue at open time should be ignored.

OPEN(SHARED,IGNOREOLD)

or

O(S,I)

For more information about setting these parameters and an example of how to set them, refer to Parameters-for-BBPARM-member-AAOMQLxx.

This section contains the following topic:

Related topic

Installation-overview


 

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