Media Share 9/MEDIASHARE_09.ISO/pcboard/uupcb100.zip/UUCICO.DOC

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:  [e-mail],
                       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.