Fields for MQCNO

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

• ApplName (MQCHAR28)
  The name set by the application to identify the connection to the queue manager. The initial value of the field is MQAN_NONE_ARRAY (blank characters).
• CCDTUrlLength (MQLONG)
  CCDTUrlLength is the length of the string identified by either CCDTUrlPtr or CCDTUrlOffset which contains a URL that identifies the location of the client connection channel table to use for the connection. The initial value of the field is zero.
• CCDTUrlOffset (MQLONG)
  CCDTUrlOffset is the offset in bytes, from the start of the MQCNO structure, to a string which contains a URL that identifies the location of the client connection channel table to use for the connection. The offset can be positive or negative and the initial value of the field is zero.
• CCDTUrlPtr (PMQCHAR)
  CCDTUrlPtr is an optional pointer to a string which contains a URL, to identify the location of the client connection channel table to use for the connection.. This field is an input field, with an initial value of a null pointer in programming languages that support pointers, and an all-null byte string otherwise.
• ClientConnOffset (MQLONG)
  ClientConnOffset is the offset in bytes of an MQCD channel definition structure from the start of the MQCNO structure. The offset can be positive or negative. This field is an input field with an initial value of 0.
• ClientConnPtr (MQPTR)
  ClientConnPtr is an input field. Its initial value is the null pointer in those programming languages that support pointers, and an all-null byte string otherwise.
• ConnectionId (MQBYTE24)
  ConnectionId is a unique 24-byte identifier that allows IBM MQ to reliably identify an application. An application can use this identifier for correlation in PUT and GET calls. This output parameter has an initial value of 24 null bytes in all programming languages.
• ConnTag (MQBYTE128) on Multiplatforms
  A connection tag is conceptually similar to a connection identifier, but might span multiple related connections, identifying them as a single application instance. On Multiplatforms, the connection tag is generated by the queue manager at connection time.
• ConnTag (MQBYTE128) on IBM MQ for z/OS
  . A connection tag is conceptually similar to a connection identifier, but might span multiple related connections, identifying them as a single application instance. On IBM MQ for z/OS, the connection tag is an input field, provided by the application and used in conjunction with MQCNO_*_CONN_TAG options to serialize connections from that application instance
• Options (MQLONG)
  Options that control the action of MQCONNX.
• Reserved (MQBYTE4)
  A reserved field to pad the structure out to a 64-bit boundary. The initial value of the field is binary zero for the length of the field.
• Reserved2 (MQBYTE4)
  A reserved field to pad the structure out to a 64-bit boundary. The initial value of the field is binary zero for the length of the field.
• SecurityParmsOffset (MQLONG)
  SecurityParmsOffset is the offset in bytes of the MQCSP structure from the start of the MQCNO structure. The offset can be positive or negative. This field is an input field, with an initial value of 0.
• SecurityParmsPtr (PMQCSP)
  SecurityParmsPtr is the address of the MQCSP structure, used to specify a user ID and password for authentication by the authorization service. This field is an input field, and its initial value is a null pointer or null bytes.
• SSLConfigOffset (MQLONG)
  SSLConfigOffset is the offset in bytes of an MQSCO structure from the start of the MQCNO structure. The offset can be positive or negative. This field is an input field, with an initial value of 0.
• SSLConfigPtr (PMQSCO)
  SSLConfigPtr is an input field. Its initial value is the null pointer in those programming languages that support pointers, and an all-null byte string otherwise.
• StrucId (MQCHAR4)
  StrucId is always an input field. Its initial value is MQCNO_STRUC_ID.
• Version (MQLONG)
  Version is always an input field. Its initial value is MQCNO_VERSION_1.

Parent topic: MQCNO - Connect options