MQZAC - Application context

The MQZAC structure is used on the MQZ_AUTHENTICATE_USER call for the ApplicationContext parameter. This parameter specifies data related to the calling application.

Table 1 summarizes the fields in the structure.

Field Description
StrucId Structure identifier
Version Structure version number
ProcessId Process identifier
ThreadId Thread identifier
ApplName Application name
UserID User identifier
EffectiveUserID Effective user identifier
Environment Environment
CallerType Caller type
AuthenticationType Authentication type
BindType Bind type


Fields

    StrucId
    Type: MQCHAR4 - input Structure identifier. The value is as follows:

      MQZAC_STRUC_ID
      Identifier for application context structure.

      For the C programming language, the constant MQZAC_STRUC_ID_ARRAY is also defined; this has the same value as MQZAC_STRUC_ID, but is an array of characters instead of a string.

    Version
    Type: MQLONG - input Structure version number. The value is as follows:

      MQZAC_VERSION_1
      Version-1 application context structure. The constant MQZAC_CURRENT_VERSION specifies the version number of the current version.

    ProcessId
    Type: MQPID - input

    Process identifier of the application.

    ThreadId
    Type: MQTID - input

    Thread identifier of the application.

    ApplName
    Type: MQCHAR28 - input

    Application name.

    UserID
    Type: MQCHAR12 - input

    User identifier. On UNIX this field specifies the application's real user ID. On Windows this field specifies the application's user ID.

    EffectiveUserID
    Type: MQCHAR12 - input

    Effective user identifier. On UNIX this field specifies the application's effective user ID. On Windows this field is blank.

    Environment
    Type: MQLONG - input Environment. This field specifies the environment from which the call was made. The field is one of the following values:

      MQXE_COMMAND_SERVER
      Command server

      MQXE_MQSC
      runmqsc command interpreter

      MQXE_MCA
      Message channel agent MQXE_OTHER

      MQXE_OTHER
      Undefined environment

    CallerType
    Type: MQLONG - input Caller Type. This field specifies the type of program that made the call. The field is one of the following values:

      MQXACT_EXTERNAL
      The call is external to the queue manager.

      MQXACT_INTERNAL
      The call is internal to the queue manager.

    AuthenticationType
    Type: MQLONG - input Authentication Type. This field specifies the type of authentication being performed. The field is one of the following values:

      MQZAT_INITIAL_CONTEXT
      The authentication call is due to user context being initialized. This value is used during an MQCONN or MQCONNX call.

      MQZAT_CHANGE_CONTEXT
      The authentication call is due to the user context being changed. This value is used when the MCA changes the user context. Parent topic: MQZAC -

    BindType
    Type: MQLONG - input Bind Type. This field specifies the type of binding in use. The field is one of the following values:

      MQCNO_FASTPATH_BINDING
      Fastpath binding.

      MQCNO_SHARED_BINDING
      Shared binding.

      MQCNO_ISOLATED_BINDING
      Isolated binding.


C declaration

Declare the fields of the structure as follows: 
typedef struct tagMQZAC MQZAC;
struct tagMQZAC {
  MQCHAR4   StrucId;            /* Structure identifier */
  MQLONG    Version;            /* Structure version number */
  MQPID     ProcessId;          /* Process identifier */
  MQTID     ThreadId;           /* Thread identifier */
  MQCHAR28  ApplName;           /* Application name */
  MQCHAR12  UserID;             /* User identifier */
  MQCHAR12  EffectiveUserID;    /* Effective user identifier */
  MQLONG    Environment;        /* Environment */
  MQLONG    CallerType;         /* Caller type */
  MQLONG    AuthenticationType; /* Authentication type */
  MQLONG    BindType;           /* Bind type */
};
Parent topic: Installable services interface reference information