Home

 

Fields

 

StrucId (MQCHAR4)

Structure identifier.

The value is:

MQWDR_STRUC_ID

Identifier for cluster workload destination record.

For the C programming language, the constant MQWDR_STRUC_ID_ARRAY is also defined; this has the same value as MQWDR_STRUC_ID, but is an array of characters instead of a string.

This is an input field to the exit.

V(MQLONG)

Structure version number.

The value is:

MQWDR_VERSION_1

Version-1 cluster workload destination record.

MQWDR_VERSION_2

Version-2 cluster workload destination record.

The following constant specifies the version number of the current version:

MQWDR_CURRENT_VERSION

Current version of cluster workload destination record.

This is an input field to the exit.

StrucLength (MQLONG)

Length of MQWDR structure.

The value is:

MQWDR_LENGTH_1

Length of version-1 cluster workload destination record.

MQWDR_LENGTH_2

Length of version-2 cluster workload destination record.

The following constant specifies the length of the current version:

MQWDR_CURRENT_LENGTH

Length of current version of cluster workload destination record.

This is an input field to the exit.

QMgrFlags (MQLONG)

Queue-manager flags

These are bit flags that indicate various properties of the queue manager that hosts the instance of the destination queue described by this MQWDR structure. The following flags are defined:

MQQMF_REPOSITORY_Q_MGR

Destination is a full repository queue manager.

MQQMF_CLUSSDR_USER_DEFINED

Cluster sender channel was defined manually.

MQQMF_CLUSSDR_AUTO_DEFINED

Cluster sender channel was defined automatically.

MQQMF_AVAILABLE

Destination queue manager is available to receive messages.

Other flags in the field might be set by the queue manager for internal purposes.

This is an input field to the exit.

QMgrIdentifier (MQCHAR48)

Queue-manager identifier.

This is a string that acts as a unique identifier for the queue manager. It is generated by the queue manager.

The length of this field is given by MQ_Q_MGR_IDENTIFIER_LENGTH. This is an input field to the exit.

QMgrName (MQCHAR48)

Queue-manager name.

This is the name of the queue manager that hosts the instance of the destination queue described by this MQWDR structure. This can be the name of the local queue manager.

The length of this field is given by MQ_Q_MGR_NAME_LENGTH. This is an input field to the exit.

ClusterRecOffset (MQLONG)

Logical offset of first cluster record.

This is the logical offset of the first MQWCR structure that belongs to this MQWDR structure. For static caches, this is the offset of the first MQWCR structure that belongs to the MQWDR structure. The offset is measured in bytes from the start of the MQWDR structure. For dynamic caches, the logical offset CANNOT be used in pointer arithmetic. To obtain the address of the next record, the MQXCLWLN call must be used.

This is an input field to the exit.

ChannelState (MQLONG)

Channel state.

This indicates the state of the channel that links the local queue manager to the queue manager identified by this MQWDR structure. The following values are possible:

MQCHS_INACTIVE

Channel is not active.

MQCHS_BINDING

Channel is negotiating with the partner.

MQCHS_STARTING

Channel is waiting to become active.

MQCHS_RUNNING

Channel is transferring or waiting for messages.

MQCHS_STOPPING

Channel is stopping.

MQCHS_RETRYING

Channel is reattempting to establish connection.

MQCHS_STOPPED

Channel has stopped.

MQCHS_REQUESTING

Requester channel is requesting connection.

MQCHS_PAUSED

Channel has paused.

MQCHS_INITIALIZING

Channel is initializing.

This is an input field to the exit.

ChannelDefOffset (MQLONG)

Logical offset of channel definition structure.

This is the logical offset of the channel definition (MQCD) for the channel that links the local queue manager to the queue manager identified by this MQWDR structure (similar to ClusterRecOffset). The logical offset CANNOT be used in pointer arithmetic. To obtain the address of the next record, the MQXCLWLN call must be used.

This is an input field to the exit.

DestSeqFactor (MQINT64)

Destination sequence factor.

This is the destination sequence factor that allows a choice of the channel based on weight. This the value used before the Queue Manager changes it. The workload manager increases this value in a way that ensures messages are distributed down channels according to their weight.

This is an input field to the exit.

DestSeqNumber (MQLONG)

Cluster channel destination.

This value is the value before the queue manager changes. The WLM increases this value every time a message is put down that channel. Workload exits can use this value to decide which channel to put a message down.

This is an input field to the exit.

 

Parent topic:

MQWDR - Cluster workload destination-record structure

qc12770_

 

Home