Home

 

Optional parameters

 

ByteStringFilterCommand (MQCFBF)

Byte string filter command descriptor. The parameter identifier must be MQBACF_EXTERNAL_UOW_ID or MQBACF_Q_MGR_UOW_ID. Use this to restrict the output from the command by specifying a filter condition. See MQCFBF - PCF byte string filter parameter for information about using this filter condition.

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

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 QStatusAttrs except MQIACF_ALL, MQIACF_MONITORING, and MQIACF_Q_TIME_INDICATOR. 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 byte string filter using the ByteStringFilterCommand parameter or a string filter using the StringFilterCommand parameter.

OpenType (MQCFIN)

Queue status open type (parameter identifier: MQIACF_OPEN_TYPE).

It is always returned, regardless of the queue instance attributes requested.

The value can be:

MQQSOT_ALL

Selects status for queues that are open with any type of access.

MQQSOT_INPUT

Selects status for queues that are open for input.

MQQSOT_OUTPUT

Selects status for queues that are open for output.

The default value if this parameter if not specified is MQQSOT_ALL.

Filtering is not supported for this parameter.

QSGDispositon (MQCFIN)

QSG disposition (parameter identifier: MQIA_QSG_DISP).

Specifies the disposition of the object (that is, where it is defined and how it behaves). This is valid only on z/OS. The value can be:

MQQSGD_COPY

The object is defined as MQQSGD_COPY.

MQQSGD_Q_MGR

The object is defined as MQQSGD_Q_MGR.

MQQSGD_SHARED

The object is defined as MQQSGD_SHARED.

We cannot use QSGDispositon as a parameter to filter on.

QStatusAttrs (MQCFIL)

Queue status attributes (parameter identifier: MQIACF_Q_STATUS_ATTRS).

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

Where StatusType is MQIACF_Q_STATUS:

MQCA_Q_NAME

Queue name.

MQCACF_LAST_GET_DATE

Date of the last message successfully destructively read from the queue.

MQCACF_LAST_GET_TIME

Time of the last message successfully destructively read from the queue.

MQCACF_LAST_PUT_DATE

Date of the last message successfully put to the queue.

MQCACF_LAST_PUT_TIME

Time of the last message successfully put to the queue.

MQCACF_MEDIA_LOG_EXTENT_NAME

Identity of the oldest log extent needed to perform media recovery of the queue.

On i5/OS, this identifies the name of the oldest journal receiver needed to perform media recovery of the queue.

MQIA_CURRENT_Q_DEPTH

The current number of messages on the queue.

MQIA_MONITORING_Q

Current level of monitoring data collection.

MQIA_OPEN_INPUT_COUNT

The number of handles that are currently open for input for the queue. This does not include handles that are open for browse.

MQIA_OPEN_OUTPUT_COUNT

The number of handles that are currently open for output for the queue.

MQIACF_HANDLE_STATE

Whether an API call is in progress.

MQIACF_MONITORING

All of the queue status monitoring attributes. These are:

• MQCACF_LAST_GET_DATE

• MQCACF_LAST_GET_TIME

• MQCACF_LAST_PUT_DATE

• MQCACF_LAST_PUT_TIME

• MQIA_MONITORING_Q

• MQIACF_OLDEST_MSG_AGE

• MQIACF_Q_TIME_INDICATOR

Filtering is not supported for this parameter.

MQIACF_OLDEST_MSG_AGE

Age of oldest message on the queue.

MQIACF_Q_TIME_INDICATOR

Indicator of the time that messages remain on the queue.

MQIACF_UNCOMMITED_MSGS

Whether there are uncommitted messages on the queue.

Where StatusType is MQIACF_Q_HANDLE:

MQBACF_EXTERNAL_UOW_ID

Unit of recovery identifier assigned by the queue manager.

MQBACF_Q_MGR_UOW_ID

External unit of recovery identifier associated with the connection.

MQCA_Q_NAME

Queue name.

MQCACF_APPL_TAG

This is a string containing the tag of the application connected to the queue manager.

MQCACF_ASID

Address-space identifier of the application identified by ApplTag. This parameter is valid on z/OS only.

MQCACF_PSB_NAME

Name of the program specification block (PSB) associated with the running IMS™ transaction. This parameter is valid on z/OS only.

MQCACF_PSTID

Identifier of the IMS program specification table (PST) for the connected IMS region. This parameter is valid on z/OS only.

MQCACF_TASK_NUMBER

CICS task number. This parameter is valid on z/OS only.

MQCACF_TRANSACTION_ID

CICS transaction identifier. This parameter is valid on z/OS only.

MQCACF_USER_IDENTIFIER

The username of the application that has opened the specified queue.

MQCACH_CHANNEL_NAME

The name of the channel that has the queue open, if any.

MQCACH_CONNECTION_NAME

The connection name of the channel that has the queue open, if any.

MQIA_APPL_TYPE

The type of application that has the queue open.

MQIACF_OPEN_BROWSE

Open browse.

Filtering is not supported for this parameter.

MQIACF_OPEN_INPUT_TYPE

Open input type.

Filtering is not supported for this parameter.

MQIACF_OPEN_INQUIRE

Open inquire.

Filtering is not supported for this parameter.

MQIACF_OPEN_OPTIONS

The options used to open the queue.

If this parameter is requested, the following parameter structures are also returned:

• OpenBrowse

• OpenInputType

• OpenInquire

• OpenOutput

• OpenSet

Filtering is not supported for this parameter.

MQIACF_OPEN_OUTPUT

Open output.

Filtering is not supported for this parameter.

MQIACF_OPEN_SET

Open set.

Filtering is not supported for this parameter.

MQIACF_PROCESS_ID

The process identifier of the application that has opened the specified queue.

MQIACF_THREAD_ID

The thread identifier of the application that has opened the specified queue.

MQIACF_UOW_TYPE

Type of external unit of recovery identifier as seen by the queue manager.

StatusType (MQCFIN)

Queue status type (parameter identifier: MQIACF_Q_STATUS_TYPE).

Specifies the type of status information required.

The value can be:

MQIACF_Q_STATUS

Selects status information relating to queues.

MQIACF_Q_HANDLE

Selects status information relating to the handles that are accessing the queues.

The default value, if this parameter is not specified, is MQIACF_Q_STATUS.

We cannot use StatusType as a parameter to filter on.

StringFilterCommand (MQCFSF)

String filter command descriptor. The parameter identifier must be any string type parameter allowed in QStatusAttrs except MQCA_Q_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 a byte string filter using the ByteStringFilterCommand parameter or an integer filter using the IntegerFilterCommand parameter.

 

Parent topic:

Inquire Queue Status

pc13160_

 

Home