uulog Command

AIX Version 4.3 Commands Reference, Volume 5

uulog Command

Purpose

Provides information about BNU file-transfer activities on a system.

Syntax

uulog [ -x ] [ -Number ] [ -fSystem | -sSystem ]

Description

The Basic Networking Utilities (BNU) uulog command displays the contents of the log files containing the activities of the uucico and uuxqt daemons. Individual log files are created for each remote system with which the local system uses the uucp, uuto, and uux commands to communicate.

Use the uulog command to display a summary of uucp, uuto, and uux command requests by the user or by the system. All of these transactions are logged in files in the /var/spool/uucp/.Log directory. The files are named DaemonName/SystemName where the DaemonName directory is named for the daemon involved and the SystemName file is named for the remote system the daemon is contacting.

The uucp and uuto commands call the uucico daemon. The uucico daemon's activities are logged in the SystemName file in the /var/spool/uucp/.Log/uucico directory.

The uux command calls the uuxqt daemon. The uuxqt activities are logged in the SystemName file in the /var/spool/uucp/.Log/uuxqt directory.

You can examine these individual log files by issuing the uulog command directly. However, you can also have the BNU program automatically append these temporary log files to a primary log file that you can then examine. This is called compacting the log files and is handled by the uudemon.cleanu command, a shell script.

Flags

-fSystem	Issues a tail command with the -f flag on the file transfer log for the specified System variable, displaying the end of the log file. Press the Interrupt key to leave the file and return to the prompt.
-sSystem	Displays a summary of copy (uucico daemon) requests involving the specified system. Notes: System names can contain only ASCII characters. The -f and -s flags cannot be combined.
-x	Displays the uuxqt daemon log file for the given system.
-Number	Displays the last lines of the file. The number of lines is determined by the Number variable. (To display the lines, the uulog command issues a tail command with the -f flag for the specified number of lines.)

Examples

To display the uucico log file for system hera, enter:
```
uulog -shera
```
The output from the command is similar to the following:
```
uucp hera (10/30-10:18:38,3833,0) SUCCEEDED (call to  hera)
uucp hera (10/30-10:18:39,3833,0) OK (startup)
jim hera heraN661d (10/30-10:18:39,3833,0) REQUEST  
(nostromo!D.hera661e6c9 --> hera!X.heraN661d (jim))
jim hera heraN661d (10/30-10:18:40,3833,0) FAILED (CAN'T 
READ /var/spool/uucp/hera/D.hera661e6c9 13)
uucp hera (10/30-10:18:41,3833,0) OK (conversation  
complete -8)
```
The preceding lines log a conversation between the local system (nostromo) and remote system hera. The conversation began at 10:18:38 (a.m.) on October 30th, and ended at 10:18:41. User jim attempted to transfer a data file, D.hera661e6c9, to system hera. The connection to hera was successful, but the file could not be transferred because BNU could not read it.
To display the uuxqt log file, enter:
```
uulog -x
```
To display the last forty lines of the file transfer log for system zeus, enter:
```
uulog -fzeus -40
```

Files

/usr/bin/uulog	Contains the uulog command.
/var/spool/uucp/.Log	Contain the BNU log files.

Related Information

The tail command, uucp command, uudemon.cleanu command, uuto command, uux command.

The uucico daemon, uuxqt daemon.

Working with BNU Log Files in AIX Version 4.3 System Management Guide: Communications and Networks.