Change MQ Service (CHGMQMSVC)

    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

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.


Examples

None


Error messages

Unknown