[UNIX, Linux, Windows, IBM i]

DISPLAY SVSTATUS on Multiplatforms

Use the MQSC command DISPLAY SVSTATUS to display status information for one or more services. Only services with a SERVTYPE of SERVER are displayed.

Using MQSC commands

For information on how you use MQSC commands, see Performing local administration tasks using MQSC commands.

Synonym:

DISPLAY SVSTATUS

Read syntax diagramSkip visual syntax diagram DISPLAY SVSTATUS ( service-name ) WHERE(FilterCondition) ALL requested attributes
Requested attributes
Read syntax diagramSkip visual syntax diagram,CONTROLDESCRPIDSERVTYPESTARTARGSTARTCMDSTARTDASTARTTISTATUSSTDERRSTDOUTSTOPARGSTOPCMD

Keyword and parameter descriptions for DISPLAY SVSTATUS

You must specify a service for which you want to display status information. You can specify a service by using either a specific service name or a generic service name. By using a generic service name, you can display either:
  • Status information for all service definitions, by using a single asterisk (*), or
  • Status information for one or more services that match the specified name.
(generic-service-name)
The name of the service definition for which status information is to be displayed. A single asterisk (*) specifies that information for all connection identifiers is to be displayed. A character string with an asterisk at the end matches all services with the string followed by zero or more characters.
WHERE
Specify a filter condition to display status information for those services that satisfy the selection criterion of the filter condition. The filter condition is in three parts: filter-keyword, operator, and filter-value:
filter-keyword
Any parameter that can be used to display attributes for this DISPLAY command.
operator
This is used to determine whether a service satisfies the filter value on the given filter keyword. The operators are:
LT
Less than
GT
Greater than
EQ
Equal to
NE
Not equal to
LE
Less than or equal to
GE
Greater than or equal to
filter-value
The value that the attribute value must be tested against using the operator. Depending on the filter-keyword, this can be:
  • An explicit value, that is a valid value for the attribute being tested.

    You can use operators LT, GT, EQ, NE, LE, or GE only. However, if the attribute value is one from a possible set of values on a parameter (for example, the value MANUAL on the CONTROL parameter), you can only use EQ or NE.

  • A generic value. This is a character string. with an asterisk at the end, for example ABC*. If the operator is LK, all items where the attribute value begins with the string (ABC in the example) are listed. If the operator is NL, all items where the attribute value does not begin with the string are listed.

    You cannot use a generic filter-value for parameters with numeric values or with one of a set of values.

ALL
Display all the status information for each specified service. This is the default if you do not specify a generic name, and do not request any specific parameters.

Requested parameters

Specify one or more attributes that define the data to be displayed. The attributes can be specified in any order. Do not specify the same attribute more than once.

CONTROL
How the service is to be started and stopped:
MANUAL
The service is not to be started automatically or stopped automatically. It is to be controlled by use of the START SERVICE and STOP SERVICE commands.
QMGR
The service is to be started and stopped at the same time as the queue manager is started and stopped.
STARTONLY
The service is to be started at the same time as the queue manager is started, but is not requested to stop when the queue manager is stopped.
DESCR
Descriptive comment.
PID
The operating system process identifier associated with the service.
SERVTYPE
The mode in which the service runs. A service can have a SERVTYPE of SERVER or COMMAND, but only services with SERVTYPE(SERVER) are displayed by this command.
STARTARG
The arguments passed to the user program at startup.
STARTCMD
The name of the program being run.
STARTDA
The date on which the service was started.
STARTTI
The time at which the service was started.
STATUS
The status of the process:
RUNNING
The service is running.
STARTING
The service is in the process of initializing.
STOPPING
The service is stopping.
STDERR
Destination of the standard error (stderr) of the service program.
STDOUT
Destination of the standard output (stdout) of the service program.
STOPARG
The arguments to be passed to the stop program when instructed to stop the service.
STOPCMD
The name of the executable program to run when the service is requested to stop.
For more information about these parameters, see DEFINE SERVICE on Multiplatforms.