3.6.2 Options

-f full listing, lists selection on standard output (implies -i).

-i prints summary information at end of listing.

-l report location information.

-v verbose option, includes record images (implies -f).

-d limits selection by date.

-t limits selection by time. Uses 24-hour clock.

-u selects transactions for a particular user only.

-r selects transactions within the two locations you provide

-h num is the frequency with which header lines will be printed.

-e extracts selected section into a new log file.

If you do not specify any options on the command line, logutil acts as if "-i" were specified and prints only summary information.

Example #1

To list all records for a user named "randy" that were written on November 11th between 4:50 P.M. and 5:00 P.M. to a log file called "mylog", you would use the following command:

logutil -fu randy -d 11/11 -t 16:50 17:00 mylog

You will see something similar to the following report:


TY   PID      Term     Client     User     Date/Time         File ID    Filename

ST   21981    tty0     acucobol   randy    11/11 16:50:12
CB   21981    tty0     acucobol   randy    11/11 16:50:12
MA   21981    tty0     acucobol   randy    11/11 16:50:12               test.dat
OP   21981    tty0     acucobol   randy    11/11 16:50:12    07700001   test.dat
CE   21981    tty0     acucobol   randy    11/11 16:50:12
ST   21981    tty0     acucobol   randy    11/11 16:56:40
CB   21981    tty0     acucobol   randy    11/11 16:56:40
WR   21981    tty0     acucobol   randy    11/11 16:56:40    07700001
DE   21981    tty0     acucobol   randy    11/11 16:56:40    07700001
CE   21981    tty0     acucobol   randy    11/11 16:56:41
ST   21981    tty0     acucobol   randy    11/11 16:59:20
CB   21981    tty0     acucobol   randy    11/11 16:59:20
WR   21981    tty0     acucobol   randy    11/11 16:59:20    07700001
RE   21981    tty0     acucobol   randy    11/11 16:59:21    07700001
CE   21981    tty0     acucobol   randy    11/11 16:59:21


End of log.
Total Size                :     580 bytes
Number of Records         :     15
Mean Record Size          :     38 bytes
Number of Transactions    :     3
Mean Transaction Size     :     193 bytes
Record Version(s)         :     1

Note that, in a transaction log report, path and file names are limited to 17 characters without the "-l" option, or 21 characters with the "-l" option. Should the path and file name exceed that limit, the report will attempt to display all of the file name. If room permits, this will be followed by the file's parent directory, root directory, and subdirectories. Path name components that must be omitted will be represented by an ellipsis (three dots).

Example #2

To create a new log file called "newlog" that will contain the records reported above, use the "-e" option as follows:

logutil -u randy -d 11/11 -t 16:50 17:00 -e newlog mylog