Home
Handle attrs
If TYPE is set to HANDLE, the following information is always returned for each connection that satisfies the selection criteria, except where indicated:
- Connection identifier (CONN parameter)
- Type of information returned (TYPE parameter)
- Handle status (HSTATE)
- Object name (OBJNAME parameter)
- Object type (OBJTYPE parameter)
The following parameters can be specified for TYPE(HANDLE) to request additional information for each queue. If a parameter is specified that is not relevant for the connection, operating environment, or type of status information requested, that parameter is ignored.
- HSTATE
- The state of the handle.
Possible values are:
- ACTIVE
- An API call from this connection is currently in progress for this object. If the object is 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.
- INACTIVE
- No API call from this connection is currently in progress for this object. If the object is a queue, this condition can arise when no MQGET WAIT call is in progress.
- OBJNAME
- The name of an object that the connection has open.
- OBJTYPE
- The type of the object that the connection has open.
It is one of the following:
- QUEUE
- PROCESS
- QMGR
- STGCLASS (valid only on z/OS)
- NAMELIST
- CHANNEL
- AUTHINFO
- OPENOPTS
- The open options currently in force for the connection for the object.
Possible values are:
- MQOO_INPUT_AS_Q_DEF
- Open queue to get messages using queue-defined default.
- MQOO_INPUT_SHARED
- Open queue to get messages with shared access.
- MQOO_INPUT_EXCLUSIVE
- Open queue to get messages with exclusive access.
- MQOO_BROWSE
- Open queue to browse messages.
- MQOO_OUTPUT
- Open queue to put messages.
- MQOO_INQUIRE
- Open queue to inquire attributes.
- MQOO_SET
- Open queue to set attributes.
- MQOO_BIND_ON_OPEN
- Bind handle to destination when queue is found.
- MQOO_BIND_NOT_FIXED
- Do not bind to a specific destination.
- MQOO_SAVE_ALL_CONTEXT
- Save context when message retrieved.
- MQOO_PASS_IDENTITY_CONTEXT
- Allow identity context to be passed.
- MQOO_PASS_ALL_CONTEXT
- Allow all context to be passed.
- MQOO_SET_IDENTITY_CONTEXT
- Allow identity context to be set.
- MQOO_SET_ALL_CONTEXT
- Allow all context to be set.
- MQOO_ALTERNATE_USER_AUTHORITY
- Validate with specified user identifier.
- MQOO_FAIL_IF_QUIESCING
- Fail if queue manager is quiescing.
- QSGDISP
- Indicates the disposition of the object. It is valid on z/OS only. The value is one of the following:
- QMGR
- The object was defined with QSGDISP(QMGR).
- COPY
- The object was defined with QSGDISP(COPY).
- SHARED
- The object was defined with QSGDISP(SHARED).
We cannot use QSGDISP as a filter keyword.
Parent topic:
Parameter descriptions
sc11980_
Home