+

Search Tips | Advanced Search

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

Last updated: 2020-10-04