unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



acctmerg(8)							  acctmerg(8)



NAME

  acctmerg - Merges total-accounting files into	an intermediary	file or	a
  daily	accounting file

SYNOPSIS

  acctmerg [-ahipv] [specification] [-tu] [file...]

OPTIONS

  -a [specification]
      Produces output as ASCII records.

  -h [specification]
      Lists column headings. This option implies -a but	is effective with the
      -p or -v options.

  -i [specification]
      Expects input files to have ASCII	records	that are converted to binary
      output records.

  -p [specification]
      Lists input but without processing.

  -t  Produces a single	record that contains the totals	of all input.

  -u  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.

  -v [specification]
      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 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	option.	The following table
  lists	the column headings by number, the column heading by label, and	the
  purpose of the entry:








  Column   Label		Purpose

  1	   UID

				User ID. This is the integer value of the
				user ID	from the /etc/passwd file.


  2	   LOGNAME

				User login name. This is the alpha user
				login name from	the /etc/passwd	file.
  3	   PRI_CPU

				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.
  4	   NPRI_CPU

				Nonprime-time CPU run time. This is the
				total time in seconds that nonprime-time
				CPU run	time was charged to the	named
				user.
  5	   NPRI_MEM

				Prime-time memory K-core. This is a meas-
				ure 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).
  6	   NPRI_MEM

				Nonprime-time memory K-core. This is a
				measure	of memory usage	during nonprime
				time.
  7	   PRI_RD/WR

				Prime-time read	and write characters.
				This is	the total number of characters
				transferred during prime-time operation.
  8	   NPRI_RD/WR

				Nonprime-time read and write characters.
				This is	the total number of characters
				transferred during nonprime-time opera-
				tion.
  9	   PRI_BLKIO

				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.
  10	   NPRI_BLKIO

				Nonprime-time number of	I/O blocks. This
				is the total number of I/O blocks
				transferred during nonprime-time read and
				write operations.
  11	   PRI_CONNECT

				Prime-time connect duration. This is the
				total number of	prime-time seconds during
				which a	connection existed
  12	   NPRI_CONNECT

				Nonprime-time connect duration.	This is
				the total number of nonprime-time seconds
				during which a connection existed.
  13	   DSK_BLOCKS

				Disk blocks used. This is the total
				number of disk blocks used.
  14	   PRINT

				Number of pages	printed. This is the
				total number of	pages queued to	any
				printers in the	system.
  15	   FEES

				Special	fee charge units. This is the
				number of integer units	to charge for any
				special	fee. This value	is the one sup-
				plied when the /usr/sbin/acct/chargefee
				command	is processed during the	 active
				accounting period.
  16

	    PROCESSES

				Number of processes. This is the total
				number of processes spawned by the user
				during the active accounting period
  17	   SESS

				Number of logins. This is the total
				number of times	the user logged	in during
				the active accounting period.

  18	   DSAMPS

				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 operand.	 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 option 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 cumulative 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 operand 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 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 exam-
  ple, -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 specif-
  ication 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 intotacct records
  with the acctmerge command, using the	-i option and the specification
  operand.

EXAMPLES

   1.  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  <&lt;dacct  |	acctmerg  tacct	 >&gt;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.

   2.  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  <&lt;jan2.rpt  >&gt;jan2.tmp

       Edit jan2.tmp as	desired....
	    acctmerg  -i  >&gt;jan2.tmp  >&gt;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

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

  /usr/include/sys/acct.h, /usr/include/utmp.h
      Accounting header	files that define formats for writing accounting
      files.

  /usr/sbin/acct/holidays
      This is where prime time is set.

  /var/adm/acct/nite/daytacct
      Intermediate daily total-accounting file.

  /var/adm/acct/sum/tacct
      Cumulative total-accounting file.

SEE ALSO

  Commands: acct(8), acctcms(8), acctcom(8), acctcon(8), acctdisk(8),
  acctprc(8), fwtmp(8),	runacct(8), wtmpconvert(8)

  Functions: acct(2)