ServiceComponent stanza of the qm.ini file
The ServiceComponent stanza specifies information for the service component. You must specify service component information when you add a new installable service. The authorization service stanza is present by default, and the associated component, the OAM, is active.
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.
- Service= service_name
- The name of the required service. This must match the value specified on the
Name
attribute of the Service configuration information. - Name= component_name
- The descriptive name of the service component. This must be unique and contain only 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 this name begins with a company trademark or similar distinguishing string.
- Module= module_name
- The name of the module to contain the code for this component. This must be a full path name.
- ComponentDataSize= 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.
Example stanza
ServiceComponent:
Service=AuthorizationService
Name=MQSeries.UNIX.auth.service
Module=amqzfu
ComponentDataSize=0
For further examples showing an AuthorizationService stanza and its associated ServiceComponent stanzas and a NameService stanza and its associated ServiceComponent stanza, see Service stanza of the qm.ini file.