Class MQCIH

java.lang.Object
com.ibm.mq.jmqi.JmqiObject
com.ibm.mq.headers.internal.Header
com.ibm.mq.headers.MQCIH
All Implemented Interfaces:
MQChainable, MQData, MQHeader

public class MQCIH extends com.ibm.mq.headers.internal.Header implements MQChainable
MQCIH (CICS bridge header) header class.
    struct tagMQCIH {
                MQCHAR4  StrucId;             // Structure identifier
                MQLONG   Version;             // Structure version number
                MQLONG   StrucLength;         // Length of MQCIH structure
                MQLONG   Encoding;            // Reserved
                MQLONG   CodedCharSetId;      // Reserved
                MQCHAR8  Format;              // MQ format name of data that follows MQCIH
                MQLONG   Flags;               // Flags
                MQLONG   ReturnCode;          // Return code from bridge
                MQLONG   CompCode;            // MQ completion code or CICS EIBRESP
        MQLONG   Reason;              // MQ reason or feedback code, or CICS EIBRESP2
        MQLONG   UOWControl;          // Unit-of-work control
        MQLONG   GetWaitInterval;     // Wait interval for MQGET call issued by bridge task
        MQLONG   LinkType;            // Link type
        MQLONG   OutputDataLength;    // Output COMMAREA data length
        MQLONG   FacilityKeepTime;    // Bridge facility release time
        MQLONG   ADSDescriptor;       // Send/receive ADS descriptor
        MQLONG   ConversationalTask;  // Whether task can be conversational
        MQLONG   TaskEndStatus;       // Status at end of task
        MQBYTE8  Facility;            // Bridge facility token
        MQCHAR4  Function;            // MQ call name or CICS EIBFN function
        MQCHAR4  AbendCode;           // Abend code
        MQCHAR8  Authenticator;       // Password or passticket
        MQCHAR8  Reserved1;           // Reserved
        MQCHAR8  ReplyToFormat;       // MQ format name of reply message
        MQCHAR4  RemoteSysId;         // Remote CICS system id to use
        MQCHAR4  RemoteTransId;       // CICS RTRANSID to use
        MQCHAR4  TransactionId;       // Transaction to attach
        MQCHAR4  FacilityLike;        // Terminal emulated attributes
        MQCHAR4  AttentionId;         // AID key
        MQCHAR4  StartCode;           // Transaction start code
        MQCHAR4  CancelCode;          // Abend transaction code
        MQCHAR4  NextTransactionId;   // Next transaction to attach
        MQCHAR8  Reserved2;           // Reserved
        MQCHAR8  Reserved3;           // Reserved
        // Ver:1
        MQLONG   CursorPosition;      // Cursor position
                MQLONG   ErrorOffset;         // Offset of error in message
                MQLONG   InputItem;           // Reserved
                MQLONG   Reserved4;           // Reserved
                // Ver:2
   };
 
  • Constructor Details

    • MQCIH

      public MQCIH()
      Constructs an MQCIH instance with default field values.
    • MQCIH

      public MQCIH(DataInput message) throws MQDataException, IOException
      Constructs an MQCIH instance populated from an MQMessage.
      Parameters:
      message - the message to read
      Throws:
      MQDataException - if the message content does not yield a valid MQCIH stucture
      IOException - if there is a problem reading the message content
    • MQCIH

      public MQCIH(DataInput message, int encoding, int characterSet) throws MQDataException, IOException
      Constructs an MQCIH instance populated from a DataInput source.
      Parameters:
      message - the MQMessage or other DataInput source to read
      encoding - the initial numeric encoding of the data in the message
      characterSet - the initial CCSID of the data in the message
      Throws:
      MQDataException - if the message content does not yield a valid MQCIH stucture
      IOException - if there is a problem reading the message content
  • Method Details

    • getStrucId

      public String getStrucId()
      Get the structure identifier; the value will be MQCIH_STRUC_ID
      Returns:
      the structure identifier
    • getVersion

      public int getVersion()
      Get the Structure version number
      Returns:
      the Structure version number
    • setVersion

      public void setVersion(int value)
      Set the Structure version number
      Parameters:
      value - the Structure version number
    • getStrucLength

      public int getStrucLength()
      Get the length of the structure.
      Returns:
      the structure length.
    • getEncoding

      public int getEncoding()
      Get the numeric encoding of the data that follows.
      Returns:
      the numeric encoding. A combination of MQENC_* values.
    • setEncoding

      public void setEncoding(int value)
      Set the numeric encoding of the data that follows.
      Parameters:
      value - the numeric encoding. A combination of MQENC_* values.
    • getCodedCharSetId

      public int getCodedCharSetId()
      Get the Character set identifier of data that follows.
      Returns:
      the Character set identifier.
    • setCodedCharSetId

      public void setCodedCharSetId(int value)
      Set the Character set identifier of data that follows.
      Parameters:
      value - the Character set identifier.
    • getFormat

      public String getFormat()
      get the MQ format name of data that follows MQCIH
      Returns:
      MQ format name
    • setFormat

      public void setFormat(String value)
      set the MQ format name of data that follows MQCIH
      Parameters:
      value - the MQ format name
    • getFlags

      public int getFlags()
      get the Flags
      Returns:
      the Flags
    • setFlags

      public void setFlags(int value)
      set the Flags
      Parameters:
      value - the Flags value to set
    • getReturnCode

      public int getReturnCode()
      get the return code
      Returns:
      the return code
    • setReturnCode

      public void setReturnCode(int value)
      set the return code
      Parameters:
      value - the return code
    • getCompCode

      public int getCompCode()
      get the completion code
      Returns:
      the completion code
    • setCompCode

      public void setCompCode(int value)
      set the completion code
      Parameters:
      value - the completion code
    • getReason

      public int getReason()
      get the reason code
      Returns:
      the reason code
    • setReason

      public void setReason(int value)
      set the reason code
      Parameters:
      value - the reason code
    • getUOWControl

      public int getUOWControl()
      get the Unit-of-work control value
      Returns:
      the Unit-of-work control value
    • setUOWControl

      public void setUOWControl(int value)
      set the Unit-of-work control value
      Parameters:
      value - the Unit-of-work control value
    • getGetWaitInterval

      public int getGetWaitInterval()
      get the wait interval
      Returns:
      the wait interval
    • setGetWaitInterval

      public void setGetWaitInterval(int value)
      set the wait interval
      Parameters:
      value - the wait interval
    • getLinkType

      public int getLinkType()
      get the link type
      Returns:
      link type
    • setLinkType

      public void setLinkType(int value)
      set the link type
      Parameters:
      value - the link type
    • getOutputDataLength

      public int getOutputDataLength()
      get the Output COMMAREA data length
      Returns:
      the Output COMMAREA data length
    • setOutputDataLength

      public void setOutputDataLength(int value)
      set the Output COMMAREA data length
      Parameters:
      value - the Output COMMAREA data length
    • getFacilityKeepTime

      public int getFacilityKeepTime()
      get the Bridge facility release time
      Returns:
      the Bridge facility release time
    • setFacilityKeepTime

      public void setFacilityKeepTime(int value)
      set the Bridge facility release time
      Parameters:
      value - the Bridge facility release time
    • getADSDescriptor

      public int getADSDescriptor()
      get the Send/receive ADS descriptor
      Returns:
      the Send/receive ADS descriptor
    • setADSDescriptor

      public void setADSDescriptor(int value)
      set the Send/receive ADS descriptor
      Parameters:
      value - the Send/receive ADS descriptor
    • getConversationalTask

      public int getConversationalTask()
      get the indication whether task can be conversational
      Returns:
      the indication whether task can be conversational
    • setConversationalTask

      public void setConversationalTask(int value)
      set the indication whether task can be conversational
      Parameters:
      value - the indication whether task can be conversational
    • getTaskEndStatus

      public int getTaskEndStatus()
      get the status at end of task
      Returns:
      the status at end of task
    • setTaskEndStatus

      public void setTaskEndStatus(int value)
      set the status at end of task
      Parameters:
      value - the status at end of task
    • getFacility

      public byte[] getFacility()
      get the Bridge facility token
      Returns:
      the Bridge facility token
    • setFacility

      public void setFacility(byte[] value)
      set the Bridge facility token
      Parameters:
      value - the Bridge facility token
    • getFunction

      public String getFunction()
      get the MQ call name or CICS EIBFN function
      Returns:
      the MQ call name or CICS EIBFN function
    • setFunction

      public void setFunction(String value)
      set the MQ call name or CICS EIBFN function
      Parameters:
      value - the MQ call name or CICS EIBFN function
    • getAbendCode

      public String getAbendCode()
      get the Abend code
      Returns:
      the Abend code
    • setAbendCode

      public void setAbendCode(String value)
      set the Abend code
      Parameters:
      value - the Abend code
    • getAuthenticator

      public String getAuthenticator()
      get the Password or passticket
      Returns:
      the Password or passticket
    • setAuthenticator

      public void setAuthenticator(String value)
      set the Password or passticket
      Parameters:
      value - the Password or passticket
    • getReplyToFormat

      public String getReplyToFormat()
      set the MQ format name of reply message
      Returns:
      the MQ format name of reply message
    • setReplyToFormat

      public void setReplyToFormat(String value)
      set the MQ format name of reply message
      Parameters:
      value - the MQ format name of reply message
    • getRemoteSysId

      public String getRemoteSysId()
      get the Remote CICS system id to use
      Returns:
      the Remote CICS system id to use
    • setRemoteSysId

      public void setRemoteSysId(String value)
      set the Remote CICS system id to use
      Parameters:
      value - the Remote CICS system id to use
    • getRemoteTransId

      public String getRemoteTransId()
      get the CICS RTRANSID to use
      Returns:
      the CICS RTRANSID to use
    • setRemoteTransId

      public void setRemoteTransId(String value)
      set the CICS RTRANSID to use
      Parameters:
      value - the CICS RTRANSID to use
    • getTransactionId

      public String getTransactionId()
      get the Transaction to attach
      Returns:
      the Transaction to attach
    • setTransactionId

      public void setTransactionId(String value)
      set the Transaction to attach
      Parameters:
      value - the Transaction to attach
    • getFacilityLike

      public String getFacilityLike()
      get the Terminal emulated attributes
      Returns:
      the Terminal emulated attributes
    • setFacilityLike

      public void setFacilityLike(String value)
      set the Terminal emulated attributes
      Parameters:
      value - the Terminal emulated attributes
    • getAttentionId

      public String getAttentionId()
      get the AID key
      Returns:
      the AID key
    • setAttentionId

      public void setAttentionId(String value)
      set the AID key
      Parameters:
      value - the AID key
    • getStartCode

      public String getStartCode()
      get the Transaction start code
      Returns:
      the Transaction start code
    • setStartCode

      public void setStartCode(String value)
      set the Transaction start code
      Parameters:
      value - the Transaction start code
    • getCancelCode

      public String getCancelCode()
      get the Abend transaction code
      Returns:
      the Abend transaction code
    • setCancelCode

      public void setCancelCode(String value)
      set the Abend transaction code
      Parameters:
      value - the Abend transaction code
    • getNextTransactionId

      public String getNextTransactionId()
      get the Next transaction to attach
      Returns:
      the Next transaction to attach
    • setNextTransactionId

      public void setNextTransactionId(String value)
      set the Next transaction to attach
      Parameters:
      value - the Next transaction to attach
    • getCursorPosition

      public int getCursorPosition()
      get the Cursor position
      Returns:
      the Cursor position
    • setCursorPosition

      public void setCursorPosition(int value)
      set the Cursor position
      Parameters:
      value - the Cursor position
    • getErrorOffset

      public int getErrorOffset()
      get the Offset of error in message
      Returns:
      the Offset of error in message
    • setErrorOffset

      public void setErrorOffset(int value)
      set the Offset of error in message
      Parameters:
      value - the error offset
    • getInputItem

      public int getInputItem()
      get the value of the InputItem field
      Returns:
      the value of the InputItem field
    • setInputItem

      public void setInputItem(int value)
      set the value of the InputItem field
      Parameters:
      value - the value of the InputItem field
    • nextEncoding

      public int nextEncoding()
      Specified by:
      nextEncoding in interface MQChainable
      Returns:
      the numeric encoding of the next header or message content.
      See Also:
    • nextEncoding

      public void nextEncoding(int value)
      Description copied from interface: MQChainable
      Sets the numeric encoding of the next header or message content.
      Specified by:
      nextEncoding in interface MQChainable
      Parameters:
      value - numeric encoding
      See Also:
    • nextCharacterSet

      public int nextCharacterSet()
      Specified by:
      nextCharacterSet in interface MQChainable
      Returns:
      the CCSID of the next header or message content.
      See Also:
    • nextCharacterSet

      public void nextCharacterSet(int value)
      Description copied from interface: MQChainable
      Sets the CCSID of the next header or message content.
      Specified by:
      nextCharacterSet in interface MQChainable
      Parameters:
      value - character set
      See Also:
    • nextFormat

      public String nextFormat()
      Specified by:
      nextFormat in interface MQChainable
      Returns:
      the format of the next header or message content.
      See Also:
    • nextFormat

      public void nextFormat(String value)
      Description copied from interface: MQChainable
      Sets the format of the next header or message content.
      Specified by:
      nextFormat in interface MQChainable
      Parameters:
      value - format of the header or message content
      See Also:
    • format

      public String format()
      Specified by:
      format in interface MQChainable
      Returns:
      the format associated with this header object or message content.
      See Also: