CHGMQMSVC (Change MQ Service)

Where allowed to run: All environments (*ALL)
Threadsafe: Yes

The Change MQ Service (CHGMQMSVC) command changes the specified attributes of an existing MQ service definition.

Parameters

Table 1. Command parameters
Keyword	Description	Choices	Notes
SVCNAME	Service name	Character value	Required, Key, Positional 1
MQMNAME	Message Queue Manager name	`Character value`, *DFT	Optional, Key, Positional 2
TEXT	Text 'description'	`Character value`, BLANK, SAME	Optional, Positional 3
STRCMD	Start program	Single values: SAME, NONE Other values: `Qualified object name`	Optional, Positional 4
	Qualifier 1: Start program	Name
	Qualifier 2: Library	Name
STRARG	Start program arguments	`Character value`, BLANK, SAME	Optional, Positional 5
ENDCMD	End program	Single values: SAME, NONE Other values: `Qualified object name`	Optional, Positional 6
	Qualifier 1: End program	Name
	Qualifier 2: Library	Name
ENDARG	End program arguments	`Character value`, BLANK, SAME	Optional, Positional 7
STDOUT	Standard output	`Character value`, BLANK, SAME	Optional, Positional 8
STDERR	Standard error	`Character value`, BLANK, SAME	Optional, Positional 9
TYPE	Service type	SAME, CMD, *SVR	Optional, Positional 10
CONTROL	Service control	SAME, MANUAL, QMGR, STARTONLY	Optional, Positional 11

Service name (SVCNAME)

The name of the service definition to be changed.

The possible values are:

service-name: Specify the name of the service definition. The maximum length of the string is 48 bytes.

Message Queue Manager name (MQMNAME)

Specifies the name of the queue manager.

The possible values are:

*DFT: Use the default queue manager.
queue-manager-name: The name of a message queue manager.

Text 'description' (TEXT)

Specifies text that briefly describes the service definition.

Note: The field length is 64 bytes and the maximum number of characters is reduced if the system is using a double-byte character set (DBCS).

The possible values are:

*SAME: The attribute is unchanged.
*BLANK: The text is set to a blank string.
description: Specify no more than 64 characters enclosed in apostrophes.

Start program (STRCMD)

The name of the program to run.

The possible values are:

*SAME: The attribute is unchanged.
start-command: The name of the start command executable.

Start program arguments (STRARG)

The arguments passed to the program at startup.

The possible values are:

*SAME: The attribute is unchanged.
*BLANK: No arguments are passed to the start command.
start-command-arguments: The arguments passed to the start command.

End program (ENDCMD)

The name of the executable to run when the service is requested to stop.

The possible values are:

*SAME: The attribute is unchanged.
*BLANK: No end command is executed.
end-command: The name of the end command executable.

End program arguments (ENDARG)

The arguments passed to the end program when the service is requested to stop.

The possible values are:

*SAME: The attribute is unchanged.
*BLANK: No arguments are passed to the end command.
end-command-arguments: The arguments passed to the end command.

Standard output (STDOUT)

The path to a file to which the standard output of the service program is redirected.

The possible values are:

*SAME: The attribute is unchanged.
*BLANK: The standard output is discarded.
stdout-path: The standard output path.

Standard error (STDERR)

The path to a file to which the standard error of the service program is redirected.

The possible values are:

*SAME: The attribute is unchanged.
*BLANK: The standard error is discarded.
stderr-path: The standard error path.

Service type (TYPE)

Mode in which to run service.

The possible values are:

*SAME: The attribute is unchanged.
*CMD: When started the command is executed but no status is collected or displayed.
*SVR: The status of the executable started will be monitored and displayed.

Service control (CONTROL)

Whether the service should be started automatically at queue manager start.

The possible values are:

*SAME: The attribute is unchanged.
*MANUAL: The service is automatically started or stopped.
*QMGR: The service is started and stopped as the queue manager is started and stopped.
*STARTONLY: The service is started as the queue manager is started, but will not be requested to stop when the queue manager is stopped.