home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Media Share 9
/
MEDIASHARE_09.ISO
/
pcboard
/
uupcb100.zip
/
UUCICO.DOC
< prev
next >
Wrap
Text File
|
1992-04-21
|
13KB
|
300 lines
The following is quoted for information purposes only. The complete
file, UUCICO.INF is included elsewhere in UUCICO.ZIP.
============================================================================
UUCICO.EXE is copyrighted but freely distributable. This ONLY
applies to uucico and not to any other files in the Waffle package.
You may do with it what you wish, but this file and all credits and
copyrights must remain intact. Our address is
Darkside International
PO Box 4436
Mountain View CA 94040
This free distribution applies ONLY to UUCICO.EXE,
and not to the remainder of the Waffle package.
Waffle's UUCICO is derived from DCP, a package released
to the public in 1987. Because it is based on DCP, source
for those portions are available by request.
Both DCP's and Waffle's copyrights apply to UUCICO.
DCP is (C) Copyright 1987 R H Lamb.
Electronic mail to: dell@vox.darkside.com,
or ..{apple,ames}!uuwest!dell
============================================================================
┌───────────────────────────────┐
│DESQVIEW USERS: See Note Below!│
└───────────────────────────────┘
┌────────────────────────────────────────┐
│HIGH SPEED CONNECTIONS - See Note Below.│
└────────────────────────────────────────┘
Note: before UUCICO.EXE can run, the environmental variable WAFFLE must
be set to point to the static file. If the static file was located in
C:\UUPCB\SYSTEM, you would set WAFFLE=C:\UUPCB\SYSTEM\STATIC.
See STATIC.DOC for more information.
UUCICO COMMAND LINE OPTIONS
-r Role. -r0 sets UUCICO.EXE to receive a call. There is
also an -r1 setting to signify dialing out. The -r1
option is redundant and not required.
-s <system> System. The system that you wish UUCICO.EXE to poll. You
must specify either a system name or the words "any" for
those sites that have traffic spooled or "all" to poll
all sites in your systems file.
Example:
uucico -s uunet
-x <#> Sets the level of the debug output. This is captured in
the file "UUCP" in the admin directory. It is also
echoed to the system console. The default is 0. A
setting of 2 will give the info necessary to debug the
expect send sequences.
Example
uucico -x2
-q Quiet mode. Info from UUCICO.EXE debug messages is not
echoed to the screen. It is only kept in the log.
-b <speed> Connect speed. If this is not specified, UUCICO.EXE
will use the speed specified in the systems file entry
for the system you are calling or it will try to use the
incoming connect speed.
-d <device> Device. -d1 = COM1 and -d2 = COM2. Not needed if port
specified in the static file. Note: UUCICO.EXE only
supports COM1 and COM2.
-i Ignore carrier detect.
-a Anonymous uucp allowed. This allows systems that are
not in your systems file to connect to your system. Not
recommended in most circumstances.
-w Reverse uucp connections. This allows another system to
request files from your public uucp directory.
-t <sec> Time for expect/send sequences. The default is 30
seconds. This can be useful if it takes a LOOONNNGGG
time to connect to a uucp site. For example, when
calling a site that sends Telebit answering tones first
and you are using a non-Telebit modem.
-n <name> Temporary uucp name. Some unix variants will only take
a 7 letter uucp name, others will take 8 characters.
Therefore, if your system has an 8-character name, like
uupcbbbs you can specify:
uucico -n uupcbbb
to allow your system to talk to theirs.
Your Systems File
There should be one line in the systems file for each separate phone
number of each system you call for mail and/or news. The files are are
in the following format:
system time-to-call port dialer speed protocol expect/send sequence
Here's a typical entry:
klingon Any COM1 Direct 19200 g "" ATZ OK ATDT5551212 CONNECT \d\r\d\r
ogin:-ogin: romulus word: sela
Ok, let's break it down, step by step:
klingon - This is the name of the remote system
Any - Call at Any time. I suggest you always use this. There are other
options including:
Evening - 5PM-8AM Mon-Fri and Sat & Sunday, anytime.
Never - Don't call this system
Su Mo Tu We Th Fr Sa - Days of the week. You can specify any
combination, like FrSaSu or MoWeFr, etc. Run them all together
into one string.
Wk - Weekday, i.e., M-F.
0000-0000 - A time field in military time. i.e., 2300-0530 for
11:00 PM to 5:30 AM, etc. This can be used in conjunction with
the other abbreviations like We1700-2300 for Wednesday only
5:00 PM to 11:00 PM.
AGAIN: I RECOMMEND THAT YOU SIMPLY USE "Any" INSTEAD OF THESE
MORE COMPLEX STRUCTURES, AT LEAST FOR NOW.
COM1 Your comm port, either COM1 or COM2. Note: NO COLON! NO COM3,
NO COM4!
Direct There are two options, Direct and Serial. Direct supports
Carrier Detect, Serial doesn't require carrier detect.
19200 Speed to call at. I use 19200 on HSTs, even when calling
non-HST systems. It works fine that way. 19200 is the highest
speed that I have tested. Try 38400 at your own risk!
g Protocol. The only protocol supported by uucico is the UNIX g
protocol for uucp. Other protocols exist, but are not yet
supported.
Expect/Send sequences (also known as a "chat script"):
From here on out, entries in Systems are in pairs. They are expect and
send. They perform roughly the same thing as a QModem script. The
difference is that they are simpler and more cryptic. Here's the pairs
from the example:
"" ATZ - The "" means nothing. In other words, expect nothing, send
ATZ. We use "" as a dummy entry here so that we can proceed to
the "send" stage. ATZ is, of course, the modem reset command.
If you need some sort of initialization, send that instead.
OK ATDT5551212 - Wait for the "OK" from the modem, then send the
dialing instruction to dial the remote systems phone number.
CONNECT \d\r\d\r - Wait for connect from your modem and then execute the
following instructions, one after another:
\d - pause two seconds
\r - send carriage return
\d - pause two seconds (again)
\r - send carriage return
The logic here is that most Unix systems need a second or two to
spawn a login prompt after you connect to the modem.
Additionally, many systems need one or two carriage returns to
get the login. Full summary is below.
ogin:--ogin: romulus This is a little different. Here we are waiting
for the five characters "ogin:". Please note the "--" and then
the repetition of the "ogin:". This means wait then send
whatever is between the dashes. That could be nothing, as shown
here, in which case all that is sent is a carriage return. You
could also put the word "BREAK" between the two dashes (i.e.,
"ogin:-BREAK-ogin:" to send a break. This is needed, on
occasion to cycle the connect speed on the remote system.
The default delay is 30 seconds between all expect/send
sequences, including between the two dashes. You can override
this delay with the -t option, see above.
(Note: "ogin:" is the last five characters of the system login
prompt. Most UNIX systems use login:, but others might have
something else. I recommend that you call the system with a
terminal program first and see what the prompt looks like.)
word: sela Wait for the system password prompt and send the
password (sela).
From this point, the process is automatic. The systems identify
themselves to each other and the calling system (i.e., you) sends the
items it has spooled for the remote site. Then the channel is reversed
and remote sends to you. After that, the systems hang up and uucico.exe
exits with error level 0. If a busy or other problem occurred,
uucico.exe will exit with error level 1. See CALLUNIX.BAT for how this
is handled.
UUCICO ERROR MESSAGES:
On occasion, particularly if your UNIX host didn't finish setting up
*your* system on *their* system, you may get these error messages in
your \UUPCB\ADMIN\UUCP log file.
For example you might get:
Can't Tango - (reason). Can't Tango means that you can't talk. Here
are some of the reason codes:
Can't Tango - RLOGIN - The remote system does not have permission to
talk to you. There is a "Permission" file on most Unix systems
that must be set before the system will let you connect.
Can't Tango - RLCK - The remote system has a "lock" on file for your
system. That is a flag that indicates that remote is trying to
call you (NOTE: uuPCB doesn't currently support RECEIVING
calls.) or it has not yet removed the lock from the previous
conversation. Wait a few minutes and try again.
Can't Tango - RYou are unknown to me. - In other words, your system is
not defined in the remotes systems file. Check for typos, line noise
problems, etc.
Here's a summary of these commands:
\b Send or expect a backspace (i.e., a control-H).
\c Dont send a CR after the end of a send string.
\d Two second Delay.
\n Send or expect a linefeed (i.e., a control-J).
\r Send or expect a carriage return (i.e., a control-M).
\s Send or expect a space character.
\t Send or expect a tab (i.e., a control-I).
\\ Send or expect the backslash character.
You can send other characters by send a "\" and a three digit
octal representation of the ascii code. That's right, OCTAL
(base 8), not decimal, not hex.
High Speed Connections
If you are connecting to your feed site at high speed (9600 or higher),
a fossil driver like BNU.COM or BNU.SYS might be needed. In many cases,
UUCICO.EXE operating without the fossil driver at high speed will have a
large number of errors. A fossil driver will, in many cases, clear this
up. BNU170.ZIP is available for download from Ed Hopper's BBS at
713-997-7575. BNU supports locking of port speed at 19200, etc. It can
be installed and uninstalled as part of your batch file if you do not
want to run it all the time. Note the "uu.driver: fossil" parameter
(below) for the static file. It MUST be included for your fossil driver
to work.
STATIC FILE PARAMETERS
In some cases you will not need these parameters. These parameters go in
the STATIC file.
uu.alive - Time before UUCICO gives up on a call attempt. Default is 90
seconds.
uu.debug - Allows you to set the default debugging level. The -x
command line option also does this.
uu.driver - By setting 'uu.driver: fossil' you can utilize a fossil
driver if desired.
uu.errors - Number of errors before aborting a session. Default is
200.
┌───────────────────┐
│Desqview Users Note│
└───────────────────┘
The Clark Development documentation for use of PC Board and Desqview
instructs you to set the parameter:
Uses Serial Ports (Y,N,1,2) ...............................N
If you do this, UUCICO may be unreliable. Therefore, set it to Y or to
the com port for that node. You need only do this on the Desqview
partition that actually executes UUCICO.