# sa1

## NAME



           sa1 - Collect and store binary data in the system activity daily
           data file.
    


## SYNOPSIS



           **/usr/local/lib64/sa/sa1 [ --boot | --rotate [ iso ] | --sleep |**
           _interval count_ **]**
    


## DESCRIPTION



           The **sa1** command is a shell procedure variant of the **sadc** command
           and handles all of the flags and parameters of that command. The
           **sa1** command collects and stores binary data in the current
           standard system activity daily data file.
    
           The standard system activity daily data file is named _saDD_ unless
           **sadc** 's option **-D** is used, in which case its name is _saYYYYMMDD_ ,
           where _YYYY_ stands for the current year, _MM_ for the current month
           and _DD_ for the current day. By default it is located in the
           _/var/log/sa_ directory.
    
           The _interval_ and _count_ parameters specify that the record should
           be written _count_ times at _interval_ seconds. If no arguments are
           given to **sa1** then a single record is written.
    
           The **sa1** command is designed to be started automatically by the
           **cron** command.
    


## OPTIONS



           **--boot** This option tells **sa1** that the **sadc** command should be
                  called without specifying the _interval_ and _count_ parameters
                  in order to insert a dummy record, marking the time when
                  the counters restart from 0.
    
           **--rotate [ iso ]**
                  Use this option to tell **sa1** to insert a record of
                  statistics to the standard _saDD_ system activity daily data
                  file of the previous day.  This should be done shortly
                  after midnight (on day DD+1) in order to make sure that the
                  data file covers the whole day, including the last interval
                  of time just before midnight.  Adding the **iso** keyword tells
                  **sa1** to use _saYYYYMMDD_ instead of _saDD_ as the standard
                  system activity daily data file name.
    
           **--sleep**
                  This option tells **sa1** that the **sadc** command should insert a
                  comment indicating that the system is entering or leaving
                  sleep mode (i.e. system suspend or hibernation).
    


## EXAMPLE



           To collect data (including those from disks) every 10 minutes,
           place the following entry in your root crontab file:
    
           **0,10,20,30,40,50 * * * * /usr/local/lib64/sa/sa1 1 1 -S DISK**
    
           To rotate current system activity daily data file, ensuring it is
           complete, place the following entry in your root crontab file:
    
           **0 0 * * * /usr/local/lib64/sa/sa1 --rotate**
    


## FILES



           _/var/log/sa/saDD_
           _/var/log/sa/saYYYYMMDD_
                  The standard system activity daily data files and their
                  default location.  _YYYY_ stands for the current year, _MM_ for
                  the current month and _DD_ for the current day.
    


* * *