MQMD fields for CICS-WebSphere MQ bridge messages

Fields in the MQMD that can affect the operation of the CICS-WebSphere MQ bridge must be initialized in your application program.

MQMD.CorrelId

For MQPUT commands to the request queue, set the value to MQCI_NEW_SESSION in the first or only message in a unit of work. On subsequent messages in the unit of work, set the value to the MQMD.MsgId that WebSphere® MQ set in your message descriptor when you put your first message to the request queue.

For MQGET commands to the reply queue, use the value of MQMD.MsgId that WebSphere MQ set in your message descriptor when you put your most recent message to the request queue, or specify MQCI_NONE. See also MsgId, CorrelId, and UOWControl fields for DPL programs and MsgId, CorrelId, and UOWControl fields for 3270 transactions.

MQMD.Expiry

Set a message expiry time based on how long you want your application to wait for a reply. Set the MQCIH flags to propagate the remaining expiry time to the reply message.

MQMD.Format

For DPL programs, set the value to MQCICS if you include an MQCIH in the message that you send to the bridge request queue; otherwise, set it to the format of the data following.

For 3270 transactions, the value must be MQFMT_CICS.

MQMD.MsgId

For MQPUT commands to the request queue, set MsgId to a unique value for the unit of work or to MQMI_NONE.

For MQGET commands to the reply queue, use the value of MQMD.MsgId that WebSphere MQ set in your message descriptor when you put your first message to the request queue. See also MsgId, CorrelId, and UOWControl fields for DPL programs and MsgId, CorrelId, and UOWControl fields for 3270 transactions

MQMD.Persistence

Messages put to the request queue can be persistent or nonpersistent. Reply messages have the same persistence as the request messages.

MQMD.ReplyToQ

Set the value to the name of the queue where you want the bridge to send reply messages.

MQMD.UserIdentifier

This field is used only when the bridge monitor is running with authorization levels of IDENTIFY, VERIFY_UOW, or VERIFY_ALL. If you use any of these, set the value to the user ID that is checked for access to the CICS® DPL program. If you use this field with one of the VERIFY_* options, you must also initialize the MQCIH.Authenticator field. Set it to the value of the password or PassTicket associated with the user ID.

Note: When you use an authorization level of IDENTIFY, VERIFY_UOW, or VERIFY_ALL, you must add the value MQOO_SET_IDENTITY_CONTEXT to the open options when you open the bridge request queue, and also add the value MQPMO_SET_IDENTITY_CONTEXT to the put message options when you send a message to the queue.