!++
! description of the STATS processor and its attendant commands
!--
1 STATS
The STATS processor is used to elicit outputs of displays and/or to elicit
writes of log records to a disk file, showing VMS performance and
resource utilization data.
 
In addition to logging and displaying the performance data, STATS provides
the capability of generating graphical representations of this data.
 
Format:

     STATS
2 Commands

     DISPLAY    EXIT       HELP      PDL        PLOT      QUIT       REPLAY
     SET        SHOW       SNOOZE    USE        $
!++
! description of the DISPLAY command
!--
1 DISPLAY
Shows information about VMS and resource utilization. The information is
grouped into classes of similar type. 

Format:

     DISPLAY class [,class,...] [file-spec]     
2 class

 CPU      -  CPU utilization statistics
 DECNET   -  DECnet tranmission and reception statistics
 FCP      -  File Control Primitive Statistics
 LOCK     -  ENQ/DEQ statistics
 MEMORY   -  System memory utilization
 MISC     -  Miscellaneous Statistics
 PGFLT    -  Page fault statistics
 RESPONSE -  The System Response
 SCHED    -  Time spent in each scheduler state
 SWAP     -  Swapping Statistics
2 file-spec

 Specifies the name of a file to contain information from a DISPLAY 
 command.
!++
! Description of the  PLOT command
!--
1 PLOT
Generates a plot on a VT-100 or similar terminal of data derived from the
captured information on VMS.
 
Format:

     PLOT plot-item
2 plot-item

 Specifies the type of plot to produce. For a complete list, see the STATS
 manual.
!++
! Description of the PDL command
!--
1 PDL
Generates a PDL( Plot Description File ) plot file that can be turned
into a device specific plot.
 
Format:

     PDL plot-item [,plot-item] file-spec
2 plot-item

 Specifies the type of plot to produce. For a complete list, see the STATS
 manual.
2 file-spec 

 Specifies the name of the file to contain the PDL information for a 
 specific plot.
!++
! description of the SHOW command
!--
1 SHOW
Communicates information about parameters that have been set either by the
STATS user or by default.
 
Format:

     SHOW show-item [,show-item...]
2 show-item

 Specifies item whose current state is to be reported. These are:
 
 START  - The time of day that STATS is to use as a beginning time.
 END    - The time of day that STATS is to use as an concluding time.
 FILE   - The name of the file currently being used for statistical 
          information.
!++
! description of the REPLAY command
!--
1 REPLAY
Replays data from the current information file in ascending time sequence.
 
Format:

     REPLAY replay-item [,replay-item...] [file-spec]
2 replay-item

 Specifies the type of replay to produce. For a complete list, see the STATS
 manual.
2 file-spec

 Specifies the name of file to contain the replayed data.
!++
! description of the SNOOZE command
!--
1 SNOOZE
Allows the STATS user to put STATS to sleep either for a delta time or
till an absolute time.
 
Format:

     SNOOZE [ALARM]  ( FOR delta-time | TILL absolute-time )
2 ALARM

 If ALARM is specified on a SNOOZE command, the user will be prompted
by an alarm bell when STATS wakes up.
2 delta-time

 Specifies a delta-time in system format after which STATS is to wake 
 up.
2 absolute-time

 Specifies an absolute time in system format at which time STATS is to
 wake up.
!++
! description of the SET command
!--
1 SET
Allows the STATS user to modify parameters within STATS.
 
Format:

     SET set-option value
2 set-option

 Specifies the parameter the STATS user wants to modify.
3 START

 The time in system format that STATS uses as a beginning time.
3 END

 The time in system format that STATS uses as a concluding time.
2 value

 Specifies the value that the set-option parameter is to take on.
 The value is a time in system time format or a keyword for the time.
3 START

 Keyword that indicates the beginning of the statistical information.
3 END

 Keyword that indicates the last of the statistical information.
!++
! description for the EXIT
!--
1 EXIT

Concludes a STATS session.
 
Format:

     EXIT
!++
! description of the QUIT command
!--
1 QUIT

Concludes a STATS session.
 
Format:

     QUIT
!++
! description of the USE command
!--
1 USE
Modifies the default file that STATS uses as statistical input.
 
Format:

     USE file-spec
2 file-spec

 A file of VMS statisical information created by MOUSE.
!++
! description of the HELP command
!--
1 HELP
Gives the STATS user valuable information on how to use STATS effectively.
 
Format:

     HELP help-topic
2 help-topic

 The topic of interest to the STATS user.
!++
! Issue a DCL command
!--
1 $
Allows the STATS user to issue a DCL command from STATS.
 
Format:
 
     $ string
2 string
 
Any valid DCL command.
