Set the MQMD fields

 

Fields in the MQMD that can affect the operation of the CICS bridge need to be initialized in your application program:

MQMD.CorrelId

For MQPUTs 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 MQGETs from 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.

MQMD.Expiry

Set a message expiry time based on how long you want your application to wait for a reply. You are recommended to set a reasonable value for your enterprise. Set the MQCIH flags to propagate the remaining expiry time to the reply message.

MQMD.Format

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

MQMD.MsgId

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

For MQGETs from 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.

MQMD.ReplyToQ

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

The CICS bridge reply messages have the same persistence as the request messages. This means if you use persistent request messages, the reply-to queue cannot be a temporary dynamic queue or a shared queue on a non-recoverable structure.

MQMD.UserIdentifier

This field is only used 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.

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.

If you use this field with one of the VERIFY_* options, also initialize the MQCIH.Authenticator field. Set it to the value of the password or passticket associated with the user ID.

 

Parent topic:

Set fields in the MQMD and MQCIH structures (DPL)


fg15480_