Inquire Service Status (Response)
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.
HP Integrity NonStop Server | UNIX and Linux® | Windows |
---|---|---|
X | X |
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: MQIACH_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:
- 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.