Commands Reference, Volume 5

uucpadm Command

Purpose

Enters basic BNU configuration information.

The uucpadm command provides interactive entry and modification of basic BNU configuration information in the Devices, Systems, Permissions, Poll, and Dialcodes files in the /etc/uucp directory. You can use the uucpadm command repeatedly to adjust the same file.

When you enter the uucpadm command at the command line, the command displays a list of the files you can change. After you choose a file to modify, the command displays a vertical list of the names of the fields in that file. You can enter the appropriate entry in each field. When you press the Enter key, the cursor moves to the next field in the list.

The command uses a copy of a file to record changes. The original file remains unchanged until you press the Ctrl-U or Ctrl-X key sequence at the appropriate menu. You can exit to the main uucpadm menu at any time, without saving your changes, by using the Ctrl-D key sequence.

The help routine provides instructions for each data field. Enter a ? (question mark) in any menu field to access the help routine for that field.

Enter a ~ (tilde) in any field to enter an ASCII editor and edit the appropriate file for that field. The uucpadm command invokes the editor designated by the EDITOR environmental variable. If the EDITOR variable is not defined, the command invokes the vi editor.

If your entry for the first menu item matches an existing record, the uucpadm command retrieves that record for update. The command also tells you how many records have that first entry. If your entry for the first menu item does not match any existing record, the uucpadm command displays the word ADD at the top of the screen.

The uucpadm command checks the data as you enter it. If an inconsistency among the files is found, the command displays a warning message.

If the uucpadm command recognizes the entry you make for the first menu item, it fills in the default values for the remaining fields. For example, if you enter TCP as the Type in the Devices file menu, the command places a - (hyphen) in each remaining field for you. It also checks for consistency with other files and for processes that should be running on the system. For example, when you enter TCP as the Type in the Devices file menu, the uucpadm command checks to see if the uucpd daemon is running. If the daemon is not running, the command displays a note after the Type field, as follows:

Type: TCP
       <Note: Make certain uucpd is enabled.>
Line1: -

Note: The uucpadm command does not edit the /etc/uucp/Dialers file. Use an ASCII editor to edit this file.

Mode	File
rw	/etc/uucp/Devices
rw	/etc/uucp/Dialcodes
rw	/etc/uucp/Permissions
rw	/etc/uucp/Poll
rw	/etc/uucp/Systems

Examples

To start the uucpadm command, enter the following:
```
/usr/sbin/uucp/uucpadm
```
A menu listing the files you can change is displayed.
To make an entry to the /etc/uucp/Devices file, choose the Add/Change Uucp Devices option at the uucpadm menu. The following is a sample uucpadm screen defining a direct 9600 baud connection to system merlin over the tty3 device:
```
Type: merlin
line1: tty3
line2: -
class: 9600
dialers: direct
```
To make an entry to the /etc/uucp/Systems file, choose the Add/Change Uucp Systems option at the uucpadm menu. The following is a sample uucpadm screen defining the nostromo.aus.ibm.com system connected to an ACU device in class 2400:
```
Name: nostromo.aus.ibm.com
Time: Any
Type: ACU
Class: 2400
Phone: 997-7942
Login: nuucp
Password: gotcha
```
To change the /etc/uucp/Permissions file, choose the Add/Change Uucp Permissions File option at the uucpadm menu.
1. Following is a sample uucpadm screen defining a LOGNAME entry in the Permissions file:
```
L/M: LOGNAME=uucpz
Request: yes
Sendfiles: yes
Read: /
Write: NOWRITE=/etc
Callback:
Commands:
Validate: merlin:nostromo
```
  If the remote machine is merlin or nostromo, the login ID must be uucpz (VALIDATE option). Remote hosts using this ID can Request to send files, and the local host can Sendfiles as requested. Users with this ID can read all files with permissions granted to the others group, and can write to all files, except those in the /etc directory, with permissions granted to the others group.
2. Following is a sample uucpadm screen defining a MACHINE entry in the Permissions file:
```
L/M: MACHINE=merlin
Request: yes
Sendfiles:
Read: NOREAD=/etc
Write: NOWRITE=/etc
Callback:
Commands: ALL
Validate:
```
  The machine ID is merlin. Requests for file transfers can be made. The user can read all files and can write to all files except those in the /etc directory. The execution of all commands is permitted.
To make an entry in the /etc/uucp/Poll file, choose the Add/Change Uucp Poll File option at the uucpadm menu. Following is a sample uucpadm screen defining an entry in the Poll file:
```
System: merlin
Hours: 0 7 13 19
```
This entry instructs BNU to poll the merlin.aus.ibm.com system at 2400 hours (midnight), 700 hours (7 a.m.), 1300 hours (1 p.m.), and 1900 hours (7 p.m.).
To make an entry in the /etc/uucp/Dialcodes file, choose the Add/Change Uucp Dialcodes option at the uucpadm menu. Following is a sample uucpadm screen defining an entry in the Dialcodes file:
```
Abr: LA
Dialcode: 1-213-
```
This entry assigns LA as the abbreviation for the Los Angeles area code.

Files

/usr/sbin/uucp/uucpadm	Contains the uucpadm command.
/etc/uucp/Devices	Contains information about available devices.
/etc/uucp/Dialcodes	Contains dialing code abbreviations.
/etc/uucp/Dialers	Specifies initial handshaking on a connection.
/etc/uucp/Permissions	Describes access permissions for remote systems.
/etc/uucp/Poll	Specifies when BNU polls remote systems to initiate tasks.
/etc/uucp/Systems	Describes accessible remote systems.

Related Information

The uucp command, uuname command.

The uucheck command checks the /etc/uucp/Permissions file for correct configuration.

Example of a BNU Configuration for a Telephone Connection, Example of a BNU Configuration for a TCP/IP Connection, and Example of a BNU Configuration for a Direct Connection in AIX 5L Version 5.1 System Management Guide: Communications and Networks.

Understanding the BNU File and Directory Structure in AIX 5L Version 5.1 System Management Guide: Communications and Networks.

How to Configure BNU in AIX 5L Version 5.1 System Management Guide: Communications and Networks.