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.

Parent topic: MQWQR - Cluster workload queue record structure


Related reference