MQZAC (Application context) on IBM i

This parameter specifies data related to the calling application.

The MQZAC structure is used on the MQZ_AUTHENTICATE_USER call for the ApplicationContext parameter.

Fields

StrucId (MQCHAR4)

Structure identifier. The value is:

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.

This is an input field to the service.

Version (MQLONG

Structure version number. The value is:

MQZAC_VERSION_1

Version-1 application context structure.

The following constant specifies the version number of the current version:

MQZAC_CURRENT_VERSION

Current version of application context structure.

This is an input field to the service.

ProcessId (MQPID)

Process identifier.

The process identifier of the application.

ThreadId (MQTID)

Thread identifier.

The thread identifier of the application.

ApplName (MQCHAR28)

Application name.

The application name.

UserID (MQCHAR12)

User identifier.

For IBM i systems the user profile that the application job was created under. (On IBM i, when a profile swap is done with the QWTSETP API in the application job, the current user profile is returned).

EffectiveUserID (MQCHAR12)

Effective user identifier.

For IBM i systems the application job's current user profile.

Environment (MQLONG)

Environment.

This field specifies the environment from which the call was made.

This can have one of the following values:

MQXE_COMMAND_SERVER

Command server.

MQXE_MQSC

runmqsc command interpreter.

MQXE_MCA

Message channel agent

MQXE_OTHER

Undefined environment

CallerType (MQLONG)

Caller Type.

This field specifies the type of program that made the call.

This can have 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 (MQLONG)

Authentication Type.

This field specifies the type of authentication being performed.

This can have 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.

v

BindType (MQLONG

Bind Type.

This field specifies the type of binding in use.

This can have one of the following values:

MQCNO_FASTPATH_BINDING

Fastpath binding.

MQCNO_SHARED_BINDING

Shared binding.

MQCNO_ISOLATED_BINDING

Isolated binding.

C declaration

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 */
};