Inquire Service Status (Response) on Multiplatforms

The response to the Inquire Service Status (MQCMD_INQUIRE_SERVICE_STATUS) command consists of the response header followed by the ServiceName structure and the requested combination of attribute parameter structures.

If a generic service name was specified, one such message is generated for each service found.

Always returned:: ServiceName
Returned if requested:: ProcessId, ServiceDesc, StartArguments, StartCommand, StartDate, StartMode, StartTime, Status, StderrDestination, StdoutDestination, StopArguments, StopCommand

Response data

ProcessId (MQCFIN): Process identifier (parameter identifier: MQIACF_PROCESS_ID).
The operating system process identifier associated with the service.

ServiceDesc (MQCFST): Description of service definition (parameter identifier: MQCACH_SERVICE_DESC).
The maximum length of the string is MQ_SERVICE_DESC_LENGTH.

ServiceName (MQCFST): Name of the service definition (parameter identifier: MQCA_SERVICE_NAME).
The maximum length of the string is MQ_OBJECT_NAME_LENGTH.

StartArguments (MQCFST): Arguments to be passed to the program on startup (parameter identifier: MQCA_SERVICE_START_ARGS).
The maximum length of the string is MQ_SERVICE_ARGS_LENGTH.

StartCommand (MQCFST)

Service program name (parameter identifier: MQCA_SERVICE_START_COMMAND).

Specifies the name of the program which is to run.

The maximum length of the string is MQ_SERVICE_COMMAND_LENGTH.

StartDate (MQCFST)

Start date (parameter identifier: MQIACF_SERVICE_START_DATE).

The date, in the form yyyy-mm-dd, on which the service was started.

The maximum length of the string is MQ_DATE_LENGTH

StartMode (MQCFIN)

Service mode (parameter identifier: MQIA_SERVICE_CONTROL).

How the service is to be started and stopped. The value can be:

MQSVC_CONTROL_MANUAL: The service is not to be started automatically or stopped automatically. It is to be controlled by user command.
MQSVC_CONTROL_Q_MGR: The service is to be started and stopped at the same time as the queue manager is started and stopped.
MQSVC_CONTROL_Q_MGR_START: The service is to be started at the same time as the queue manager is started, but is not request to stop when the queue manager is stopped.

StartTime (MQCFST)

Start date (parameter identifier: MQIACF_SERVICE_START_TIME).

The time, in the form hh.mm.ss, at which the service was started.

The maximum length of the string is MQ_TIME_LENGTH

Status (MQCFIN)

Service status (parameter identifier: MQIACF_SERVICE_STATUS).

The status of the service. The value can be any of the following values:

MQSVC_STATUS_STARTING: The service is in the process of initializing.
MQSVC_STATUS_RUNNING: The service is running.
MQSVC_STATUS_STOPPING: The service is stopping.

StderrDestination (MQCFST): Specifies the path to a file to which the standard error (stderr) of the service program is to be redirected (parameter identifier: MQCA_STDERR_DESTINATION).
The maximum length of the string is MQ_SERVICE_PATH_LENGTH.

StdoutDestination (MQCFST): Specifies the path to a file to which the standard output (stdout) of the service program is to be redirected (parameter identifier: MQCA_STDOUT_DESTINATION).
The maximum length of the string is MQ_SERVICE_PATH_LENGTH.

StopArguments (MQCFST): Specifies the arguments to be passed to the stop program when instructed to stop the service (parameter identifier: MQCA_SERVICE_STOP_ARGS).
The maximum length of the string is MQ_SERVICE_ARGS_LENGTH.

StopCommand (MQCFST)

Service program stop command (parameter identifier: MQCA_SERVICE_STOP_COMMAND).

This parameter is the name of the program that is to run when the service is requested to stop.

The maximum length of the string is MQ_SERVICE_COMMAND_LENGTH.