Fields for MQCIH

The MQCIH structure contains the following fields; the fields are described in alphabetical order:

  • AbendCode (MQCHAR4)
    AbendCode is a response field. The length of this field is given by MQ_ABEND_CODE_LENGTH. The initial value of this field is 4 blank characters.
  • ADSDescriptor (MQLONG)
    This field is an indicator specifying whether to send ADS descriptors on SEND and RECEIVE BMS requests.
  • AttentionId (MQCHAR4)
    The value in this field determines the initial value of the AID key when the transaction is started. It is a 1 byte value, left-aligned.
  • Authenticator (MQCHAR8)
    The value of this field is the password or passticket.
  • CancelCode (MQCHAR4)
    The value in this field is the abend code to be used to terminate the transaction (normally a conversational transaction that is requesting more data). Otherwise this field is set to blanks.
  • CodedCharSetId (MQLONG)
    CodedCharSetId is a reserved field; its value is not significant. The initial value of this field is 0.
  • CompCode (MQLONG)
    This field is a response field. Its initial value is MQCC_OK
  • ConversationalTask (MQLONG)
    This field is an indicator specifying whether to allow the task to issue requests for more information, or to stop the task and issue an abend message.
  • CursorPosition (MQLONG)
    The value in this field shows the initial cursor position when the transaction is started. For conversational transactions, the cursor position is in the RECEIVE vector.
  • Encoding (MQLONG)
    This field is a reserved field; its value is not significant. Its initial value is 0.
  • ErrorOffset (MQLONG)
    The ErrorOffset field shows the position of invalid data detected by the bridge exit. This field provides the offset from the start of the message to the location of the invalid data.
  • Facility (MQBYTE8)
    This field shows the 8-byte bridge facility token.
  • FacilityKeepTime (MQLONG)
    FacilityKeepTime is the length of time in seconds that the bridge facility is kept after the user transaction ends.
  • FacilityLike (MQCHAR4)
    FacilityLike is the name of an installed terminal that is to be used as a model for the bridge facility.
  • Flags (MQLONG)
    This field is a request field. The initial value of this field is MQCIH_NONE.
  • Format (MQCHAR8)
    This field shows the IBM MQ format name of the data that follows the MQCIH structure.
  • Function (MQCHAR4)
    This field is a response field. The length of this field is given by MQ_FUNCTION_LENGTH. The initial value of this field is MQCFUNC_NONE.
  • GetWaitInterval (MQLONG)
    This field is a request field. Its initial value is MQCGWI_DEFAULT.
  • InputItem (MQLONG)
    This field is a reserved field. The value must be 0.
  • LinkType (MQLONG)
    This field is a request field. Its initial value is MQCLT_PROGRAM.
  • NextTransactionId (MQCHAR4)
    This value is the name of the next transaction returned by the user transaction (usually by EXEC CICS RETURN TRANSID). If there is no next transaction, this field is set to blanks.
  • OutputDataLength (MQLONG)
    This field is a request field used only for DPL programs. Its initial value is MQCODL_AS_INPUT.
  • Reason (MQLONG)
    This field is a response field. Its initial value is MQRC_NONE.
  • RemoteSysId (MQCHAR4)
    This field shows the CICS system identifier of the CICS system processing the request.
  • RemoteTransId (MQCHAR4)
    This field is an optional Request field. The length of this field is given by MQ_TRANSACTION_ID_LENGTH.
  • ReplyToFormat (MQCHAR8)
    The value of this field is the IBM MQ format name of the reply message that is sent in response to the current message.
  • Reserved1 (MQCHAR8)
    This field is a reserved field. The value must be 8 blanks.
  • Reserved2 (MQCHAR8)
    This field is a reserved field. The value must be 8 blanks.
  • Reserved3 (MQCHAR8)
    This field is a reserved field. The value must be 8 blanks.
  • Reserved4 (MQLONG)
    This field is a reserved field. The value must be 0.
  • ReturnCode (MQLONG)
    The value of this field is the return code from the CICS bridge describing the outcome of the processing performed by the bridge. This field is a response field, with an initial value of MQCRC_OK.
  • StartCode (MQCHAR4)
    The value of this field is an indicator specifying whether the bridge emulates a terminal transaction or a transaction initiated with START.
  • StrucId (MQCHAR4)
    This field is a request field, with an initial value of MQCIH_STRUC_ID.
  • StrucLength (MQLONG)
    This field is a request field, with an initial value of MQCIH_LENGTH_2.
  • TaskEndStatus (MQLONG)
    This field is a response field, showing the status of the user transaction at end of task. The field is used only for 3270 transactions, and its initial value is MQCTES_NOSYNC.
  • TransactionId (MQCHAR4)
    This field is a request field. Its length is given by MQ_TRANSACTION_ID_LENGTH. The initial value of this field is four blanks.
  • UOWControl (MQLONG)
    This field is a request field which controls the unit-of-work processing performed by the CICS bridge. The initial value of this field is MQCUOWC_ONLY.
  • Version (MQLONG)
    This field is a request field. Its initial value is MQCIH_VERSION_2.

Parent topic: MQCIH - CICS bridge header