1 TERMINALS

TERMINALS will generate information for the terminal connections on the 
system, whether they are over a terminal server, direct connect, LAN, etc.
A user must have SYSPRV privilege to run this utility.

!
2 qualifiers                                                           

The valid qualifiers for TERMINALS are:

      /AUDITFILE[=file]        -  A default qualifier that allows you
                                  to indicate from which SECURITY_AUDIT
                                  files to use to gather information.

      /BEFORE=date             -  Allows the user to specify a date to
                                  look prior to.

      /EXTRACT[=file]          -  Will create a condensed binary file
                                  of the audit files that can be used
                                  at a file with the /AUDITFILE qualifier.

      /OUTPUT[=file]           -  A default qualifier that allows you
                                  to change the name of the information
                                  output file.

      /[NO]SHOW                -  Allows user to display program
                                  progression.

      /SINCE=date              -  Allows the user to specify a date to
                                  look after.

      /[NO]STATISTICS[=file]   -  Will generate statistics from the
                                  information gathered from the system.
                                  Such information that is displayed is
                                  the number of times the terminal was
                                  accessed, the total number of minutes
                                  as well as the maximum, minimum, and
                                  average lengths of connection time.

      /[NO]TERMFILE[=file]     -  Allows the user to specify where to
                                  find terminal location information.

!
2 /AUDITFILE

   /AUDITFILE[=security_audit.files]   (default)

   Will allow you to change the specification of the audit files to 
   extract the information.  The defuault file specification of this
   qualifier is:

        SYS$COMMON:[SYSMGR]SECURITY_AUDIT.AUDIT$JOURNAL.0

!
2 /BEFORE

   /BEFORE=dd-mmm-yyy

   Allows a date specification to gather information prior to the given
   date.

!
2 /EXTRACT

   /EXTRACT[=file]
   /NOEXTRACT               (default)

   Will extract the useful terminal information from the audit files
   and put them into a binary file that can be used with the /AUDITFILE
   qualifier.  The information can then aquired more quickly if the
   program needs to be run again, or if it is wished to run on a faster
   CPU.  The default file name given with this qualifier is:

                         []AUDIT.AUDIT$JOURNAL
   
!
2 /OUTPUT

   /OUTPUT[=output.file]    (default)

   Specifies the information output file.  The default file name is
   []TERMINALS.INFO.  This file is used to generate futher terminal
   analysis.

!
2 /SHOW

   /SHOW
   /NOSHOW         (default)

   Allows program to display processing progression messages during
   execution.  /SHOW is good when processing a large amount of data.

!
2 /SINCE

   /SINCE=dd-mmm-yyyy

   Allows a date specification to gather information after the given
   date.

!
2 /STATISTICS

   /STATISTICS[=statistics.file]
   /NOSTATISTICS                     (default)

   This qualifier will generate statistics from the information gathered
   by the program.  The default file is []TERMINALS.STAT.  The statitics
   that are generated will provide the terminal (hard wired, server & port,
   etc.), the number of times that teriminal was logged into, the total
   time used on that terminal, the length in time of the shortest (minimum) 
   session, the length in time of the longest (maximum) session, the
   average length in time of sessions over the time period, and the
   location of that terminal extracted from the data file.

!
2 /TERMFILE                                                               

   /TERMFILE[=location.file]    (defualt)
   /NOTERMFILE

   Allows the specification of the file containing the locations of
   terminals.  The defualt file specification is:

           SYS$UTILITIESX:[TERMINALS]TERMINALS.DAT

   The format of this file is terminal then location for each record.
   The location has a maximum of 30 characters.  The file is free 
   formatted, and the first two lines of the file are reserved for
   placing headers.
!
2 examples

 $ TERMINALS

 1.  This example will create the information file TERM_INFO.DAT.
 It is this file that all final information is generated from.  This
 file is provided to the user for further processing if desired or 
 just to make you say "hmmmm."  The information file is created every
 time TERMINALS is run.



 $ TERMINALS/STATISTICS=STAT.DAT/SINCE=1-JAN-1992/AUDITFILE=*AUDIT.*JOUR*.*

 2.  This example will generate statistics since January 1, 1992 from 
 all of the files that meet the specifications of *AUDIT.*JOUR*.* and
 put the final statistics in the file STAT.DAT.



 $ TERMINALS/OUTPUT=TERM_INFO.DAT/STATISTICS

 3.  This example will generate statistics and place them into the
 default file TERMINALS.STAT while the information will be placed in 
 the file TERM_INFO.DAT.
