Home

 

Optional parameters

 

CommandScope (MQCFST)

Command scope (parameter identifier: MQCACF_COMMAND_SCOPE). This parameter applies to z/OS only.

Specifies how the command is executed when the queue manager is a member of a queue-sharing group. We can specify one of the following:

• blank (or omit the parameter altogether). The command is executed on the queue manager on which it was entered.

• a queue manager name. The command is executed on the queue manager you specify, providing it is active within the queue sharing group. If you specify a queue manager name other than the queue manager on which it was entered, be using a queue-sharing group environment, and the command server must be enabled.

• an asterisk (*). The command is executed on the local queue manager and is also passed to every active queue manager in the queue-sharing group.

The maximum length is MQ_QSG_NAME_LENGTH.

We cannot use CommandScope as a parameter to filter on.

IntegerFilterCommand (MQCFIF)

Integer filter command descriptor. The parameter identifier must be any integer type parameter allowed in ProcessAttrs except MQIACF_ALL. Use this to restrict the output from the command by specifying a filter condition. See MQCFIF - PCF integer filter parameter for information about using this filter condition.

If you specify an integer filter, we cannot also specify a string filter using the StringFilterCommand parameter.

ProcessAttrs (MQCFIL)

Process attributes (parameter identifier: MQIACF_PROCESS_ATTRS).

The attribute list might specify the following on its own (this is the default value used if the parameter is not specified):

MQIACF_ALL

All attributes.

or a combination of the following:

MQCA_ALTERATION_DATE

The date at which the information was last altered.

MQCA_ALTERATION_TIME

The time at which the information was last altered.

MQCA_APPL_ID

Application identifier.

MQCA_ENV_DATA

Environment data.

MQCA_PROCESS_DESC

Description of process definition.

MQCA_PROCESS_NAME

Name of process definition.

MQCA_USER_DATA

User data.

MQIA_APPL_TYPE

Application type.

QSGDisposition (MQCFIN)

Disposition of the object within the group (parameter identifier: MQIA_QSG_DISP). This parameter applies to z/OS only.

Specifies the disposition of the object for which information is to be returned (that is, where it is defined and how it behaves). The value can be:

MQQSGD_LIVE

The object is defined as MQQSGD_Q_MGR or MQQSGD_COPY. This is the default value if the parameter is not specified.

MQQSGD_ALL

The object is defined as MQQSGD_Q_MGR or MQQSGD_COPY.

If there is a shared queue manager environment, and the command is being executed on the queue manager where it was issued, this option also displays information for objects defined with MQQSGD_GROUP.

If MQQSGD_LIVE is specified or defaulted, or if MQQSGD_ALL is specified in a shared queue manager environment, the command might give duplicated names (with different dispositions).

MQQSGD_COPY

The object is defined as MQQSGD_COPY.

MQQSGD_GROUP

The object is defined as MQQSGD_GROUP. This is permitted only in a shared queue environment.

MQQSGD_Q_MGR

The object is defined as MQQSGD_Q_MGR.

MQQSGD_PRIVATE

The object is defined as either MQQSGD_Q_MGR or MQQSGD_COPY. Note that MQQSGD_PRIVATE returns the same information as MQQSGD_LIVE.

We cannot use QSGDisposition as a parameter to filter on.

StringFilterCommand (MQCFSF)

String filter command descriptor. The parameter identifier must be any string type parameter allowed in ProcessAttrs except MQCA_PROCESS_NAME. Use this to restrict the output from the command by specifying a filter condition. See MQCFSF - PCF string filter parameter for information about using this filter condition.

If you specify a string filter, we cannot also specify an integer filter using the IntegerFilterCommand parameter.

 

Parent topic:

Inquire Process

pc12870_

 

Home