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.

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 */
Parent topic: Installable services interface reference information