Service component stanza format

The Service and ServiceComponent stanzas can occur in any order.

  ServiceComponent:
    Service=service_name
    Name=component_name
    Module=module_name
    ComponentDataSize=size

service_name

The name of the service. This must match the Name specified in a service stanza.

component_name

A descriptive name of the service component. This must be unique, and contain only the characters that are valid for the names of IBM MQ objects (for example, queue names). This name occurs in operator messages generated by the service. We recommend that we use a name starting with a company trademark or similar distinguishing string.

module_name

The name of the module to contain the code for this component.

size

The size in bytes of the component data area passed to the component on each call. Specify zero if no component data is required.

The Service and ServiceComponent stanzas can occur in any order and the stanza keys under them can also occur in any order. For either of these stanzas, all the stanza keys must be present. If a stanza key is duplicated, the last one is used.

At startup time, the queue manager processes each service component entry in the configuration file in turn. It then loads the specified component module, invoking the entry point of the component (which must be the entry point for initialization of the component), passing it a configuration handle.