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.
You can combine the values by adding them together.
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
If you leave the field blank (four spaces) this defaults to the supplied transaction code, CKBP.
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.


fg15490_.html | Timestamp icon Last updated: Monday, 5 June 2017