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 NamelistAttrs 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 for NamelistType (MQIA_NAMELIST_TYPE), we cannot also specify the NamelistType parameter.

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

NamelistAttrs (MQCFIL)

Namelist attributes (parameter identifier: MQIACF_NAMELIST_ATTRS).

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

MQIACF_ALL

All attributes.

or a combination of the following:

MQCA_NAMELIST_NAME

Name of namelist object.

MQCA_NAMELIST_DESC

Namelist description.

MQCA_NAMES

Names in the namelist.

MQCA_ALTERATION_DATE

The date on which the information was last altered.

MQCA_ALTERATION_TIME

The time at which the information was last altered.

MQIA_NAME_COUNT

Number of names in the namelist.

MQIA_NAMELIST_TYPE

Namelist type (valid only on z/OS)

NamelistType (MQCFIN)

Namelist attributes (parameter identifier: MQIA_NAMELIST_TYPE). This parameter applies to z/OS only.

Specifies the type of names in the namelist. The value can be:

MQNT_NONE

The names are of no particular type.

MQNT_Q

A namelist that holds a list of queue names.

MQNT_CLUSTER

A namelist that is associated with clustering, containing a list of the cluster names.

MQNT_AUTH_INFO

The namelist is associated with SSL, and contains a list of authentication information object names.

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 NamelistAttrs except MQCA_NAMELIST_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 Namelist

pc12770_

 

Home