Keyword and parameter descriptions
You must specify a service for which you want to display 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:
- Information about all service definitions, by using a single asterisk
(*), or
- Information about one or more service that match the specified name.
- (generic-listener-name)
- The name of the service definition for which information is to be displayed.
A single asterisk (*) specifies that information for all service
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 information for those listeners
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 listener 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
- LK
- Matches a generic string that you provide as a filter-value
- NL
- Does not match a generic string that you provide as a filter-value
- 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
- Specify this to display all the service information for each specified
service. If this parameter is specified, any parameters that are requested
specifically have no effect; all parameters are still displayed.
This is
the default if you do not specify a generic identifier, 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.
- ALTDATE
- The date on which the definition was last altered, in the form yyyy-mm-dd.
- ALTTIME
- The time at which the definition was last altered, in the form hh.mm.ss.
- 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.
- SERVTYPE
- Specifies the mode in which the service is to run:
- COMMAND
- A command service object. Multiple instances of a command service object
can be executed concurrently. You cannot monitor the status of command service
objects.
- SERVER
- A server service object. Only one instance of a server service object
can be executed at a time. The status of server service objects can be monitored
using the DISPLAY SVSTATUS command.
- STARTARG
- Specifies the arguments to be passed to the user program at queue manager
startup.
- STARTCMD
- Specifies the name of the program which is to run.
- STDERR
- Specifies the path to the file to which the standard error (stderr)
of the service program is to be redirected.
- STDOUT
- Specifies the path to the file to which the standard output (stdout)
of the service program is to be redirected.
- STOPARG
- Specifies the arguments to be passed to the stop program when instructed
to stop the service.
- STOPCMD
- Specifies the name of the executable program to run when the service
is requested to stop.