MQZAD - Authority data

The MQZAD structure is used on the MQZ_ENUMERATE_AUTHORITY_DATA call for two parameters, one input and one output.

• MQZAD is used for the Filter parameter which is input to the call. This parameter specifies the selection criteria that are to be used to select the authority data returned by the call.
• MQZAD is also used for the AuthorityBuffer parameter which is output from the call. This parameter specifies the authorizations for one combination of profile name, object type, and entity.

Table 1. summarizes the fields in the structure.

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.

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

MQZAD_CURRENT_VERSION

Current version of authority data structure.

ProfileName

Type: MQCHAR48 - input

Profile name.

For the Filter parameter, this field is the profile name for which authority data is required. If the name is entirely blank up to the end of the field or the first null character, authority data for all profile names is returned.

For the AuthorityBuffer parameter, this field is the name of a profile that matches the specified selection criteria.

ObjectType

Type: MQLONG - input

Object type.

For the Filter parameter, this field is the object type for which authority data is required. If the value is MQOT_ALL, authority data for all object types is returned.

For the AuthorityBuffer parameter, this field is the object type to which the profile identified by the ProfileName parameter applies.

The value is one of the following; for the Filter parameter, the value MQOT_ALL is also valid:

MQOT_AUTH_INFO

Authentication information

MQOT_CHANNEL

Channel

MQOT_CLNTCONN_CHANNEL

Client connection channel

MQOT_LISTENER

Listener

MQOT_NAMELIST

Namelist

MQOT_PROCESS

Process definition

MQOT_Q

Queue

MQOT_Q_MGR

Queue manager

MQOT_SERVICE

Service

Authority

Type: MQLONG - input

Authority.

For the Filter parameter, this field is ignored.

For the AuthorityBuffer parameter, this field represents the authorizations that the entity has to the objects identified by ProfileName and ObjectType. If the entity has only one authority, the field is equal to the appropriate authorization value (MQZAO_* constant). If the entity has more than one authority, the field is the bitwise OR of the corresponding MQZAO_* constants.

EntityDataPtr

Type: PMQZED - input

Address of MQZED structure identifying an entity.

For the Filter parameter, this field points to an MQZED structure that identifies the entity for which authority data is required. If EntityDataPtr is the null pointer, authority data for all entities is returned.

For the AuthorityBuffer parameter, this field points to an MQZED structure that identifies the entity for which authority data has been returned.

EntityType

Type: MQLONG - input

Entity type.

For the Filter parameter, this field specifies the entity type for which authority data is required. If the value is MQZAET_NONE, authority data for all entity types is returned.

For the AuthorityBuffer parameter, this field specifies the type of the entity identified by the MQZED structure pointed to by the EntityDataPtr parameter.

The value is one of the following; for the Filter parameter, the value MQZAET_NONE is also valid:

MQZAET_PRINCIPAL

Principal

MQZAET_GROUP

Group

Options

Type: MQAUTHOPT - input Options. This field specifies options that give control over the profiles that are displayed. One of the following values must be specified:

MQAUTHOPT_NAME_ALL_MATCHING

Displays all profiles

MQAUTHOPT_NAME_EXPLICIT

Displays profiles that have exactly the same name as specified in the ProfileName field.

In addition, one of the following must also be specified:

MQAUTHOPT_ENTITY_SET

Display all profiles that are used to calculate the cumulative authority that the entity has to the object specified by the ProfileName parameter. The ProfileName parameter must not contain any wildcard characters.

If the specified entity is a principal, for each member of the set {entity, groups} the most applicable profile that applies to the object is displayed.

If the specified entity is a group, the most applicable profile from the group that applies to the object is displayed.

If this value is specified, the values of ProfileName, ObjectType, EntityType, and the entity name that is specified in the EntityDataPtr MQZED structure, must all be non-blank.

If we have specified MQAUTHOPT_NAME_ALL_MATCHING, we can also specify the following value:

MQAUTHOPT_ENTITY_EXPLICIT

Displays profiles that have exactly the same entity name as the entity name specified in the EntityDataPtr MQZED structure.

C declaration

typedef struct tagMQZAD MQZAD;
struct tagMQZAD {
  MQCHAR4   StrucId;        /* Structure identifier */
  MQLONG    Version;        /* Structure version number */
  MQCHAR48  ProfileName;    /* Profile name */
  MQLONG    ObjectType;     /* Object type */
  MQLONG    Authority;      /* Authority */
  PMQZED    EntityDataPtr;  /* Address of MQZED structure identifying an
                               entity */
  MQLONG    EntityType;     /* Entity type */
  MQAUTHOPT Options;        /* Options */
};