MQZED - Entity descriptor

The MQZED structure is used in a number of authorization service calls to specify the entity for which authorization is to be checked.

Table 1. summarizes the fields in the structure.

Table 1. Fields in MQZED
Field	Description
StrucId	Structure identifier
Version	Version
EntityName Ptr	Entity name
EntityDomainPtr	Entity domain pointer
SecurityId	Security identifier
CorrelationPtr	Correlation pointer

Fields

StrucId

Type: MQCHAR4 - input

Structure identifier. The value is as follows:

MQZED_STRUC_ID: Identifier for entity descriptor structure.
For the C programming language, the constant MQZED_STRUC_ID_ARRAY is also defined; this has the same value as MQZED_STRUC_ID, but is an array of characters instead of a string.

Version

Type: MQLONG - input

Structure version number. The value is as follows:

MQZED_VERSION_1: Version-1 entity descriptor structure.

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

MQZED_CURRENT_VERSION: Current version of entity descriptor structure.

EntityNamePtr

Type: PMQCHAR - input

Profile name.

Address of entity name. This is a pointer to the name of the entity whose authorization is to be checked.

EntityDomainPtr

Type: PMQCHAR - input

Address of entity domain name. This is a pointer to the name of the domain containing the definition of the entity whose authorization is to be checked.

SecurityId

Type: MQBYTE40 - input

Authority.

Security identifier. This is the security identifier whose authorization is to be checked.

CorrelationPtr

Type: MQPTR - input

Correlation pointer. This facilitates the passing of correlational data between the authenticate user function and other appropriate OAM functions.

C declaration


typedef struct tagMQZED MQZED;
struct tagMQZED {
  MQCHAR4   StrucId;          /* Structure identifier */
  MQLONG    Version;          /* Structure version number */
  PMQCHAR   EntityNamePtr;    /* Address of entity name */
  PMQCHAR   EntityDomainPtr;  /* Address of entity domain name */
  MQBYTE40  SecurityId;       /* Security identifier */
  MQPTR     CorrelationPtr;   /* Address of correlation data */