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.

Parent topic: Definitions of the Programmable Command Formats