This function is provided by a MQZAS_VERSION_2 authorization service component, and is invoked by the queue manager to retrieve the authority that an entity has to access the specified object.
The function identifier for this function (for MQZEP ) is MQZID_GET_AUTHORITY.
MQZ_GET_AUTHORITY_2 is similar to MQZ_GET_AUTHORITY , but with the EntityName parameter replaced by the EntityData parameter.
|
The MQZ_GET_AUTHORITY_2 call has the following parameters.
Queue manager name.
The name of the queue manager calling the component. This name is padded with blanks to the full length of the parameter; the name is not terminated by a null character.
The queue-manager name is passed to the component for information; the authorization service interface does not require the component to make use of it in any defined manner.
Entity data.
Data relating to the entity whose access to the object is to be retrieved. See MQZED - Entity descriptor for details.
Entity type.
The type of entity specified by EntityData. The following value can be specified:
Object name.
The name of the object for which the entity's authority is to be retrieved. The maximum length of the string is 48 characters; if it is shorter than that it is padded to the right with blanks. The name is not terminated by a null character.
If ObjectType is MQOT_Q_MGR, this name is the same as QMgrName.
Object type.
The type of entity specified by ObjectName. It is one of the following:
Authority of entity.
If the entity has one authority, this field is equal to the appropriate authorization operation (MQZAO_* constant). If it has more than one authority, this field is the bitwise OR of the corresponding MQZAO_* constants.
Component data.
This data is kept by the queue manager on behalf of this particular component; any changes made to it by any of the functions provided by this component are preserved, and presented the next time one of this component's functions is called.
The length of this data area is passed by the queue manager in the ComponentDataLength parameter of the MQZ_INIT_AUTHORITY call.
Continuation indicator set by component.
The following values can be specified:
For MQZ_GET_AUTHORITY_2 this has the same effect as MQZCI_CONTINUE.
Completion code.
Reason code qualifying CompCode.
If CompCode is MQCC_FAILED:
For more information on these reason codes, see the WebSphere MQ Application Programming Reference.
MQZ_GET_AUTHORITY_2 (QMgrName, &EntityData, EntityType, ObjectName,
ObjectType, &Authority, ComponentData,
&Continuation, &CompCode, &Reason);
The parameters passed to the service are declared as follows:
MQCHAR48 QMgrName; /* Queue manager name */
MQZED EntityData; /* Entity data */
MQLONG EntityType; /* Entity type */
MQCHAR48 ObjectName; /* Object name */
MQLONG ObjectType; /* Object type */
MQLONG Authority; /* Authority of entity */
MQBYTE ComponentData[n]; /* Component data */
MQLONG Continuation; /* Continuation indicator set by
component */
MQLONG CompCode; /* Completion code */
MQLONG Reason; /* Reason code qualifying CompCode */