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 implies -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  contains  the totals of all input.  Summarizes by user ID rather than by user name. This is convenient when a single user ID is allo-
       cated 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 com-
       mand writes the results of record processing to standard output. The accounting 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 characters transferred	during	prime-time  opera-
       tion.   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 implementation dependent.  Nonprime-time number of I/O blocks. This is the total number of I/O blocks transferred
       during nonprime-time read and write operations.	Prime-time connect duration. This is the total number of prime-time seconds during which a
       connection  existed.   Nonprime-time connect duration. This is the total number of nonprime-time seconds 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 accounting 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 samples. This is the total number of times during the active
       accounting  period  that  the disk-accounting command was used to get the total number 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 additional 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   procedure,   either  to  produce  an	intermediate  file
       (/var/adm/acct/nite/daytacct, for example) when one or more source accounting files is full, or to merge intermediate files into a  cumula-
       tive  total  (/var/adm/acct/sum/tacct,  is another example). The cumulative 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 output column entries, as illustrated in Example 1. Field specifications
       are  a  comma-separated	string	of  field numbers. Field numbers are referenced in boldface type in the first column of the foregoing list
       together with their respective column headings. When you specify field numbers they should be listed in the order specified  by	the  bold-
       faced 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
       example, -h2-3,11,15-13,2 displays the LOGNAME (2), PRI_CPU (3), PRI_CONNECT time (11), FEES (15), PRINT (14), DISK_BLOCKS (13), and  again
       LOGNAME	(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 accounting 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
       information, 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 following 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 formats 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), wtmpconvert(8).

       Functions:  acct(2).  delim off

																       acctmerg(8)