MQCIH fields for 3270 transaction request messages

When you send a request message to run a 3270 transaction using the CICS-WebSphere MQ bridge, you must initialize these key input fields in your application program.

MQCIH.ADSDescriptor
This field applies to transactions that use BMS SEND MAP and RECEIVE MAP calls. In this case, and if the application that is sending CICS-WebSphere MQ bridge request messages is on a workstation, set this value to MQCADSD_SEND + MQCADSD_RECV + MQCADSD_MSGFORMAT. This setting ensures that the vectors in the request and reply messages are correctly converted between the different CCSID and encoding schemes of the workstation and the mainframe.
MQCIH.AttentionId
Set this field to a value representing the AID key expected by the transaction, if any; otherwise, accept the default value of four spaces, which appear to the CICS® transaction as the ENTER AID key.

The inbound RECEIVE, RECEIVE MAP, and CONVERSE vectors also have fields in which you can specify AID values. The value in the MQCIH is the value to which EIBAID is set when the application is started. It represents the function key used to start the transaction. The value in the inbound vector is the value used when the data is entered. For example, this would be the value of EIBAID after the EXEC CICS RECEIVE MAP instruction.

Note:
  1. For conversational transactions the initial MQCIH value and the value on the vector have separate values.
  2. If the non-CICS application is sending a message in response to a request vector, the value in the MQCIH is ignored.
  3. In the case of pseudoconversational transactions, enter the same value in the MQCIH and the first vector.
The first byte of this field is set to the value in the CICS copybook DFHAID.
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 start the 3270 transaction. If you are using a PassTicket, the applid used for generating the PassTicket must be the same as the PASSTKTA keyword values used when starting the bridge monitor.
MQCIH.ConversationalTask
Specify the value MQCCT_NO if all the input vectors needed for this CICS transaction are supplied in the input message. Specify MQCCT_YES if multiple messages can be used to supply input vectors for the transaction
MQCIH.Facility
Specify the value MQCFAC_NONE in the first message in a pseudoconversation, and also set the MQCIH.FacilityKeepTime field to a nonzero value. The CICS-WebSphere MQ bridge returns a facility token in the first message. You must use this value in all subsequent inbound messages in the pseudoconversation.
MQCIH.FacilityKeepTime
If you are sending more than a single message in a pseudoconversation, set this field to a nonzero value (in seconds) in the first message for the CICS-WebSphere MQ bridge to return a facility token. Successive transactions in a pseudoconversation must use the same facility token after it has been set in this way, ensuring that associated terminal areas, for example the TCTUA, are preserved for the period of the pseudoconversation.
MQCIH.FacilityLike
Either use the default value of four spaces, or specify the name of an installed terminal. You can find the names of installed terminals by entering the CICS command CEMT I TASK or CEMT I TERM at a CICS terminal.
MQCIH.Flags
Set the value to MQCIH_PASS_EXPIRATION to pass the remaining expiry time to the reply message.
MQCIH.Format
Set the value to DFHMQDCI (or CSCQBDCI). This value informs the CICS-WebSphere MQ bridge that any data following the MQCIH is inbound to the bridge and might need to be converted. The bridge sets the value of MQCIH.Format in the outbound message, which is returned to the reply queue to DFHMQDCO (or CSCQBDCO).
MQCIH.GetWaitInterval
If you allow this field 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 CICS-WebSphere MQ bridge monitor was started. If you also allow the WAIT parameter to default, the GET WAIT interval is unlimited.
MQCIH.LinkType
Specify MQCLT_TRANSACTION for 3270 transactions.
MQCIH.RemoteSysid
Set this field to blank on the first message of a pseudoconversation unless you require the request to be processed on a specific CICS system. In subsequent messages in the pseudoconversation, set this field to the value returned in the first reply message.
Note: In earlier versions of the CICS-WebSphere MQ bridge the RemoteSysId field was not used; however, it is important that it is now passed thorough the conversation to enable the use of the facility for multiple CICS-WebSphere MQ bridge monitors. The typical style of CICS programming is pseudoconversational; that is, a series of independent transactions that are linked together to form a complete application. When using the CICS-WebSphere MQ bridge, the link between the transactions of a pseudoconversation is maintained by passing the Facility token and RemoteSysId value returned by the first transaction of the sequence into subsequent messages of the conversation.
MQCIH.StartCode
When you start a 3270 transaction you must change the value of this field from the default value of MQCSC_NONE. The value you use depends on the nature of the transaction. Use a value of MQCSC_START if the transaction is started by an EXEC CICS START command without data, and it does not issue an EXEC CICS RETRIEVE command. Use a value of MQCSC_STARTDATA if the transaction is started by an EXEC CICS START command with data, and it issues an EXEC CICS RETRIEVE command. Otherwise, use a value of MQCSC_TERMINPUT.
MQCIH.TransactionId
This value is the transaction identifier of the 3270 transaction to be run by the bridge task. The first message must specify the first transaction to be started. Set this field in subsequent messages to the value of MQCIH.NextTransactionId that is returned in the preceding reply message.
MQCIH.UOWControl
This value controls the unit-of-work processing performed by the CICS-WebSphere MQ bridge. See also MsgId, CorrelId, and UOWControl fields for 3270 transactions.


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