Set the MQCIH fields

 

The MQCIH contains both input and output fields; see the Application Programming Reference for full details of this structure. The key input fields that we need to initialize in your application program when you use the CICS DPL bridge are as follows:

MQCIH.Authenticator

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

We 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 to default, the bridge task GET WAIT interval for messages within 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 DPL bridge.

MQCIH.OutputDataLength

This field applies only to the DPL bridge and sets the length of data returned by the program.

MQCIH.RemoteSysId

Leave this field blank unless we need the request 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.TransactionId

Use the default value (four spaces) unless you want the bridge to run the DPL program under a transaction code other than the default value of CKBP.

MQCIH.UOWControl

This controls the unit of work processing performed by the bridge. Allowed values are described in the Application Programming Reference. See also Managing MsgId and CorrelId in a unit of work (DPL).

 

Parent topic:

Set fields in the MQMD and MQCIH structures (DPL)

fg15490_