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.

Optional parameters

MQIACF_IGNORE_STATE

This parameter allows you to specify whether we want the command to return an error return code, if the object is already in the state the command would move it to. Possible values are:

MQIS_NO

If the service being started is already in that state, the command returns RC=10. This is the existing behavior, and NO is the default value.

MQIS_YES

If the service being started is already in that state, the command returns RC=0. The return code is the case as if the service is not running.

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.

Parent topic: Definitions of the Programmable Command Formats