Home

 

Optional parameters

 

AuthInfoAttrs (MQCFIL)

Authentication information object attributes (parameter identifier: MQIACF_AUTH_INFO_ATTRS).

The attribute list can 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_ALTERATION_DATE

Date on which the definition was last altered.

MQCA_ALTERATION_TIME

Time at which the definition was last altered.

MQCA_AUTH_INFO_NAME

Name of the authentication information object.

MQIA_AUTH_INFO_TYPE

Type of authentication information object.

MQCA_AUTH_INFO_CONN_NAME

Connection name of the authentication information object.

MQCA_LDAP_USER_NAME

LDAP user name in the authentication information object.

MQCA_LDAP_PASSWORD

LDAP password in the authentication information object.

MQCA_AUTH_INFO_DESC

Description of the authentication information object.

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. You 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 of those allowed in AuthInfoAttrs, 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.

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 of those allowed in AuthInfoAttrs, except MQCA_AUTH_INFO_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 Authentication Information Object


pc11810_


 

Home