MQCIH fields for DPL program request messages
When you send a request message to run a CICS® DPL program using the CICS-WebSphere MQ bridge, you must initialize these key input fields in your application program.
- MQCIH.Authenticator
- This field applies only if you are using an authorization level of VERIFY_UOW or VERIFY_ALL. Set the value to the password or PassTicket that is to be associated with the user ID in the MQMD.UserIdentifier field. Together, the values are used by the external security manager to determine whether the user is authorized to link to the DPL program. If you are using PassTickets, the applid used for generating the PassTicket must be the same as the PASSTKTA keyword values used when starting the bridge monitor.
- MQCIH.Flags
-
- Set to MQCIH_PASS_EXPIRATION to pass the remaining expiry time to the reply message.
- Set to MQCIH_REPLY_WITHOUT_NULLS to remove trailing null characters ('00'X) from the reply message.
- Set to MQCIH_SYNC_ON_RETURN to specify the SYNCONRETURN option on the EXEC CICS LINK command.
- MQCIH.Format
- Specifies the format of the data following the MQCIH structure. If the data is character data, use MQFMT_STRING ; if no conversion is needed, use MQFMT_NONE.
- MQCIH.GetWaitInterval
- If you allow this field to default, the bridge task GET WAIT interval for messages in a unit of work is the value specified on the WAIT parameter when the bridge monitor was started. If you also allow the WAIT parameter to default, the GET WAIT interval is unlimited.
- MQCIH.LinkType
- Specify MQCLT_PROGRAM if you are using the CICS DPL bridge.
- MQCIH.OutputDataLength
- This field applies only to the CICS DPL bridge and sets the length of data returned by the program. MQCIH.OutputDataLength is ignored for DPL requests that use the channel and container interface; for these requests the output (that is, the response) length is the size of the DFHRESPONSE container.
- MQCIH.RemoteSysId
- Leave this field blank unless you need the request to be processed by a specific CICS system.
- MQCIH.ReplyToFormat
- Set this to MQFMT_NONE (the default value) if your application and the bridge are running in the same CCSID and encoding environment. Otherwise, set the value to the format of the COMMAREA data returned. MQCIH.replytoformat is ignored for DPL requests that use the channel and container interface. For these requests the reply-to format is set based on the content of the DFHRESPONSE container; if the content is character data, then the reply-to format is MQFMT_STRING ; if the content is binary data then the reply-to format is MQFMT_NONE.
- MQCIH.TransactionId
- Specify the transaction code that you want to run the
CICS
DPL bridge program under.
You can specify one of the supplied transactions:
- CKBP, which runs program DFHMQBP0 using a COMMAREA
- CKBC, which runs program DFHMQBP3 using channels and containers
- Your own transaction code to run DFHMQBP0 or DFHMQBP3
- MQCIH.UOWControl
- This field controls the unit of work processing performed by the bridge. See MsgId, CorrelId, and UOWControl fields for DPL programs for more information.