Fields in MQWQR - Cluster workload queue record structure

Description of the fields in the MQWQR - Cluster workload queue record structure.

StrucId ( MQCHAR4 ) - input
The structure identifier for the cluster workload queue record structure.
  • The StrucId value is MQWQR_STRUC_ID.
  • For the C programming language, the constant MQWQR_STRUC_ID_ARRAY is also defined. It has the same value as MQWQR_STRUC_ID. It is an array of characters instead of a string.
Version ( MQLONG ) - input
The structure version number. Version takes one of the following values:
MQWQR_VERSION_1
Version-1 cluster workload queue record.
MQWQR_VERSION_2
Version-2 cluster workload queue record.
MQWQR_VERSION_3
Version-3 cluster workload queue record.
MQWQR_CURRENT_VERSION
Current version of cluster workload queue record.
StrucLength ( MQLONG ) - input
The length of MQWQR structure. StrucLength takes one of the following values:
MQWQR_LENGTH_1
Length of version-1 cluster workload queue record.
MQWQR_LENGTH_2
Length of version-2 cluster workload queue record.
MQWQR_LENGTH_3
Length of version-3 cluster workload queue record.
MQWQR_CURRENT_LENGTH
Length of current version of cluster workload queue record.
QFlags ( MQLONG ) - input
The queue flags indicate properties of the queue. The following flags are defined:
MQQF_LOCAL_Q
Destination is a local queue.
MQQF_CLWL_USEQ_ANY
Allow use of local and remote queues in puts.
MQQF_CLWL_USEQ_LOCAL
Allow only local queue puts.
Other values
Other flags in the field might be set by the queue manager for internal purposes.
QName ( MQCHAR48 ) - input
The name of the queue that is one of the possible destinations of the message.
  • The length of QName is MQ_Q_NAME_LENGTH.
QMgrIdentifier ( MQCHAR48 ) - input
The queue manager identifier is a unique identifier for the queue manager that hosts the instance of the queue described by the MQWQR structure.
  • The identifier is generated by the queue manager.
  • The length of QMgrIdentifier is MQ_Q_MGR_IDENTIFIER_LENGTH.
ClusterRecOffset ( MQLONG ) - input
The logical offset of the first MQWCR structure that belongs to the MQWQR structure.
  • For static caches, ClusterRecOffset is the offset of the first MQWCR structure that belongs to the MQWQR structure.
  • The offset is measured in bytes from the start of the MQWQR structure.
  • Do not use the logical offset for pointer arithmetic with dynamic caches. To obtain the address of the next record, the MQXCLWLN call must be used.
QType ( MQLONG ) - input
The queue type of the destination queue. The following values are possible:
MQCQT_LOCAL_Q
Local queue.
MQCQT_ALIAS_Q
Alias queue.
MQCQT_REMOTE_ Q
Remote queue.
MQCQT_Q_MGR_ALIAS
Queue manager alias.
QDesc ( MQCHAR64 ) - input
The queue description queue attribute defined on the queue manager that hosts the instance of the destination queue described by the MQWQR structure.
  • The length of QDesc is MQ_Q_DESC_LENGTH.
DefBind ( MQLONG ) - input
The default binding queue attribute defined on the queue manager that hosts the instance of the destination queue described by the MQWQR structure. Either MQBND_BIND_ON_OPEN or MQBND_BIND_ON_GROUP must be specified when using groups with clusters. The following values are possible:
MQBND_BIND_ON_OPEN
Binding fixed by MQOPEN call.
MQBND_BIND_NOT_FIXED
Binding not fixed.
MQBND_BIND_ON_GROUP
Allows an application to request that a group of messages are all allocated to the same destination instance.
DefPersistence ( MQLONG ) - input
The default message persistence queue attribute defined on the queue manager that hosts the instance of the destination queue described by the MQWQR structure. The following values are possible:
MQPER_PERSISTENT
Message is persistent.
MQPER_NOT_PERSISTENT
Message is not persistent.
DefPriority ( MQLONG ) - input
The default message priority queue attribute defined on the queue manager that hosts the instance of the destination queue described by the MQWQR structure. The priority range is 0 - MaxPriority.
  • 0 is the lowest priority.
  • MaxPriority is the queue manager attribute of the queue manager that hosts this instance of the destination queue.
InhibitPut ( MQLONG ) - input
The put inhibited queue attribute defined on the queue manager that hosts the instance of the destination queue described by the MQWQR structure. The following values are possible:
MQQA_PUT_INHIBITED
Put operations are inhibited.
MQQA_PUT_ALLOWED
Put operations are allowed.
CLWLQueuePriority ( MQLONG ) - input
The cluster workload queue priority attribute defined on the queue manager that hosts the instance of the destination queue described by the MQWQR structure.
CLWLQueueRank ( MQLONG ) - input
The cluster workload queue rank defined on the queue manager that hosts the instance of the destination queue described by the MQWQR structure.
DefPutResponse ( MQLONG ) - input
The default put response queue attribute defined on the queue manager that hosts the instance of the destination queue described by the MQWQR structure. The following values are possible:
MQPRT_SYNC_RESPONSE
Synchronous response to MQPUT or MQPUT1 calls.
MQPRT_ASYNC_RESPONSE
Asynchronous response to MQPUT or MQPUT1 calls.