OSF

NAME

acctprc1, acctprc2, accton − Perform process accounting procedures

SYNOPSIS

acctprc1 [InFile]

acctprc2

accton [OutFile]

DESCRIPTION

The three acctprc commands, acctprc1, acctprc2, and accton, are used in the runacct shell procedure to produce process-accounting reports. 

acctprc1 [InFile]

The acctprc1 command is used to read records from standard input that are in a format defined by the acct structure in the /usr/include/sys/acct.h header file.  This process adds the login names that correspond to user IDs, and then writes corresponding ASCII records to standard output.  For each process, the record format includes the following 7 unheaded columns:

User IDThe user ID column includes both traditional and assigned user identification numbers listed in the /etc/passwd file. 

Login nameThe login name is the one used for the user ID in the /etc/passwd file. 

Prime time CPU time
The number of seconds the process consumed when exectuted during prime-time hours. Prime and nonprime-time hours are defined in the /usr/sbin/acct/holidays file. 

Nonprime-time CPU time
The number of seconds the process consumed when executed during nonprime-time hours.

CharactersTotal number of characters transferred. 

BlocksTotal number of blocks read and written. 

MemoryMean memory size (in kilobyte units). 

When specified, InFile contains a list of login sessions in a format defined by the utmp structure in the /usr/include/utmp.h header file. The login session records are sorted according to user ID and login name. When InFile is not specified, acctprc1 gets login names from password file /etc/passwd. The information in InFile is used to distinguish different login names that share the same user ID. 

acctprc2

The acctprc2 command reads, from standard input, the records written by acctprc1, summarizes them according to user ID and name, and writes sorted summaries to standard output as total accounting records in the tacct format (see the acctmerg command). 

accton [OutFile]

When no parameters are specified with the accton command, account processing is turned off. When you specify an existing OutFile file, process accounting is turned on, and the kernel adds records to that file. You must specify an Outfile to start process accounting. Many shell script procedures expect the file name /var/adm/pacct, the standard process accounting file. 

EXAMPLES

     1.To add a user name to each process-accounting record in a binary file and then write these modified binary-file records to an ASCII file named out.file, enter the following line to an accounting shell script:

/usr/sbin/acct/acctprc1  <  /var/adm/pacct  >out.file

A user name is added to each record. The raw data in the pacct file is converted to ASCII and added to file out.file. 

     2.To produce a total binary accounting record of the ASCII output file out.file produced in example 1, enter the following line to an accounting shell script:

/usr/sbin/acct/acctprc2 < out.file > /var/adm/acct/nite/daytacct

The resulting binary total accounting file, written in the acct format, contains records sorted by user ID. This sorted user ID file, is usually merged with other total accounting records when an acctmerg command is processed to produce a daily summary accounting record called /var/adm/acct/sum/daytacct. 

     3.To turn on process accounting, enter:

/usr/sbin/acct/accton /var/adm/pacct

     4.To turn off process accounting, enter:

/usr/sbin/acct/accton

FILES

/usr/sbin/acct/acctprc1
Specifies the command path.

/usr/sbin/acct/acctprc2
Specifies the command path.

/usr/sbin/acct/accton
Specifies the command path.

RELATED INFORMATION

Commands:  acct(8), acctcms(8), acctmerg(8), runacct(8)

Functions: acct(2)