detailed description, StrucId field, MQZAC_* values, Vfield, ProcessId field, ThreadID field, ApplName field, UserID field, EffectiveUserID field, Environment field, CallerType field, AuthenticationType field, BindType field" /> MQZAC - Application context

 

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.

 

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.

V(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 UNIX systems the application's real user ID. For Windows the application's user ID. For OS/400 systems the user profile that the application job was created under. (OS/400: 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 UNIX systems the application's effective user ID. For Windows this field is all blank. For OS/400 systems the application job's current user profile.

Environment (MQLONG)

Environment.

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

The value is one of the following:

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.

The value is one of the following:

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.

The value is one of the following:

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.
BindType (MQLONG)

Bind Type.

This field specifies the type of binding in use.

The value is one of the following:

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