Envoy Configuration and Management Manual

Subsystem Control Facility (SCF) Commands for
Envoy
Envoy Configuration and Management Manual—429861-001
5-42
STATS LINE Command
STATS LINE Command
The STATS command displays statistical information about the execution history of
lines. It shows dynamic information such as the number of messages sent and received
and the number of format errors. In addition to the statistical information, Envoy returns
a timestamp to show the time the sample was taken. This is not a sensitive command.
To issue the STATS command, first you need the name of the line. To find the names of
your Envoy lines, enter LISTDEV TYPE 7 or LISTDEV ENVOY at the SCF prompt.
TYPE 7 refers to Envoy. The Envoy lines are listed in the Names column.
The command syntax is as follows:
OUT file-spec
causes any SCF output generated for this command to be directed to the specified
file.
LINE line-name
designates the line whose statistical information you wish to display. If you omit the
line-name, the statistics for the assumed line is displayed (for information about the
ASSUME command, see the SCF Reference Manual for G-Series Releases).
RESET
if present, restores all the statistics counters to their initial values after the statistics
are displayed.
RESET is a sensitive option. That is, it can be specified in a STATS command only
by a user with super-group access, the owner of a subsystem, or a member of the
same group as the owner of the subsystem.
The owner of the subsystem is the user who started that subsystem or any user
whose application ID is the same as the server ID (this identical ID is the result of a
PROGID option that requires super-group access).
Considerations
•
Envoy does not support the SEL or the SUB options.
•
The STATS command is not a sensitive command. However, the RESET option is
sensitive.
Examples
The following command displays statistical information for the line $ASCA:
-> STATS LINE $ASCA
STATS [ / OUT file-spec / ] [ LINE line-name ] [ , RESET ]