msgDescriptorRecord

The msgDescriptorRecord property identifies a record variable that you can use to pass fields that define the characteristics of the message to the WebSphere® MQ system.

The record variable that the property identifies is based on a BasicRecord.

EGL programs call the WebSphere MQ MQGET and MQPUT functions to implement add and get next statements for message queue records. The WebSphere MQ Message Descriptor structure (MQMD) is a parameter on MQGET and MQPUT calls.

If you do not specify the msgDescriptorRecord property, EGL automatically builds a default MQMD structure. EGL sets all the MQMD fields to their initial default values.

Table 1. Structure of the WebSphere MQ Message Descriptor (MQMD)
Field Type Description
STRUCID CHAR(4) Structure identifier
VERSION INT Structure version number
REPORT INT Report options
MSGTYPE INT Message type
EXPIRY INT Expiration time
FEEDBACK INT Feedback or reason code
ENCODING INT Data encoding
CODECHARSETID INT Coded character set ID
FORMAT CHAR(8) Format name
PRIORITY INT Message priority
PERSISTENCE INT Message persistence
MSGID HEX(48) Message ID
CORRELID HEX(48) Correlation ID
BACKOUTCOUNT INT Backout counter
REPLYTOQ CHAR(48) Name of reply-to queue
REPLYTOQMGR CHAR(48) Name of reply-to queue manager
USERIDENTIFIER CHAR(12) User ID

You can use the queueDescriptorRecord property to specify MQMD or your own variable based on MQMD. Code the program to initialize and set fields in the MQMD record variable before accessing the queue. EGL uses your MQMD structure instead of the default structure.

For more information about options records, see Options records for MQRecords. For a complete list of WebSphere MQ constants (such as MQOT_Q), see your WebSphere MQ documentation.


Feedback