MQZ_INSERT_NAME - Insert name
This function is provided by a name service component, and is invoked by the queue manager to insert an entry for the specified queue, containing the name of the queue manager that owns the queue. If the queue is already defined in the service, the call fails.
The function identifier for this function (for MQZEP ) is MQZID_INSERT_NAME.
Syntax
- MQZ_INSERT_NAME (queue_manager, QName, Resolvedqueue_manager, ComponentData,
- Continuation, CompCode, Reason)
Parameters
The MQZ_INSERT_NAME call has the following parameters.
queue_manager (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 name service interface does not require the component to make use of it in any defined manner.
QName (MQCHAR48) - input
Queue name.
The name of the queue for which an entry is to be inserted. This name is padded with blanks to the full length of the parameter; the name is not terminated by a null character.
Resolvedqueue_manager (MQCHAR48) - input
Resolved queue manager name.
The name of the queue manager to which the queue resolves. This name is padded with blanks to the full length of the parameter; the name is not terminated by a null character.
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_NAME call.
Continuation (MQLONG) - output
Continuation indicator set by component.
For MQZ_INSERT_NAME , the queue manager does not attempt to invoke another component, whatever is returned in Continuation.
The following values can be specified:
- MQZCI_DEFAULT
- Continuation dependent on queue manager.
- 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_Q_ALREADY_EXISTS
- (2290, X'8F2') Queue object already exists.
- MQRC_SERVICE_ERROR
- (2289, X'8F1') Unexpected error occurred accessing service.
- MQRC_SERVICE_NOT_AVAILABLE
- (2285, X'8ED') Underlying service not available.
C invocation
MQZ_INSERT_NAME (queue_manager, QName, Resolvedqueue_manager, ComponentData, &Continuation, &CompCode, &Reason);The parameters passed to the service are declared as follows:
MQCHAR48 queue_manager; /* Queue manager name */ MQCHAR48 QName; /* Queue name */ MQCHAR48 Resolvedqueue_manager; /* Resolved queue manager name */ MQBYTE ComponentData[n]; /* Component data */ MQLONG Continuation; /* Continuation indicator set by component */ MQLONG CompCode; /* Completion code */ MQLONG Reason; /* Reason code qualifying CompCode */