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).
Note:
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. You 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.