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