Home

 

Response data if StatusType is MQIACF_Q_HANDLE

 

ApplTag (MQCFST)

Open application tag (parameter identifier: MQCACF_APPL_TAG).

The maximum length of the string is MQ_APPL_TAG_LENGTH.

ApplType (MQCFIN)

Open application type (parameter identifier: MQIA_APPL_TYPE).

The value can be:

MQAT_QMGR

A queue manager process.

MQAT_CHANNEL_INITIATOR

The channel initiator.

MQAT_USER

A user application.

MQAT_BATCH

Application using a batch connection. This applies only to z/OS.

MQAT_RRS_BATCH

RRS-coordinated application using a batch connection. This applies only to z/OS.

MQAT_CICS

A CICS transaction. This applies only to z/OS.

MQAT_IMS

An IMS™ transaction. This applies only to z/OS.

ASId (MQCFST)

Address-space identifier (parameter identifier: MQCACF_ASID).

The 4–character address-space identifier of the application identified by ApplTag. It distinguishes duplicate values of ApplTag. This parameter applies only to z/OS.

The length of the string is MQ_ASID_LENGTH.

ChannelName (MQCFST)

Channel name (parameter identifier: MQCACH_CHANNEL_NAME).

The maximum length of the string is MQ_CHANNEL_NAME_LENGTH.

Conname (MQCFST)

Connection name (parameter identifier: MQCACH_CONNECTION_NAME).

The maximum length of the string is MQ_CONN_NAME_LENGTH.

ExternalUOWId (MQCFBS)

RRS unit-of–recovery identifier (parameter identifier: MQBACF_EXTERNAL_UOW_ID).

The RRS unit-of-recovery identifier associated with the handle. This parameter is valid only on z/OS only.

The length of the string is MQ_EXTERNAL_UOW_ID_LENGTH.

HandleState (MQCFIN)

State of the handle (parameter identifier: MQIACF_HANDLE_STATE).

The value may be:

MQHSTATE_ACTIVE

An API call from a connection is currently in progress for this object. For a queue, this condition can arise when an MQGET WAIT call is in progress.

If there is an MQGET SIGNAL outstanding, then this does not mean, by itself, that the handle is active.

MQHSTATE_INACTIVE

No API call from a connection is currently in progress for this object. For a queue, this condition can arise when no MQGET WAIT call is in progress.

OpenBrowse (MQCFIN)

Open browse (parameter identifier: MQIACF_OPEN_BROWSE).

The value can be:

MQQSO_YES

The queue is open for browsing.

MQQSO_NO

The queue is not open for browsing.

OpenInputType (MQCFIN)

Open input type (parameter identifier: MQIACF_OPEN_INPUT_TYPE).

The value can be:

MQQSO_NO

The queue is not open for inputing.

MQQSO_SHARED

The queue is open for shared input.

MQQSO_EXCLUSIVE

The queue is open for exclusive input.

OpenInquire (MQCFIN)

Open inquire (parameter identifier: MQIACF_OPEN_INQUIRE).

The value can be:

MQQSO_YES

The queue is open for inquiring.

MQQSO_NO

The queue is not open for inquiring.

OpenOptions (MQCFIN)

Open options currently in force for the queue (parameter identifier: MQIACF_OPEN_OPTIONS).

OpenOutput (MQCFIN)

Open output (parameter identifier: MQIACF_OPEN_OUTPUT).

The value can be:

MQQSO_YES

The queue is open for outputting.

MQQSO_NO

The queue is not open for outputting.

OpenSet (MQCFIN)

Open set (parameter identifier: MQIACF_OPEN_SET).

The value can be:

MQQSO_YES

The queue is open for setting.

MQQSO_NO

The queue is not open for setting.

ProcessId (MQCFIN)

Open application process ID (parameter identifier: MQIACF_PROCESS_ID).

PSBName (MQCFST)

Program specification block (PSB) name (parameter identifier: MQCACF_PSB_NAME).

The 8–character name of the PSB associated with the running IMS transaction. This parameter is valid on z/OS only.

The length of the string is MQ_PSB_NAME_LENGTH.

PSTId (MQCFST)

Program specification table (PST) identifier (parameter identifier: MQCACF_PST_ID).

The 4–character identifier of the PST region identifier for the connected IMS region. This parameter is valid on z/OS only.

The length of the string is MQ_PST_ID_LENGTH.

QMgrUOWId (MQCFBS)

The unit of recovery assigned by the queue manager (parameter identifier: MQBACF_Q_MGR_UOW_ID).

On z/OS, this is a 6–byte log RBA, displayed as 12 hexadecimal characters. On platforms other than z/OS, this is an 8–byte transaction identifier, displayed as 16 hexadecimal characters.

The maximum length of the string is MQ_UOW_ID_LENGTH.

QName (MQCFST)

Queue name (parameter identifier: MQCA_Q_NAME).

The maximum length of the string is MQ_Q_NAME_LENGTH.

QSGDisposition (MQCFIN)

QSG disposition (parameter identifier: MQIA_QSG_DISP).

Returns the disposition of the object (that is, where it is defined and how it behaves). This parameter is valid on z/OS only. 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.

StatusType (MQCFST)

Queue status type (parameter identifier: MQIACF_Q_STATUS_TYPE).

Specifies the type of status information.

TaskNumber (MQCFST)

CICS task number (parameter identifier: MQCACF_TASK_NUMBER).

A 7–digit CICS task number. This parameter is valid on z/OS only.

The length of the string is MQ_TASK_NUMBER_LENGTH.

ThreadId (MQCFIN)

Open application thread ID (parameter identifier: MQIACF_THREAD_ID).

The maximum length of the string is MQ_PROCESS_NAME_LENGTH.

TransactionId (MQCFST)

CICS transaction identifier (parameter identifier: MQCACF_TRANSACTION_ID).

A 4–character CICS transaction identifier. This parameter is valid on z/OS only.

The length of the string is MQ_TRANSACTION_ID_LENGTH.

UOWIdentifier (MQCFBS)

The external unit of recovery associated with the connection (parameter identifier: MQBACF_EXTERNAL_UOW_ID).

This is the recovery identifier for the unit of recovery. Its format is determined by the value of UOWType.

The maximum length of the string is MQ_UOW_ID_LENGTH.

UOWType (MQCFIN)

Type of external unit of recovery identifier as perceived by the queue manager (parameter identifier: MQIACF_UOW_TYPE).

The value can be:

MQUOWT_Q_MGR

MQUOWT_CICS

Valid only on z/OS.

MQUOWT_RRS

Valid only on z/OS.

MQUOWT_IMS

Valid only on z/OS.

MQUOWT_XA

UOWType identifies the UOWIdentifier type and not the type of the transaction coordinator. When the value of UOWType is MQUOWT_Q_MGR, the associated identifier is in QMgrUOWId (and not UOWIdentifier).

UserIdentifier (MQCFST)

Open application username (parameter identifier: MQCACF_USER_IDENTIFIER).

The maximum length of the string is MQ_MAX_USER_ID_LENGTH.

 

Parent topic:

Inquire Queue Status (Response)


pc13200_


 

Home