MQZ_COPY_ALL_AUTHORITY - Copy all authority

This function is provided by an authorization service component. It is invoked by the queue manager to copy all of the authorizations that are currently in force for a reference object to another object.

The function identifier for this function (for MQZEP) is MQZID_COPY_ALL_AUTHORITY.

Syntax

MQZ_COPY_ALL_AUTHORITY (QMgrName, RefObjectName, ObjectName,: ObjectType, ComponentData, Continuation, CompCode, Reason)

Parameters

The MQZ_COPY_ALL_AUTHORITY call has the following parameters.

QMgrName (MQCHAR48) - input

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.

RefObjectName (MQCHAR48) - input

Reference object name.

The name of the reference object, the authorizations for which are to be copied. 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.

ObjectName (MQCHAR48) - input

Object name.

The name of the object for which accesses are to be set. 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.

ObjectType (MQLONG) - input

Object type.

The type of object specified by RefObjectName and ObjectName. It is one of the following:

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.

ComponentData (MQBYTE×ComponentDataLength) - input/output

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 (MQLONG) - output

Continuation indicator set by component.

The following values can be specified:

MQZCI_DEFAULT: Continuation dependent on queue manager.
For MQZ_COPY_ALL_AUTHORITY this has the same effect as MQZCI_STOP.
MQZCI_CONTINUE: Continue with next component.
MQZCI_STOP: Do not continue with next component.

CompCode (MQLONG) - output

Completion code.

It is one of the following:

MQCC_OK: Successful completion.
MQCC_FAILED: Call failed.

Reason (MQLONG) - output

Reason code qualifying CompCode.

If CompCode is MQCC_OK:

MQRC_NONE: (0, X'000') No reason to report.

If CompCode is MQCC_FAILED:

MQRC_SERVICE_ERROR: (2289, X'8F1') Unexpected error occurred accessing service.
MQRC_SERVICE_NOT_AVAILABLE: (2285, X'8ED') Underlying service not available.
MQRC_UNKNOWN_REF_OBJECT: (2294, X'8F6') Reference object unknown.

For more information on these reason codes, see the WebSphere MQ Application Programming Reference.

C invocation

MQZ_COPY_ALL_AUTHORITY (QMgrName, RefObjectName, ObjectName, ObjectType,
                       ComponentData, &Continuation, &CompCode,
                       &Reason);

The parameters passed to the service are declared as follows:

MQCHAR48  QMgrName;          /* Queue manager name */
MQCHAR48  RefObjectName;     /* Reference object name */
MQCHAR48  ObjectName;        /* Object name */
MQLONG    ObjectType;        /* Object type */
MQBYTE    ComponentData[n];  /* Component data */
MQLONG    Continuation;      /* Continuation indicator set by
                                component */
MQLONG    CompCode;          /* Completion code */
MQLONG    Reason;            /* Reason code qualifying CompCode */