Home

 

Optional parameters

 

Replace (MQCFIN)

Replace attributes (parameter identifier: MQIACF_REPLACE).

If a namelist definition with the same name as ToServiceName already exists, this specifies whether it is to be replaced. The value can be:

MQRP_YES

Replace existing definition.

MQRP_NO

Do not replace existing definition.

ServiceDesc (MQCFST)

Description of service definition (parameter identifier: MQCA_SERVICE_DESC).

This is a plain-text comment that provides descriptive information about the service definition. It should contain only displayable characters.

If characters are used that are not in the coded character set identifier (CCSID) for the queue manager on which the command is executing, they might be translated incorrectly.

The maximum length of the string is MQ_SERVICE_DESC_LENGTH.

ServiceType (MQCFIN)

The mode in which the service is to run (parameter identifier: MQIA_SERVICE_TYPE).

Specify either:

MQSVC_TYPE_SERVER

Only one instance of the service can be executed at a time, with the status of the service made available by the Inquire Service Status command.

MQSVC_TYPE_COMMAND

Multiple instances of the service can be started.

StartArguments (MQCFST)

Arguments to be passed to the program on startup (parameter identifier: MQCA_SERVICE_START_ARGS).

Specify each argument within the string as you would on a command line, with a space to separate each argument to the program.

The maximum length of the string is MQ_SERVICE_ARGS_LENGTH.

StartCommand (MQCFST)

Service program name (parameter identifier: MQCA_SERVICE_START_COMMAND).

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

The maximum length of the string is MQ_SERVICE_COMMAND_LENGTH.

StartMode (MQCFIN)

Service mode (parameter identifier: MQIA_SERVICE_CONTROL).

Specifies how the service is to be started and stopped. The value can be:

MQSVC_CONTROL_MANUAL

The service is not to be started automatically or stopped automatically. It is to be controlled by user command. This is the default value.

MQSVC_CONTROL_Q_MGR

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

MQSVC_CONTROL_Q_MGR_START

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.

StderrDestination (MQCFST)

Specifies the path to a file to which the standard error (stderr) of the service program should be redirected (parameter identifier: MQCA_STDERR_DESTINATION).

If the file does not exist when the service program is started, the file is created.

The maximum length of the string is MQ_SERVICE_PATH_LENGTH.

StdoutDestination (MQCFST)

Specifies the path to a file to which the standard output (stdout) of the service program should be redirected (parameter identifier: MQCA_STDOUT_DESTINATION).

If the file does not exist when the service program is started, the file is created.

The maximum length of the string is MQ_SERVICE_PATH_LENGTH.

StopArguments (MQCFST)

Specifies the arguments to be passed to the stop program when instructed to stop the service (parameter identifier: MQCA_SERVICE_STOP_ARGS).

Specify each argument within the string as you would on a command line, with a space to separate each argument to the program.

The maximum length of the string is MQ_SERVICE_ARGS_LENGTH.

StopCommand (MQCFST)

Service program stop command (parameter identifier: MQCA_SERVICE_STOP_COMMAND).

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

The maximum length of the string is MQ_SERVICE_COMMAND_LENGTH.

 

Parent topic:

Change, Copy, and Create Service


pc11300_


 

Home