Create MQ Service (CRTMQMSVC)
- Where allowed to run
- All environments (*ALL)
- Threadsafe
- Yes
The Create MQ Service (CRTMQMSVC) command creates a new MQ service definition, specifying those attributes that are to be different from the default.
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 |
| REPLACE | Replace | *NO, *YES | Optional, Positional 3 |
| TEXT | Text 'description' | Character value, *BLANK, *SYSDFTSVC | Optional, Positional 4 |
| STRCMD | Start program | Single values: *SYSDFTSVC, *NONE Other values: Qualified object name | Optional, Positional 5 |
| Qualifier 1: Start program | Name | ||
| Qualifier 2: Library | Name | ||
| STRARG | Start program arguments | Character value, *BLANK, *SYSDFTSVC | Optional, Positional 6 |
| ENDCMD | End program | Single values: *SYSDFTSVC, *NONE Other values: Qualified object name | Optional, Positional 7 |
| Qualifier 1: End program | Name | ||
| Qualifier 2: Library | Name | ||
| ENDARG | End program arguments | Character value, *BLANK, *SYSDFTSVC | Optional, Positional 8 |
| STDOUT | Standard output | Character value, *BLANK, *SYSDFTSVC | Optional, Positional 9 |
| STDERR | Standard error | Character value, *BLANK, *SYSDFTSVC | Optional, Positional 10 |
| TYPE | Service type | *SYSDFTSVC, *CMD, *SVR | Optional, Positional 11 |
| CONTROL | Service control | *SYSDFTSVC, *MANUAL, *QMGR, *STARTONLY | Optional, Positional 12 |
Service name (SVCNAME)
>The name of the new MQ service definition.
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.
Replace (REPLACE)
>If a service definition with the same name already exists, this specifies whether it is replaced.
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:
- *SYSDFTSVC
- The value of this attribute is taken from the system default service.
- *BLANK
- The text is set to a blank string.
- description
- Specify the new descriptive information.
Start program (STRCMD)
>The name of the program to run.
The possible values are:
- *SYSDFTSVC
- The value of this attribute is taken from the system default service.
- 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:
- *SYSDFTSVC
- The value of this attribute is taken from the system default service.
- *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:
- *SYSDFTSVC
- The value of this attribute is taken from the system default service.
- *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:
- *SYSDFTSVC
- The value of this attribute is taken from the system default service.
- *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:
- *SYSDFTSVC
- The value of this attribute is taken from the system default service.
- *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:
- *SYSDFTSVC
- The value of this attribute is taken from the system default service.
- *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:
- *SYSDFTSVC
- The value for this attribute is taken from the system default service.
- *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:
- *SYSDFTSVC
- The value for this attribute is taken from the system default service.
- *MANUAL
- The service will not be automatically started or stopped.
- *QMGR
- The service will be started and stopped as the queue manager is started and stopped.
- *STARTONLY
- The service will be 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