*** UNIX MANUAL PAGE BROWSER ***

acctmerg(8) System Manager's Manual acctmerg(8) NAME acctmerg - Merges total-accounting files into an intermediary file or a daily accounting file SYNOPSIS acctmerg -[ahipv] [specification] -[tu] [file ....] FLAGS Produces output as ASCII records. Lists column headings. This flag im- plies -a but is effective with the -p or -v flags. Expects input files to have ASCII records that are converted to binary output records. Lists input but without processing. Produces a single record that con- tains the totals of all input. Summarizes by user ID rather than by user name. This is convenient when a single user ID is allocated to more than one user name. Produces output in ASCII, with more precise notation for floating-point values. DESCRIPTION The acctmerg command combines process, connect time, fee, disk usage, and queuing (printer) total-accounting records in tacct binary or tacct ASCII format (see the tacct structure in the acct.h file format for a description of this total-accounting format). The acctmerg command writes the results of record processing to standard output. The ac- counting file produced by the acctmerg command may have entries for as many as 18 columns. Column headings are printed only when you use the -h flag. The following table lists the column headings by number, the column heading by label, and the purpose of the entry: User ID. This is the integer value of the user ID from the /etc/passwd file. User login name. This is the alpha user login name from the /etc/passwd file. Prime-time CPU run time. This is the total time in seconds that prime- time CPU run time was charged to the user during the active accounting period. Nonprime-time CPU run time. This is the total time in seconds that nonprime-time CPU run time was charged to the named user. Prime- time memory K-core. This is a measure of memory usage during prime time. This value expresses the amount of memory used and the elapsed amount of prime time during which it was used (K-core is the product of total CPU time in minutes and mean size of memory used). Nonprime-time memory K-core. This is a measure of memory usage during nonprime time. Prime-time read and write characters. This is the total number of char- acters transferred during prime-time operation. Nonprime-time read and write characters. This is the total number of characters transferred during nonprime-time operation. Prime-time number of I/O blocks. This is the total number of I/O blocks transferred during prime-time read and write operations. The number of bytes in an I/O block is implemen- tation dependent. Nonprime-time number of I/O blocks. This is the to- tal number of I/O blocks transferred during nonprime-time read and write operations. Prime-time connect duration. This is the total num- ber of prime-time seconds during which a connection existed. Nonprime- time connect duration. This is the total number of nonprime-time sec- onds during which a connection existed. Disk blocks used. This is the total number of disk blocks used. Number of pages printed. This is the total number of pages queued to any printers in the system. Special fee charge units. This is the number of integer units to charge for any special fee. This value is the one supplied when the /usr/sbin/acct/chargefee command is processed during the active ac- counting period. Number of processes. This is the total number of processes spawned by the user during the active accounting period. Number of logins. This is the total number of times the user logged in during the active accounting period. Number of disk-accounting sam- ples. This is the total number of times during the active accounting period that the disk-accounting command was used to get the total num- ber of disk blocks listed in the DSK_BLOCKS column. When the value in the DSK_BLOCKS column is divide by this number, the average number of disk blocks used during the accounting period is obtained. Total accounting records are read from standard input and any addi- tional files (up to nine) you specify with the file parameter. File records are merged according to identical keys, usually the user ID and user login name. To optimize processing performance, output is written in binary, unless the -a or -v flag is used. Normally the acctmerg command is called from the runacct shell proce- dure, either to produce an intermediate file (/var/adm/acct/nite/daytacct, for example) when one or more source ac- counting files is full, or to merge intermediate files into a cumula- tive total (/var/adm/acct/sum/tacct, is another example). The cumula- tive total daily files are the source from which the monacct command produces an ASCII monthly summary file, which is written to the /var/adm/acct/fiscal subdirectory. The optional specification parameter allows you to select input or out- put column entries, as illustrated in Example 1. Field specifications are a comma-separated string of field numbers. Field numbers are refer- enced in boldface type in the first column of the foregoing list to- gether with their respective column headings. When you specify field numbers they should be listed in the order specified by the boldfaced heading reference numbers. Inclusive field ranges may also be specified, with array sizes properly taken into account except for the ta_name number of characters. For ex- ample, -h2-3,11,15-13,2 displays the LOGNAME (2), PRI_CPU (3), PRI_CON- NECT time (11), FEES (15), PRINT (14), DISK_BLOCKS (13), and again LOG- NAME (2), in that order, with the described column headings (-h). The default specification is to output all 18 columns (1-18 or 1-), which produces rather wide output records that contain all the available ac- counting data. Queuing system, disk usage, or fee data can be converted into tacct records with the acctmerge command, using the -i flag and the specifi- cation parameter. EXAMPLES To merge inclusive fields from an ASCII disk-accounting file called dacct into an existing total-accounting file named tacct as binary in- formation, but with entries for fields 1, 2, 13, and 18 only, enter the following line: acctmerg -i 1 -2,13,18 <dacct | acctmerg tacct >output The acctmerg command reads the columnar entries for UID (1), LOGNAME (2), DSK_BLOCKS (13), and DSAMPS (18) from the dacct file as input, merges this information as tacct binary records, and writes the result to standard output as ASCII. To repair file jan2.rpt in inclusive tacct columnar format, enter the fol- lowing initial command, edit the jan2.tmp file, and then enter the last command: acctmerg -v <jan2.rpt >jan2.tmp Edit jan2.tmp as desired.... acctmerg -i >jan2.tmp >jan2.rpt The first command redirects the content of file jan2.rpt to file jan2.tmp, with ASCII output and floating-point values. After you edit file jan2.tmp, the last command redirects file jan2.tmp as ASCII input to file jan2.rpt as output, with output records in binary. FILES Specifies the command path. Accounting header files that define for- mats for writing accounting files. This is where prime time is set. Intermediate daily total-accounting file. Cumulative total-accounting file. RELATED INFORMATION Commands: acct(8), acctcms(8), acctcom(8), acctcon(8), acctdisk(8), acctprc(8), fwtmp(8), runacct(8) Functions: acct(2) delim off acctmerg(8)