[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Commands Reference, Volume 5

Uutry Command


Contacts a specified remote system with debugging turned on and saves the debugging output in a temporary file.


Uutry-xDebugLevel ] [ -r ] SystemName


The Uutry command contacts a remote system, specified by the SystemName parameter, using debugging mode. Debugging mode provides a means of monitoring Basic Networking Utilities (BNU) connections to remote computers and file transfers.

The Uutry command starts the uucico daemon, which actually contacts the specified system. The uucico daemon produces debugging output that enables you to monitor the daemon's progress as it establishes the connection to the remote system, performs the remote login, and transfers a file.

The debugging output is scrolled on the screen of the local system. Once the system has finished displaying this information, press the Interrupt key to return to the prompt.

In addition to displaying the debugging output on the screen, the Uutry command directs this information to a file named /tmp/SystemName, where the SystemName parameter is the name of the remote system you are attempting to contact. Again, when the last of the output has been displayed, press the Interrupt key to return to the prompt.

The SystemName parameter, which is required, specifies the name of the remote system you wish to contact.

  1. Press the Interrupt key while the system is scrolling the output generated by the Uutry command to return to the prompt. The uucico daemon continues to place the debugging information in the /tmp/SystemName file.
  2. Either you must be in the /usr/sbin/uucp directory when you issue the Uutry command or you must issue the command with the full path name, /usr/sbin/uucp/Uutry.
  3. The Uutry command is a shell script stored in the /usr/sbin/uucp directory.


-r Overrides the default retry time. If for some reason the uucico daemon cannot complete the requested connection, the daemon waits for a set amount of time and tries again. The default retry time is 5 minutes.
Note: The time the remote system was last polled is recorded in the /var/spool/uucp/.Status/SystemName file.
-xDebugLevel Overrides the default amount of detail in the debugging information that the command displays on the screen. The valid range for the DebugLevel variable is 0 to 9, with a default of 5. Higher numbers cause the final report to be more detailed. If the -x flag is not used, the uucico daemon is started with the default level, which produces a moderate amount of information.


To change the amount of detail the Uutry command provides about the progress of the uucico operation, use the -x flag to specify a different debugging level. For example, entering:

/usr/sbin/uucp/Uutry -x9 venus

instructs the Uutry command to generate as much information as possible about the way in which the uucico daemon is working.


/tmp/SystemName Contains debugging output from the Uutry command (temporary file).
/usr/sbin/uucp/Uutry Contains the Uutry command and all the configuration files for BNU.
                          Contains information about available devices.
                          Contains dial-code abbreviations.
                          Specifies initial handshaking on a connection.
                          Describes access permissions for remote systems.
                          Describes accessible remote systems.
/var/spool/uucp/.Status/SystemName file
                          Lists the last time a remote system was contacted.
                          Contain the BNU public directories.

Related Information

The uucico daemon, uucpd daemon.

The tail command, uucp command, uustat command, uutry command, uukick command, uux command.

How to Monitor a BNU Remote Connection and How to Monitor a BNU File Transfer in AIX Version 4.3 System Management Guide: Communications and Networks.

Maintaining BNU, Understanding the BNU Daemons in AIX Version 4.3 System Management Guide: Communications and Networks.

[ Previous | Next | Contents | Glossary | Home | Search ]