The record variable that the property identifies is based on a BasicRecord. You need this record when opening or closing a queue.
EGL programs call the WebSphere MQ MQOPEN and MQCLOSE functions to open and close queues that are associated with message queue records. The WebSphere MQ Object Descriptor structure (MQOD) is a parameter on MQOPEN and MQCLOSE calls.
If you do not specify the queueDescriptorRecord property, EGL automatically builds a default MQOD structure. EGL sets all fields to initial values, except for the object type, queue manager name and queue name. EGL sets the object type to MQOT_Q for the queue. EGL sets the queue manager name and queue name to the current values specified in the recordName.resourceAssociation variable. If the queue manager name is not specified in recordName.resourceAssociation, then a value for OBJECTQMGRNAME is not specified. OBJECTQMGRNAME and OBJECTNAME values are critical when you want to change queue managers before you put or get messages.
| Field | Type | Description |
|---|---|---|
| STRUCID | CHAR(4) | Structure identifier |
| VERSION | INT | Structure version number |
| OBJECTTYPE | INT | Object type |
| OBJECTNAME | CHAR(48) | Object name |
| OBJECTQMGRNAME | CHAR(48) | Object queue manager name |
| DYNAMICQNAME | CHAR(48) | Dynamic queue name |
| ALTERNATEUSERID | CHAR(12) | Alternate user ID |
| RECSPRESENT | INT | Number of object records present |
| KNOWNDESTCOUNT | INT | Number of local queues opened |
| UNKNOWNDESTCOUNT | INT | Number of remote queues opened |
| INVALIDDESTCOUNT | INT | Number of queues that failed to open |
| OBJECTRECOFFSET | INT | Offset of the first object record in the MQOD |
| RESPONSERECOFFSET | INT | Offset of the first response record in the MQOD |
| OBJECTRECPTR | INT | Address of the first object record in the MQOD |
| RESPONSERECPTR | INT | Address of the first response record in the MQOD |
You can use the queueDescriptorRecord property to specify MQOD or your own variable based on MQOD. Code the program to initialize and set fields in the MQOD record variable before accessing the queue. EGL uses your MQOD 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), refer to your WebSphere MQ documentation.