Home

 

Parameter descriptions

 

The parameter descriptions also apply to the ALTER SERVICE command, with the following exceptions:

(service-name)

Name of the WebSphere MQ service definition (see Rules for naming WebSphere MQ objects). This is required.

The name must not be the same as any other service definition currently defined on this queue manager (unless REPLACE is specified).

CONTROL(string)

Specifies how the service is to be started and stopped:

MANUAL

The service is not to be started automatically or stopped automatically. It is to be controlled by use of the START SERVICE and STOP SERVICE commands. This is the default value.

QMGR

The service being defined is to be started and stopped at the same time as the queue manager is started and stopped.

STARTONLY

The service is to be started at the same time as the queue manager is started, but is not requested to stop when the queue manager is stopped.

DESCR(string)

Plain-text comment. It provides descriptive information about the service when an operator issues the DISPLAY SERVICE command (see DISPLAY SERVICE).

It should contain only displayable characters. The maximum length is 64 characters. In a DBCS installation, it can contain DBCS characters (subject to a maximum length of 64 bytes).

If characters are used that are not in the coded character set identifier (CCSID) for this queue manager, they might be translated incorrectly if the information is sent to another queue manager.

LIKE(service-name)

The name of a service the parameters of which are used to model this definition.

This parameter applies only to the DEFINE SERVICE command.

If this field is not filled in, and you do not complete the parameter fields related to the command, the values are taken from the default definition for services on this queue manager. This is equivalent to specifying: 

LIKE(SYSTEM.DEFAULT.SERVICE)

A default service is provided but it can be altered by the installation of the default values required. See Rules for naming WebSphere MQ objects.

REPLACE and NOREPLACE

Whether the existing definition is to be replaced with this one. This is optional. The default is NOREPLACE.

This parameter applies only to the DEFINE SERVICE command.

REPLACE

The definition should replace any existing definition of the same name. If a definition does not exist, one is created.

NOREPLACE

The definition should not replace any existing definition of the same name.

SERVTYPE

Specifies the mode in which the service is to run:

COMMAND

A command service object. Multiple instances of a command service object can be executed concurrently. We cannot monitor the status of command service objects.

SERVER

A server service object. Only one instance of a server service object can be executed at a time. The status of server service objects can be monitored using the DISPLAY SVSTATUS command.

STARTARG(string)

Specifies the arguments to be passed to the user program at queue manager startup.

STARTCMD(string)

Specifies the name of the program which is to run. You must specify a fully qualified path name to the executable program.

STDERR(string)

Specifies the path to a file to which the standard error (stderr) of the service program should be redirected. If the file does not exist when the service program is started, the file is created. If this value is blank then any data written to stderr by the service program is discarded.

STDOUT(string)

Specifies the path to a file to which the standard output (stdout) of the service program should be redirected. If the file does not exist when the service program is started, the file is created. If this value is blank then any data written to stdout by the service program is discarded.

STOPARG(string)

Specifies the arguments to be passed to the stop program when instructed to stop the service.

STOPCMD(string)

Specifies the name of the executable program to run when the service is requested to stop. You must specify a fully qualified path name to the executable program.

 

Parent topic:

DEFINE SERVICE


sc11270_


 

Home