ADD configuration command

You can use the ADD command to add new service definitions, user-specific definitions, and service lists to a configuration.

Adding services

Adding a new service typically occurs during the installation customization process. Otherwise, you can add a service by using the ADD configuration command.

When you add a service, you specify the service name and select the service class for the new service. The service class is predefined.

The following table lists the service classes and the service type that each service class defines.

Table 1. Service classes.
Service class	Service type
CAP	Capture service
CNTL	Region controller service
GLOB	Global service
INIT	Client connection handler service
LOG	Logger service
MAA	Monitoring service
OPER	Remote operator command service
PAA	Administration service
QP	Single-phase commit query processor service
QPLD	Refresh query processor service

You can add services with the following ADD command:

ADD,CONFIG,SERVICE=servicename,SERVICECLASS=serviceclass

Example

To add a new capture service named CS to the configuration, issue the following command:

ADD,CONFIG,SERVICE=CS,SERVICECLASS=CAP

In this example, the configuration parameters for the TESTV10 service are created with the default values for the LOG service class.

Adding user-specific configurations

When you add a user-specific configuration, you must specify a user ID. The user ID is associated with a defined service. You can override the default values for the configuration parameters for the service that you specify. In version 9.5, you can define user-specific configurations for query processor services only.

Command format:

ADD,CONFIG,USER=userid,SERVICE=servicename

Example

To add a new user record for TESTUSER to the configuration for service TESTV10, issue the following command:

ADD,CONFIG,CONFIG,USER=TESTUSER,SERVICE=TESTV10

Parameters

serviceclass: The name of the service class that the service is associated with.
servicename: When adding a service, specify the name of the service to create. When adding a user-specific configuration, specify the name of the service to override. The maximum length allowed for the name is 64 bytes.
userid: For a user-specific configuration, the user logon ID used to connect to the Classic data server. The maximum length allowed for the user ID is 8 bytes.