MQZEP - Add component entry point

A service component starts this function, during initialization, to add an entry point to the entry point vector for that service component.

Syntax

MQZEP ( Hconfig , Function , EntryPoint , CompCode , Reason )

Parameters

Hconfig

Type: MQHCONFIG - input

Configuration handle. This handle represents the component that is being configured for this particular installable service. It must be the same as the component passed to the component configuration function by the queue manager on the component initialization call.

Function

Type: MQLONG - input

Function identifier. Valid values for this are defined for each installable service.

If MQZEP is called more than once for the same function, the last call made provides the entry point that is used.

EntryPoint

Type: PMQFUNC - input

Function entry point. This is the address of the entry point provided by the component to perform the function.

The value NULL is valid, and indicates that the function is not provided by this component. NULL is assumed for entry points that are not defined using MQZEP.

CompCode

Type: MQLONG - output

Completion code. It must be one of the following values:

MQCC_OK: Successful completion.
MQCC_FAILED: Call failed.

Reason

Type: 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_FUNCTION_ERROR: (2281, X'8E9') Function identifier not valid.
MQRC_HCONFIG_ERROR: (2280, X'8E8') Configuration handle not valid.

For more information about these reason codes, see API completion and reason codes.

C invocation


MQZEP (Hconfig, Function, EntryPoint, &CompCode, &Reason);

Declare the parameters as follows:


MQHCONFIG  Hconfig;     /* Configuration handle */
MQLONG     Function;    /* Function identifier */
PMQFUNC    EntryPoint;  /* Function entry point */
MQLONG     CompCode;    /* Completion code */
MQLONG     Reason;      /* Reason code qualifying CompCode */