DataMuseum.dk

Presents historical artifacts from the history of:

DKUUG/EUUG Conference tapes

This is an automatic "excavation" of a thematic subset of
artifacts from Datamuseum.dk's BitArchive.

See our Wiki for more about DKUUG/EUUG Conference tapes

Excavated with: AutoArchaeologist - Free & Open Source Software.


top - metrics - download
Index: T U

⟦10fb733a0⟧ TextFile

    Length: 38104 (0x94d8)
    Types: TextFile
    Notes: Uncompressed file

Derivation

└─⟦9ae75bfbd⟧ Bits:30007242 EUUGD3: Starter Kit
    └─⟦df3d31044⟧ »EurOpenD3/network/modems/telebit/UNIX.setup.Z« 
        └─⟦this⟧ 

TextFile

========================================================================================
Telebit Corporation                 Revision 1.02                          01 APRIL 1990
========================================================================================

			      TELEBIT MODEM CONFIGURATION
				    	 FOR
	 	UNIX DIAL-UP, UUCP, TCP/SLIP, AND POINT-TO-POINT PROTOCOL
				     ENVIRONMENTS

Written by C. E. Castillo, UNIX Communications Specialist, TELEBIT Corporation

This document is meant to simplify configuration of Telebit modems for use in UNIX 
dial-up and UUCP applications on a wide variety of systems.   The configuration hints and 
examples presented in this document are meant to supplement the system specific 
configuration guides available from TELEBIT, as well as the TELEBIT modem reference 
manuals.

Note that there are currently several configuration guides for specific systems.  These 
configuration guides are available from TELEBIT and UUNET Communications Services 
via the U.S. Internet.  The following networks and systems contain these documents as 
well:

	INTERNET:	UUNET.UU.NET			[192.48.96.2]

	EUNET:		MCSUN.EU.NET			[192.16.202.1]

	JUNET:		FTP.CS.TITECH.AC.JP		[131.112.16.39]

	ACSNET:		DITMELA.CNG.DIT.CSIRO.AU	[128.250.1.81]

Internationally, on the European network, EUnet; on the Japanese network, JUnet; and in 
Australia via ACSnet.  A listing of the archive is available by requesting the SETUPS.list 
or PRODUCTS.list files from TELEBIT and most of these systems via "anonymous" UUCP 
or FTP.  Documentation on warranty, upgrades, Data Communications protocols, and a 
technical overview of TELEBIT product technology are also available.

UUNET Communications Services makes these documents available via "anonymous" 
UUCP at 1-900-GOT-SRCS in the U.S..  This services is always available and carries a 
caller charge of $ .40 US per minute.

UNIX DIAL-UP
The first step in configuring a TELEBIT modem for use in either a UNIX dial-up or UUCP 
application is to connect to the modem through the system hardware and operating 
system.  It is not enough to use a dumb terminal to configure the modem and then attach it 
to the system.  While this may be the easiest method of configuration and integration of 
the modem, it does not provide for future maintenance and/or systems administrations 
capabilities.  It is highly recommended that the operating system be used to access the 
modem through the systems hardware.

Once this is accomplished, a login process (getty) can be established on the modem port 
to allow for dial-up interactive or UUCP usage.     
\f



1. THE HARDWARE
TELEBIT modems use a DB25 (female), RS-232C interface.  A modem cable comprised of 
two DB25 (one male and one male/female) connectors and 25 conductors end-to-end is 
usually required.  Some systems may have a DB9 connector on the serial I/O port with 
which a modem cable comprised of one DB25 (male) and one DB9 (male/female) must 
be used.  These cables are available (pre-assembled) in most computer supply and 
electronic parts stores or are supplied with the system.  DB9-to-DB25 cables are a 
standard cable that is also readily available.  Although a cable with conductors connecting 
the DB25/DB9 pins end-to-end is highly recommended, it may not always be possible.       
In pre-wired office or lab environments, a 25-conductor wire may not be available.     
In cases such as these, the modem cable may be modified to contain only the necessary 
conductors for modem use.  The following table contains RS-232C signals and their 
corresponding DB25/DB9 pin assignments: 

			RS-232C		DB25		DB9
			===================================
			TD		2		3
			RD		3		2
			RTS		4		7
			CTS		5		8
			DSR		6		6
			GND		7		5
			DCD		8		1
			DTR		20		4

In some cases, the modem cable may be reduced to a minimum of four conductors.  Full 
modem control necessitates the use of at least eight conductors.  If XON/XOFF flow control 
is enabled in the modem, the RTS/CTS signal leads may not be necessary, thus the 
conductors and corresponding pins may be removed.  If the system does not require 
status signals from the modem, the DSR and DCD signal leads may not be necessary, thus 
the conductors and corresponding pins may be removed.  Some systems may require 
cable modifications in order to provide special RS-232C signaling needed by the 
operating system.  In such cases, the RS-232C signals between the modem and the 
systems serial I/O ports may require re-routing.  If this is necessary, your system 
reference manuals or systems administrations manual may provide the correct modem 
cable configuration for your system.  The TELEBIT modem reference manuals also 
contain common and custom wiring diagrams.  An RS-232C break-out box may also be 
used to arrive at the final cable configuration.

2. USING THE OPERATING SYSTEM TO CONNECT TO THE MODEM
Once the proper cable has been used to connect your TELEBIT modem and system, the 
operating system must be set-up to connect to the modem via the system hardware.  The 
"tip" and/or "cu" commands are available in most UNIX systems to accomplish this.

The KERMIT share software from Columbia University is also highly recommended, 
when available, in order to by-pass problems caused by system configuration files.  
KERMIT does not require the same operating system device description files that "tip" 
and/or "cu" are dependent upon.  KERMIT's ability to attempt the use of the targeted 
modem port may result in the most immediate use of the modem.  Error messages 
generated by the KERMIT software may also allow for better diagnosis of operating 
system or hardware problems related to the host systems inability to operate at high 
baud rates or possible cable configuration problems.       
\f



NOTE:	Not all systems may be capable of using serial I/O port speeds
	at or above 9600 bps.  Some systems may require operating 
	system or hardware modifications.  Please refer to you systems
	manual or manufacturer for assistance if this is so.  It is highly         
	recommended that TELEBIT modems be connected to the serial I/O
	ports of the system cpu.  Use of serial I/O multiplexors may limit
	modem speed to 9600 bps or lower due to flow control, cpu/bus 
	interrupt, or memory buffering problems.

USING TIP
In systems where the "tip" command is available for connecting to serial I/O ports, the 
following entries to the /etc/remote file may be used as guidelines (all characters are 
literal, i.e. the ^ is 'shift 6' on most keyboards):

	tb9600:dv=/dev/TTTT:br#9600:el=^C^S^Q^U^D:ie=%$:oe=^D: 
	tb19200:dv=/dev/TTTT:br#19200:el=^C^S^Q^U^D:ie=%$:oe=^D:

The following /etc/remote may be used for autodialing:

Note:	Register X0 should be set when using this feature.

	TELEBIT|Autodial TELEBIT:\
		:el=^D^U^C^S^Q^O@:du:at=hayes:ie=#$%:oe=^D:br#SSSSS:\		   
		:pn=NNNNNNN:dv=/dev/TTTT:

Where:          TTTT		=	serial I/O port (tty)
		SSSSS		=	baud rate [9600/19200]
		NNNNNNN		=	phone number

A direct connection to the modem or autodial is achieved by issuing the following 
command:

	tip tb9600		or		tip hostname

NOTE:	Some systems may require an entry in L-devices (or Devices) that corresponds 
	to the serial I/O port used in the /etc/remote entry.  Please see the following 
	section on entry guidelines for this file.     

USING CU
In systems using the "cu" command to access the serial I/O ports, the/usr/lib/uucp/L-
devices (or /usr/lib/uucp/Devices) contain the required serial I/O port definitions 
needed to access a direct connection.  The following examples may be used as entry 
guidelines for these files:

	DIR tty000 0 9600

			or 		

	Direct tty000 - 9600 direct
\f



A direct connection to the modem is achieved by issuing the following command:

	cu -s 9600 -l /dev/tty000

			or

	cu -s 9600 -l /dev/tty000 dir

If the modem can not be accessed through the operating system, there may be a cable or 
serial I/O port problem or operating system problem.  Be sure to check for processes 
occupying the targeted serial I/O port or lock files (see section 4  on HDB UUCP).  A good 
test of the serial I/O port-to-modem connection is to list the contents of an ASCII file and 
re-direct the output to the modem port.  Create an ASCII text file comprised of 
alphanumeric characters (no special characters or metacharacters).   This file should 
be be about fifty lines in length.  Place the modem where the TD and RD lights on the 
front panel are visible to you as you type.  While monitoring the TD and RD lights on the 
modem, execute the following command:

	cat ascii.file > /dev/tty &

If the TD and RD lights do not register the data passing through the modem, it is possible 
that the wrong serial I/O port name is being used, the port permissions may be set 
wrong, a LCK..tty000 may exist in /usr/spool/locks or /usr/spool/uucp, a serial I/O 
port problem may be present, or a cable problem may exist.  The DTR light should also 
be lit as data passes through the modem.  Note any error messages printed to the console 
for possible clues as to the problem and for use when referencing the problem to a UNIX 
Technical Support group.  The "&" places the processing of this command in the 
background.  Should this command hang or lock-up, a "kill -9 proc_num" may be done to 
cancel the command.
 
3. MODEM CONFIGURATION
Contrary to popular belief, there are only 70 to 75 configurable S-registers in a 
TELEBIT modem.  Only a dozen of these registers are required to configure the modem for 
use in a UNIX dial-up or UUCP environment.  TELEBIT modems are most easily 
understood when they are divided into  two parts.  One half of the modem being the RS-
232C serial I/O port interface and the other half, the RJ11/RJ45 PSTN (phone line) 
interface.     
\f



THE SERIAL I/O PORT RS-232C INTERFACE
The following table lists registers which define the RS-232C serial I/O port interface:

	S-REGISTER		DESCRIPTION
	=================================================================
	S48			Eight Bit Comparison
	S51			Interface Speed
	S52			DTR Interpretation
	S53	*		DCD & DSR Interpretation
	S54			Break Signal Interpretation
	S55			Escape Char./Seq. Interpretation
	S56			XON Character
	S57			XOFF Character
	S58			Flow Control used by DTE
	S64			Dial/Answer Sequence Abort
	S65			XON/XOFF Failsafe
	S66			Lock Interface Speed
	S67			CTS Interpretation
	S68			Flow Control used by DCE
	S69			XON Signal Handling
	S130	*		DSR Interpretation
	S131	*		DCD Interpretation
	S150			Asynchronous/Synchronous Mode Selection

* = New releases of modem firmware are made to be backwards compatible with 
previous releases.  If an "S" register is missing, the feature has either been removed or 
the old register number maps to a new one(s).  An "ERROR" message should not result 
from using re-mapped registers.

THE RJ11/RJ45 PSTN (PHONE LINE) INTERFACE
The following table lists registers which define the RJ11/RJ45 PSTN interface:

	S-REGISTER		DESCRIPTION
	=================================================================
	S0			Answer On Ring Number
	S7			Wait For Carrier Time
	S9			Carrier Detect Time (slow mode)
	S10			Carrier Loss To Detect Time (slow mode)
	S41			Inactivity Timer
	S50			Transmission Mode (PEP/V.32/V.22bis/...)
	S90			CCITT/BELL Mode Select (bell212a/V.22)
	S91			Guard Tone Selection (V.22 only)
	S92			Answer Sequence Selection (PEP/9600/...)
	S94			Transmission Speed Negotiation (fallback)
	S95			MNP Operating Mode (MNP4 or 5)
	S96			MNP Data Compression Enable (MNP5)
	S110			PEP Mode Data Compression Enable (Lempel-Ziv)
	S121			Echo Suppression Compensation
\f



MODEM TO SYSTEM INTERFACE
The remainding registers are used to set the dialog and enable features to be used between 
the modem and system: 

	S-REGISTER		DESCRIPTION
	=====================================================================
	En			Echo ON/OFF       
	Mn			Speaker ON/OFF        
	Qn			Quiet Enable        
	Vn			Verbose ON/OFF        
	Xn			Result Code Basic/Extended     
	S45			Remote Access Enable     
	S61			Speaker Volume     
	S100			Reverse Answer/Originate Mode        
	S101			Continuous Answer/Originate (leased line)        
	S104			Automatic Dialing Options        
	S105			T/D (talk/data) Switch Enable     
	S111			Asynchronous Protocols Support        
	S112			Kermit Mark Character 
\f



EXPLANATION OF TYPICAL REGISTER SETTINGS:
Please use the chart below to select the most appropriate options for your UNIX 
environment and application.

RESPONSE FLAGS
==========================================================================================
Q6 		For Dial-in -- modem result codes may cause a getty battle.

X1		In HDB, it doesn't matter.      In BSD, X0 is set in L.sys and /etc/remote.

S-REGISTERS
==========================================================================================
S45		"security" demands 0, debugging demands 255.
     
S50		Most cases set S50=0.  If the other modem has S92=1, set your modem to
		have S50=255 to send only PEP tones.
     
S51		For autobauding, use either S51=255 or 254 and an -- A-pause-A-
		pause-A-pause .     .     .       works every time.  255 presents data at 
		9600 bps for inbound calls.  254 presents data at 19200 bps for inbound 
		calls.  It is best to use a "hard set" baud rate (ie S51=5).     

S52		Recommend value of 2 (reset modem when DTR drops)

S53		Recommend value of 3 (System V HDB systems may need 1 or 4).  This 
		register maps to S130/S131 when not listed in modem.     

S54		Recommend value of 3 (see modem reference manual)

S58		Sets flow control.  S58=2 (RTS/CTS) is recommended, when possible.       
		S68=255 should also be set.  S68=3 may be used whenever S58=0 for 
		flow control during interactive use.     

S61		Volume of speaker.  If it's an office environment, try a value of 45.  If 
		machine room, try 200.     

S66		S66=1 locks the interface speed and uses flow control for non-PEP 
		modems.  Hard setting the interface speed to 9600  or 19200 with
		S66=1 is highly recommended.     

S92		If low speed modems are also dialing in, set S92=1.  Incoming PEP modem 
		should have S50=255 set.      

S110		If you are sending/receiving text, set S110=1 to enable data compression.      
		Otherwise, if sending news or binary files that are uncompressible (or 
		pre-compressed), leave compression off by setting S110=0.     

S111		Use S111=30 or 255.  At least one modem must have 30 for UUCP
		protocol support.     
\f



CONFIGURATIONS FOR BSD4.2, BSD4.3, AND SYSTEM V UNIX SYSTEMS
Below is a chart of the factory settings, along with typical BSD and SYSTEM V settings.  
Registers not shown are to be left at the factory settings:

REG	FACT	BSD4.2	BSD4.3	HDB		DESCRIPTION			
==========================================================================================
Ex	E1	E0		E0		E0		Echo ON/OFF      
Mx	M1	M1		M1		M1		Speaker ON/OFF      
Qx	Q0	Q4		Q4		Q6		Quiet Enable
Vx	V1	V1		V1		V1		Verbose ON/OFF
Xx	X1	X1		X0		X3		Result Code Basic/Extended
S45	000	255		255		255		Remote Access Enable 
S50	000	000		000		000		Transmission Mode
S51	255	005		005		005		Interface Speed
S52	000	002		002		002		DTR Interpretation
S53	000	001		003		000		DCD & DSR Interpretation  *
S54	000	003		003		003		Break Signal Interpretation
S55	000	000		000		000		Escape Char./Seq. Interp.
S56	017	017		017		017		XON Character
S57	019	019		019		019		XOFF Character
S58	003	000		000		002		Flow Control used by DTE
S130	002	002		004		002		DSR Interpretation  *
S131	002	001		001		003		DCD Interpretation  *
S64	000	000		000		000		Dial/Answer Sequence Abort
S65	000	000		000		000		XON/XOFF Failsafe
S66	000	001		001		001		Lock Interface Speed
S67	000	000		000		000		CTS Interpretation
S68	255	003		003		255		Flow Control used by DCE
S90	000	000		000		000		V.22 Emulation Mode Enable
S91	000	000		000		000		Guard Tone Selection
S92	000	000		000		000		PEP tones before slow tones
S95	000	000		000		000		MNP Error Correction
S96	001	001		001		001		MNP Data Compression
S110	255	255		255		255		Data Compression (PEP)
S111	255	030		030		030		Protocol Support
S112	001	001		001		001		Kermit Mark Character

* = New releases of modem firmware are made to be backwards compatible with 
previous releases.  If an "S" register is missing, the feature has either been removed or 
the old register number maps to a new one(s).  An "ERROR" message should not result 
from using re-mapped registers.


	NOTE:	Set S50=255 when calling UUNET Communications Services for
		UUCP use.  S92=1 is set on ALL UUNET-TELEBIT modems.
\f



4. DEFINING THE DIAL-IN PORT CHARACTERISTICS (GETTY/STTY)
Once a direct connection to the modem through the operating system is operational and 
the modem registers are configured for your system and use, the dial-in port 
characteristics can be defined.  These definitions can be altered upon succesful login by 
using the "stty" command which is standard to all UNIX systems..

The port on which the modem will be connected should be configured to run at either 
9600 or 19200 bps.  Use hardware (RTS/CTS) flow control where possible.  Use 
software XON/XOFF flow control if RTS/CTS isn't available.  Make sure that the flags in 
/etc/gettydefs (or /etc/gettytab) look something like:

19200m # B19200 CS8 ECHO IXON IXOFF HUPCL # B19200 CLOCAL IXON IXOFF IXON IXOFF 
TAB3 BRKINT OPOST ONCLR CS8 ISIG ICANON ECHO HUPCL #login: #19200m

	(note that the above should be entered as ONE line of data)

				or

			z|std.19200|19200-baud:\
				:sp#19200:


The use of a rotary or autobaud in getty is not recommended due to the modems ability to 
lock interface speed (S66=1).  The modem can then arbitrate a slow modem connection 
to the hard-set interface speed without the need for interface speed matching.  You should 
modify the baud rate entries to 9600 if your system only supports 9600 bps.  In some 
systems this entry may be called "EXTA" or something similar.  Keep in mind that every 
system may have slightly different names for the flags.

If you do use a rotary or autobaud getty entry, don't forget to set the getty up to include 
19200 in its cycle.  You may have it trying 19.2 first and moving to 2400 on the first 
receipt of a break signal and to 1200 on the second receipt of a break.  The order of the 
cycle is not important so long as the calling system knows to send breaks until it sees the 
login sequence.  
\f



5. ESTABLISHING A LOGIN PROCESS (GETTY)
The getty is established on the modem port by editing the /etc/ttys, /etc/ttytab, or 
/etc/inittab in order to add the modem port settings (described above) and to enable the 
getty.

BSD UNIX GETTY
These entry samples may be used in either the /etc/ttys or /etc/ttytab files to enable 
the modem port getty:

					1zttya

				    	  or

	name    getty                           type     status   comments
	ttya    "/usr/etc/getty std.19200"     	dialup   on       secure

The process does not execute until "init" is restarted to include the new process.  This is 
accomplished by issuing the command:

	kill -1 1

The new process (getty) may be verified by using the "ps" command.

SYSTEM V GETTY
This entry sample may be used in the /etc/inittab file to enable the  modem port getty:

	00:2:respawn:/etc/getty	 tty00	19200m

The process does not execute until "init" is restarted to include  the new process.  This is 
accomplished by issuing the command:

	init q

	or

	telinit q

The new process (getty) may be verified by using the "ps" command.

       NOTE:	It is highly recommended that /etc/getty be used instead of 
		/usr/lib/uucp/uugetty, due to various problems reported
		in the use of uugetty.  The use of getty instead of uugetty does
		not prevent the modem port for dial-in and dial-out use.
		When getty is used on the modem port, the system init levels
		should be used to stop and restart the getty as needed for dial-out
		purposes.  The following script give an example of how this may
		be done:

		#! /bin/sh
		init 3
		chmod 666 /dev/tty
		cu -s 19200 -l /dev/tty (or uucico -r1 -x9 -ssys)
		init 2
\f



UUCP
Configuration of UUCP consists of additions and modifications to the UUCP files contained 
in /usr/lib/uucp or /etc/uucp.  There are two UUCP environments available in BSD 
UNIX systems.  These environments are Version2 UUCP and HoneyDANBER (HDB) UUCP.  
HoneyDANBER is native to SYSTEM V UNIX, but may also be found in some BSD UNIX 
systems.  Version2 UUCP is found only in BSD UNIX systems.  SYSTEM V UNIX has only 
one UUCP environment, HDB.  Each environment has different file names, but basically 
the same workings in the execution of a UUCP session utilizing the "uucico" command.

When working with UUCP, we have found the most useful resource for UUCP information 
has been the book "Managing UUCP and Usenet", published by O'Reilly & Associates.  The 
book can be ordered directly from O'Reilly by calling their toll-free number, 1-
(800)-338-6887 USA or 1-(800)-533-6887 CA.  Their direct numbers are 1-
(707)-829-0515 and 1-(707)-829-0104 FAX.  The book costs $21.95 (US) and 
may save you hours of time when installing and troubleshooting your UUCP.  These books 
are also available from UUNET Communications Services at 1-703-876-5050.

"Managing UUCP and Usenet" covers both standard BSD and SYSTEM V UUCP.  It is highly 
recommended for both novices to the UUCP environment and experienced UUCP System 
Administrators.

Use the guidelines below as a starting point.  Realize that many slight variations in UUCP 
behavior may require you to modify these instructions for your application.

NOTE:	Not all systems may be capable of using serial I/O port speeds
	at or above 9600 bps.  Some systems may require operating system
	or hardware modifications.  This includes the ability of UUCP
	(ie uucico) to function properly at 19200 bps.  Please refer to
	your systems manual or manufacturer for assistance if this is so.
	It is highly recommended that TELEBIT modems be connected to the
	serial I/O ports of the system cpu.  Use of serial I/O multiplexors
	may limit modem speed to 9600 bps or lower, when using UUCP,
	due to flow control, cpu/bus interrupt, or memory buffering problems.     
\f



VERSION2 UUCP

1. MODIFY /usr/lib/uucp/L-devices (or /etc/uucp/L-devices)
The L-devices file contains information that describes what types of devices the system 
has available for use in dialing other systems, and identifies the port(s) they are 
connected to.  It also contains information about baud rate, and may also contain 
instructions for the modem on how to dial, or what dialer script (or program) to use.

If you are running BSD or XENIX UUCP, you may need to modify the dialer for use with 
TELEBIT modems at high speeds.  A good starting point is usually the Hayes dialer, either 
in script form or the program form.  The dial program may be called "hayes", or 
"hayestone".

If you have SCO XENIX, contact SCO Technical Support and ask for theTELEBIT utilities 
(on 5 1/4" or 3.5" floppy).  These are available for SCO XENIX releases needing the 
"dialTBIT" dialer and new versions of the "uucico" and "cu" programs that have been 
enhanced to run at 19200 bps.  This is not necessary for SCO UNIX 3.2 systems.

If you think that your computer may need enhancements in order to run UUCP at high 
speeds, contact your vendor's Technical Support line for such information.

Some examples of these entries are given below.  Your system entries may appear 
slightly different.  Use the guidelines below as a starting point.

- ACU entries are for automatic dialing (using L.sys entries).
- DIR entries are usually associated with "direct" connections from "cu" or "tip". 
- Modify the port number for the appropriate modem port on your system.
- Use a standard dialer such as "hayes" or "hayestone" where available.
- Use a custom dial program such as "dialTBIT" in XENIX.
- Use "A\dA\dA\d" to synchronize the modem to different speeds when autobauding on
  outgoing calls, if necessary.
- Set S50 to the appropriate speed when dialing out at low speeds, if necessary.

	EXAMPLE 1: /usr/lib/uucp/L-devices (XENIX, BSD 4.2 and 4.3 UUCP):

	ACU tty1A /usr/lib/uucp/dialTBIT 19200
	DIR tty1A 0 19200

			or

	ACU cua0 cua0 19200
	DIR cua0 0 19200
\f



2. MODIFY /usr/lib/uucp/L.sys (or /etc/uucp/L.sys)
The only changes most systems require are to increase the baud rate from 1200 or 
2400 up to 9600 or 19200.  Everything else in the chat script should remain the same.  
Below is a typical L.sys entry, including the chat script.  Do not copy this literally.  
Modify the information for your application:

hostname Any ACU 19200 NNNNNNNNNN  ogin:--ogin: Usysname ssword: XXXXXXXX

NOTES:
hostname		=	THEIR System name
NNNNNNNNNN		=	THEIR System phone number
Usysname		=	Your UUCP account on THEIR machine
XXXXXXXX		=	Your UUCP passwd on THEIR machine

The "chat" script is the most common point of wasted connection time and login failure.  
Be sure to test this entry rigorously to verify a successful login in the fastest time 
possible.

3. TEST UUCP
UUCP can now be tested by issuing the following commands.  The debugging level can be 
either -x4 or -x9:

	/usr/bin/uucp -r1 test.file testhost\!/test.directory	[queue file transfer]

	/usr/lib/uucp/uucico -r1 -x4 -stesthost			[start file transfer]

Upon success or failure of the UUCP session, the status file must be removed before 
another UUCP session can be started with the above command:

	rm /usr/spool/uucp/STST.testhost

It is also possible that a "lock" file may continue to exist if the process was aborted or 
did not complete execution properly.  The following commands may be used to remove the 
"lock file before the next UUCP session is started:

	rm /usr/spool/locks/LCK..tty00

			or

	rm /usr/spool/uucp/LCK..tty00
\f



HONEYDANBER UUCP

1. MODIFY /usr/lib/uucp/Devices
The Devices file contains information that describes what type of devices the system has 
available for use in dialing other systems, and identifies the port(s) they are connected 
to.  It also contains information about baud rate, and may also contain instructions to the 
modem on how to dial, or what dialer script (or program) to use.

Some examples of these entries are given below.  Your system entries may appear 
slightly different.  Use the guidelines below as a starting point.

- ACU entries are for automatic dialing (using Systems entries).
- DIR entries are usually associated with "direct" connections from "cu".
- Modify the port number for the appropriate modem port on your system.
- Use a standard dialer such as "hayes" or "hayestone" where available.
- Use a custom dial script such as "tbfast" in HoneyDANBER .
- Use "A\dA\dA\d" to synchronize the modem to different speeds when autobauding on
  outgoing calls, if necessary.
- Set S50 to the appropriate speed when dialing out at low speeds, if necessary.

	EXAMPLE 2: /usr/lib/uucp/Devices

	ACU ttyxx - 2400 tb2400
	ACU ttyxx - 9600 tbfast
	ACU ttyxx - 19200 tbfast
	DIR ttyxx - 19200 direct

2. MODIFY /usr/lib/uucp/Dialers
The following example entries may be used in the Dialers file:

	tb2400   =W-,    "" A\pA\pA\pT OK ATS50=3DT\T CONNECT\s2400
	tbfast      =W-,    "" A\pA\pA\pT OK ATS50=255DT\T CONNECT\sFAST

You should have no trouble dialing out at any speed.

3. MODIFY /usr/lib/uucp/Systems
The only changes most systems require are to increase the baud rate from 1200 or 
2400 up to 9600 or 19200.  Everything else in the chat script should remain the same.  
Below is a typical System entry example, including the chat script:

hostname Any ACU 19200 NNNNNNNNNN  ogin:--ogin: Usysname ssword: XXXXXXXX

NOTES:

hostname		=	THEIR System name
NNNNNNNNNN		=	THEIR System phone number
Usysname		=	Your UUCP account on THEIR machine
XXXXXXXX		=	Your UUCP passwd on THEIR machine

The "chat" script is the most common point of wasted connection time and login failure.  
Be sure to test this entry rigorously to verify a successful login in the fastest time 
possible.
\f



4. TEST UUCP
UUCP can now be tested by issuing the following commands.  The debugging level can be 
either -x4 or -x9:

	/usr/bin/uucp -r test.file testhost\!/test.directory	[queue file transfer]

	/usr/lib/uucp/uucico -r1 -x4 -stesthost			[start file transfer]

Upon success or failure of the UUCP session, the status file must be removed before 
another UUCP session can be started with the above command:

	rm /usr/spool/uucp/.Status/testhost

It is also possible that a "lock" file may continue to exist if the process was aborted or 
did not complete execution properly.  The following commands may be used to remove the 
"lock file before the next UUCP session is started:

	rm /usr/spool/locks/LCK..tty00

			or

	rm /usr/spool/uucp/LCK..tty00

You should now be able to run UUCP between two machines attached to yourmodems just 
as you always have with slower modems.  Typical throughputs should be in the range of 
10Kbps to 16K bps (1000 to 1600 cps).  Enjoy the new world of of high speed UUCP "g" 
protocol file transfer.
\f



TCP/SLIP
Serial Line Internet Protocol (SLIP) was developed and distributed for Berkeley 4.3 
BSD (Berkeley Standard Distribution) systems.  This program allowed the network 
routing code to send any IP packet through a serial port as opposed to an ethernet port.  
The profound difference was performance.  Ethernets run typically at 10 megabits per 
second as opposed to typical top speeds of 19.2K bps (bits per second) on asynchronous 
serial ports.  Nevertheless, it works.

TCP and IP are two cooperating methods that work together to encapsulate data for 
passage across a network.  Just like placing a letter in an envelope, the receiver may 
discard the envelope after safely receiving the contents.  The envelope served only to 
transport the contained information.

Likewise, applications in a network environment become the senders and  receivers of 
electronic letters packaged in TCP/IP envelopes.  These applications, FTP (File Transfer 
Protocol), SMTP (Simple Mail Transfer Protocol), TELNET (virtual terminal emulation 
access across the network), PING (a "hello" message to any host on the net to validate its 
healthy presence), RLOGIN (similar to TELNET providing remote login to other host 
computers on the net), RCP (similar to FTP providing file transfer to other host 
computers on the net) and many others, all envelope their cross-net traffic inside 
TCP/IP envelopes.

TCP's contribution to the data envelope is 20 bytes of overhead.  Likewise IP contributes 
its own 20 bytes.  SLIP prepends and appends another 2 bytes for a grand total of 42 
bytes of overhead.  FTP file transfers, today, run well with TELEBIT modems achieving 
12,000-14,000 bps throughput.  This is true for all bulk data applications.

However, a problem arises when interactive terminal emulation  applications like 
RLOGIN or TELNET operate.  When running a TELNET or RLOGIN session, that is simply 
typing on a screen to a host somewhere on the network, each character typed is enveloped 
in 42 bytes and mailed to the remote machine.  When running across a 10 megabit per 
second ethernet (the medium this whole process was designed for) enduring that much 
overhead is not elegant, however, it is functional.  At 9600 bps on a high-speed modem, 
the overhead is impeding.

TELEBIT Micro-short packets potentially hold about 10 data bytes.  Once the first ten 
bytes of a TCP/SLIP packet fill the first micro-short modem packet, the modem builds a 
256 byte long packet to house the following plus or minus 32 bytes.  This inefficiently 
stuffed packet travels the link consuming unnecessary transmission time.  The action of 
sending packets back and forth causes the modem to thrash between micro-short and long 
packets and the resulting interactive TCP/SLIP performance is poor.

These interactive applications currently run with about a 1.2 to 2.0 second round trip 
character echo delay.  This interactive performance is unacceptable.  Nevertheless, 
many TELEBIT modem users are today running SLIP.  The resources available through 
TCP/SLIP are forcing them to accept the unacceptable.

TELEBIT modems do not contain TCP/SLIP or Point-to-Point Protocol protocol support.  
As stated above, these protocols consist of rather large datagrams which make the use of 
high-speed modems a necessity.
\f



POINT-TO-POINT PROTOCOL
Point-to-point circuits in the form of asynchronous and synchronous lines have long 
been the mainstay of data communications. Even with the growing popularity of local 
area networks, wide area connections are still made using various point-to-point 
circuits.  Over time the data link levels used have settled to a few standards.  However, 
the method use of the data link by upper level protocols, such as IP, has been largely 
implementation dependent.  This resulted in requiring a single vendor's equipment for 
both ends of a point-to-point circuit.

The Point-to-Point Protocol (PPP) seeks to remedy this problem by proposing a 
standard method of encapsulating IP datagrams, as well as other network layer protocol 
information, over point-to-point links.  PPP also specifies  the means for line and 
protocol operation and maintenance by providing the means for testing and configuring 
the line and each of the upper level protocols.  PPP is designed to be easily extensible for 
adding new protocols and features.

PHYSICAL LAYER
PPP is capable of operating across virtually any DTE/DCE interface.  The most common 
examples of interfaces are RS-232-C, EIA RS-423 and CCITT V.35.  The only absolute 
requirement for PPP is that a duplex circuit be provided.  While control signals are not 
required for the use of PPP, it should be recognized that they do add functionality and it 
is recommended that they be fully utilized when they are available from the interface.

DATA LINK LAYER
PPP specifies for synchronous and asynchronous circuits ISO that 3309-1979 as 
modified by ISO 3309:1984/PDAD1 be used.  The framing specified by this document is 
more commonly known as HDLC and the 1984 addendum defines HDLC for  asynchronous 
circuits.  PPP describes the values to be used in the standard HDLC fields and adds a 
protocol field to indicate for which protocol the data is destined.  There are three major 
types of protocols, link control, upper level protocol control, and upper level protocol 
data.

TELEBIT MODEM CONFIGURATION FOR POINT-TO-POINT CIRCUITS
Configuring a TELEBIT modem for use in a BSD4.3 TCP/SLIP, Compressed TCP/SLIP 
(TCP/CSLIP; BSD4.4), or Point-to-Point Protocol (PPP RFC 1134) application is 
merely a case of configuring the modem to behave exactly like a direct RS-232c cable 
connection between the two host systems in the circuit.  That is, NO FLOW CONTROL!  
Hardware flow control (EIA or RTS/CTS) is recommended where supported by the host 
system.  The following S-register settings should accommodate most point-to-point 
circuit set-ups:

	S-REGISTER		SETTING			DESCRIPTION
	=================================================================
	S58			000			No Flow Control.  S68=255 also.
							S58=2 For RTS/CTS.  Optional.
	S50			XXX			Modulation.  S50=255 is PEP
							S50=6 is V.32.  Optional.
	S66			001			Lock Interface Speed.
	S95			XXX			MNP Error Correction or Data
							Compression (4/5) for V.32.  
							Optional.
	S110			XXX			PEP Data Compression.  Optional.
\f



AUTODIALING
The S104 register is used to cause the modem to go off-hook and dial one of the first two 
telephone numbers in the modem telephone number directory.  The number dialed is 
dictated by the position of the A/B switch on the front of your TELEBIT modem (post-
1989 models).  The following example is meant to illustrate the flexibility of this 
feature, as well as that of modem modulation usage in the set-up of a point-to-point 
circuit:

BANK A:		AT  S50=255  S52=2  S58=0  S66=1 S95=2  S104=1  S110=1 &W1

		ATN0=nnnnnnn\TELEBIT_PEP_SLIP

BANK B:		AT  S50=6  S52=2  S58=0  S66=1 S95=2  S104=1  S110=1 &W2

		AT  N1=nnnnnnn\TELEBIT_V.32_SLIP

Where BANK A is configured to dial the telephone number stored at location N0: in the 
modem and establish a compressed PEP connection with the remote TCP/SLIP host upon a 
OFF-to-ON transition of DTR.  This enables the modem to automatically dial the remote 
TCP/SLIP host system as soon as DTR is raised (DTR "ON") on the modem port by the 
execution of a SLIP attach command (slattach) on the originating TCP/SLIP system.  The 
need for a "tip" or "cu" process in order to affect dialing is eliminated.

The settings in BANK B accomplish this same task with the exception using V.32 
modulation with MNP to establish the TCP/SLIP link.  The telephone number in location 
N1: could be the same or different from that of BANK A.

The A/B switch can now be used to set-up two distinct point-to-point circuits or one 
point-to-point circuit with the ability to use two different modulation schemes.

The use of PEP or V.32 modulation allows for flexibility in the performance of the 
point-to point circuit in relation to the task performed and data transferred.  PEP is 
highly recommended for use in long distance connections or low quality connections.  PEP 
will also yield the highest throughput in the transfer of binary files or compressible 
bulk data files using FTP or rcp, as well as SMTP and NNTP connections.  CCITT V.32 is a 
full duplex modulation scheme which will facilitate better interactive response during 
TELNET, rlogin, and rsh connections. 
\f



This document is meant to take a VERY general approach to the configuration of TELEBIT 
modems in interactive, file transfer, and networking applications on UNIX systems.  
TELEBIT welcomes any questions, comments, and suggestions on this or any of our other 
product or configuration documents at the following U.S. Mail address, telephone 
number, or network account:
 
			Michael Ballard/ Cerafin E. Castillo
			Telebit Corporation
			1315 Chesapeake Terrace
			Sunnyvale, CA  94089
			1-800-TELEBIT


		UUCP:		{uunet, sun, pyramid, ames, decwrl}!telebit!modem

	     INTERNET:		modems@telebit.com