![[UNIX, Linux, Windows, IBM i]](ngmulti.gif)
Start Service on Multiplatforms
The Start Service (MQCMD_START_SERVICE) command starts an existing IBM® MQ service definition.
Required parameters
- ServiceName (MQCFST)
- Service name (parameter identifier: MQCA_SERVICE_NAME).
This parameter is the name of the service definition to be started. The maximum length of the string is MQ_OBJECT_NAME_LENGTH.
![[V9.1.1 Nov 2018]](ng911.gif)
Optional parameters
- MQIACF_IGNORE_STATE
- Specifies whether the command fails if the service is already running. The possible values are:
- MQIS_NO
- The command fails if the service is already running. This is the default value.
- MQIS_YES
- The command succeeds regardless of the current state of the service.
Error codes
This command might return the following error codes in the response format header, in addition to the values shown in Error codes applicable to all commands.
- Reason (MQLONG)
- The value can be any of the following values:
- MQRCCF_NO_START_CMD
- The StartCommand parameter of the service is blank.
- MQRCCF_SERVICE_RUNNING
- Service is already running.