Copy MQ Service (CPYMQMSVC)

    Where allowed to run
    All environments (*ALL)

    Threadsafe
    Yes

The Copy MQ Service (CPYMQMSVC) command creates an MQ service definition of the same type and, for attributes not specified in the command, with the same attribute values as an existing service definition.


Parameters

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


From Service (FROMSVC)

>

Specifies the name of the existing service definition to provide values for the attributes not specified in this command.

The possible values are:

    from-service-name
    Specify the name of the source service.


To Service (TOSVC)

>

The name of the new service definition to be created. The name can contain a maximum of 48 characters.

If a service definition with this name already exists, REPLACE(*YES) must be specified.

The possible values are:

    to-service-name
    Specify the name of the service being created.


Message Queue Manager name (MQMNAME)

>

Specifies the name of the queue manager.

The possible values are:


Replace (REPLACE)

>

Specifies whether the new service definition should replace an existing service definition with the same name.

The possible values are:

    *NO
    This definition does not replace any existing service definition with the same name. The command fails if the named service definition already exists.

    *YES
    Replace the existing service definition. If there is no definition with the same name, a new definition is created.


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

Parent topic: CL commands reference for IBM i