admsar(1M)                       DG/UX 5.4.2                      admsar(1M)


NAME
       admsar - manage system activity monitoring and reporting

SYNOPSIS
       admsar -o start [ -e ] [ -t interval ] [ -n samples ] [ name ]

       admsar -o stop name ...

       admsar -o delete name ...

       admsar -o list [ -qv ] [ -r report-type ] [ name ]

       admsar -o list [ -qv ] [ -r report-type ] -t interval -n samples

DESCRIPTION
       The admsar command starts or stops system activity monitoring, or
       produces a report from a previous (or current) monitoring session.
       System activity monitoring and reporting are performed using the
       sar(1) command.  Refer to that manual entry for more information.

   Operations
       start     Initiate a monitoring session.  A sampling interval (in
                 seconds) and the number of samples are specified.  The
                 monitoring session will stop automatically after the
                 requisite number of samples are taken.  The results of the
                 sampling are placed in the named data file (if no name is
                 specified, one will be created based on the current day of
                 the month).

       stop      Terminate a monitoring session.  This is provided as an
                 alternative to allowing the monitoring session to cease of
                 its own accord.  The data collection associated with the
                 named data files is stopped, or all data collection is
                 stopped if name is all.

       delete    Remove specified named data files, or all data files if
                 name is all.

       list      Produce one of several system activity reports, as selected
                 with the -r option.  The report can use the sampling
                 information in a named data file created by the start
                 operation.  If an interval or sample count is specified,
                 the sample information is collected directly from the
                 system instead of from a data file (and the command waits
                 for sampling to be completed).

   Options
       -e        Erase the data file before writing to it.  Otherwise, new
                 data is appended to the file.

       -t interval
                 The number of seconds between samples.  The default
                 interval is 5 seconds.




Licensed material--property of copyright holder(s)                         1

admsar(1M)                       DG/UX 5.4.2                      admsar(1M)


       -n samples
                 The number of samples to take.  The default number of
                 samples is 10.

       -r report-type
                 The type of report.  report-type is a single letter
                 selected from the option letters allowed for sar(1).  An
                 additional report type is F, which lists all known data
                 files; no data file name, interval, or sample count should
                 be specified with this report type.  If no report type is
                 specified, type u (user, system, and idle times) is used.

       -q        Quiet.  Headings are left off of reports.

       -v        Verbose.  This option is enabled by default.

EXAMPLES
       Suppose you want to initiate a one-minute monitoring session with
       samples every five seconds, and you don't want to include any
       previous sampling that may have been done earlier in the day.  Use:

            admsar -o start -e -t 5 -n 12

       After a minute, you may then produce reports based on this sampling.
       Suppose you want a report on the system calls during that session,
       and then a report on the CPU usage.  Use:

            admsar -o list -r c
            admsar -o list -r u

       If you want to keep this sample separate from other samples you might
       be taking, use a named data file:

            admsar -o start -t 5 -n 12 midday
            admsar -o list -r w midday

       Once all reports have been produced, you may remove all sample data
       files by using:

            admsar -o delete all


FILES
       /var/adm/sa/spd.Daydd Default sampling data file, where dd is the
                             two-digit day of the month.  All activity for
                             the current day is stored together in this
                             file.

       /var/adm/sa/spd.name  Named sampling data file.

OUTPUT
       The list command produces the output from the sar(1) command, as
       described in that manual entry.




Licensed material--property of copyright holder(s)                         2

admsar(1M)                       DG/UX 5.4.2                      admsar(1M)


DIAGNOSTICS
   Warning
       None.

   Errors
        -     A list operation was attempted and the named report file does
              not exist.

        -     A report file name, sampling interval, or sample count was
              specified with the list operation and the F report type.

   Exit Codes
        0     The operation was successful.

        1     The operation was unsuccessful.  The system activity monitor
              has not yet been run (list).

        2     The operation failed due to access restrictions.

        3     There was an error in the command line.

SEE ALSO
       sar(1), sar(1M), sysadm(1M).

NOTES
       Only the super-user may use the start, stop, and delete operations.

       Having more than one monitoring session active for the same data
       collection file name will produce unpredictable results.




























Licensed material--property of copyright holder(s)                         3