docs vers. 2.0 written 12/14/87


                                      SEA PUP
                          Automated File Transfer Utility
                                    vers. 02.0.0
                                        ---
                        Copyright (C)1987 by Michael Bailey
                                All Rights Reserved
                                        ---
            Released to the Public Domain with certain legal restrictions
                    Created for use with TRSDOS 6.2.x & LDOS 6.x
                   SEA PUP is in NO way associated with SEA, Inc.
                                        ---
                                   Distributed By
                           SAN DIEGO METRO MULTIUSER TBBS
                    FIDONET 10/210 - (619) 582-5656 - 24 HOURS
                                   300/1200 BAUD






*** Introduction

The SEA PUP Automated File Transfer Utility will allow Model 4 users to program
their computer to automatically call and log onto a remote bulletin board, send
or recieve file(s) effortlessly and without human intervention, and then logoff
and then optionally run a program.    SEA PUP will allow you to create a batch 
file containing a list of files to send or recieve and will execute it upon the
pre-designated time that you specify.  SEA PUP is compatable with PC Pursuit.  
What has been traditionally possible only with Y-Modem is now possible with SEA
PUP and the Model 4.


*** Definitions

BATCH FILE:  This is the file that instructs SEA PUP what to do and when to do
it.  There is only one Batch file, called SEAPUP/FIL, that contains information
necessary to control the Pup.

SCRIPT FILE:  Script files are files that contain information about each BBS 
that you will be calling.  For example, the script file contains the BBS number
and how to auto-logon, upload and download files, etc.  Each BBS that you will
be calling requires a Script File.


*** Version 2.0.0 Enhancements

SEA PUP 2.0.0 is now fully compatable with 300/1200/2400 BAUD operation.  SEA
PUP, while still a versatile BASIC Program, now interfaces directly with the 
RS232C Port and no longer makes use of the COM Driver.  Note that SEA PUP,
while it may be used with non-hayes compatable MODEMS, currently only supports
Hayes-Type MODEMs.  SEA PUP permits you to dial as many numbers as you wish,
one right after the other, until all calls have been successfully made and all
files have been successfully transfered.

KEY ENHANCEMENTS:

o To abort an XMODEM Transfer, simply PRESS and HOLD DOWN CTRL X.

o Pressing [F1] will ABORT the currently executing task and cause SEA PUP to
  continue on with the next command in the batch file.  If SEA PUP is 
  connected to a remote host, then it will hang up the modem and return to  
  the batch file for instructions.

o Pressing [F2] causes SEA PUP to hang up the MODEM immediately.  If SEA PUP
  is connected to a remote HOST, then that event is automatically aborted and
  control resumes with the next command in the Batch file.  ie: SEA PUP will
  disconnect with the Host and either begin calling the next board on the list
  or perform whatever task you have specified.

o Pressing [F3] will perform an immediate Shut Down of SEA PUP and return you
  to DOS Ready prompt.  All files are closed and all variables are cleared.

o Pressing [SHIFT]+[CLEAR] will clear the screen.

o Pressing [?] will display a summary of events.  ie:  How many calls SEA PUP
  has made, how many calls were aborted, number of successful file transfers,
  aborted transfers, and much more useful information.

NOTE that if SEA PUP is using the built-in PC Pursuit Generator, some of these
commands are halted until certain communications have taken place between the 
PC Pursuit MODEM and SEA PUP.  Pressing the key once will cause SEA PUP to 
perform whatever function you desire when it reaches a "window."  When dialing
direct, all keys are active and "hot" - note that some commands are disabled 
when SEA PUP has established a carrier over the phone line only temporarily. 

Other Enhancements:

SEA PUP no longer aborts to the main menu when it encounters an error, either
software or hardware.  Any Batch File or Script File errors are displayed, 
recorded, and then control passes to one of two error routines.  If SEA PUP is
in the process of calling or is connected to a remote HOST, a SCRIPT File error
will cause SEA PUP to Terminate the call and return to the Batch file for more 
commands.  If the error takes place in the Batch file, SEA PUP will note the 
error and continue execution with the next command in the Batch file.  Two new 
commands have been added:  BAUD and REM.  BAUD allows the setting of the BAUD
rate and REM permits the documenting of BATCH and SCRIPT files.

*** System Requirements

In order to use SEA PUP, the following equipment is required:  a Model 4/4P/4D
computer, two floppy drives, 64K RAM, and a 300/1200 Baud MODEM.  SEA PUP is
now compatable with TRSDOS 6.2.x and LDOS 6.x without any modifications to the
software whatsoever.  Note, to use SEA PUP with PC Pursuit, a Hayes-compatable
modem is required. SEA PUP is now compatable with 300/1200/2400 BAUD operation.


*** System Configuration

While SEA PUP no longer requires that COM/DVR be installed and does not make
use of the COM driver, the XMODEM version included with SEA PUP does require
that  it be installed before program execution.  For MODEMs that are not Hayes
compatable, it is necessary that the FORCED CARRIER be turned OFF!  


*** Public Domain Notice

The use and distribution of this program is permissable as long as the program
is made available FREE of charge.  This program is copyrighted 1987 by Michael
Bailey, and all rights are reserved.


Files included with this package, and files created by SEA PUP during runtime:

a) SEAPUP/BAS: This is the CONTROLLER of SEAPUP. It displays a menu, and allows
you to either run SEAPUP/COM or CREATE/EDIT Batch Files and/or BATCH Files.

b) SEAPUP/COM: This is the actual SEA PUP program. At the TRSDOS Ready Prompt,
typing SEAPUP/COM and pressing [ENTER] will cause SEA PUP to execute its files
immediately.  Use this filename when calling SEA PUP from other programs.  It 
will by-pass the main menu and execute SEA PUP immediately.

c) SEAEDIT/BAS: This program allows you to create BATCH files and MASTER file
for use with SEA PUP.  It is an option program, but allows greater ease in the
creation and testing of the MASTER and BATCH files.

d) SEAPUP/FIL: This is the BATCH File that instructs the SEA PUP what it should
do. This file calls other files and contains commands necessary to run SEA PUP.

e) SEAPUP/CMD: This is the XMODEM program that SEA PUP uses to transfer files.
Currently SEA PUP can only use XMODEM CHECKSUM, but future versions will allow
the newer CRC error-checking protocol of XMODEM.

f) SEAPUP/LOG: This file is created by SEA PUP and contains information about
the program run.  It keeps a record of everything that SEA PUP does during the
execution phase.  All errors encountered are also written to this file.

g) SEAPUP/JCL: This is a JCL file that can be used optionally to set up your
system configuration (SETCOM, etc.) and run SEAPUP/BAS.




                 >>>>>>>>>>>>  HOW TO USE SEA PUP  <<<<<<<<<<<

From the TRSDOS Ready prompt, type:  BASIC SEAPUP/BAS and press ENTER.  In a
few moments you will see the SEA PUP menu screen.  From this screen you may
choose and design BATCH files that will control your computer and modem.   

From the SEA PUP main menu you will be presented with several options.  Each
option is briefly outlined below:

[1] Create SEA PUP SCRIPT/BATCH Files - will allow you to create the MASTER
file that controls your computer and tells it when, where, and who to call. 
Additionally, it will permit you to create the TADPOLE Files that SEA PUP uses
to log on to a remote system and upload/download files.  Each BBS that you
plan on uploading and/or downloading to requires a corresponding TADPOLE File.

[2] Run SEA PUP - Pressing this key will initiate the program and cause it to
execute automated file transfers.  If you want to run SEA PUP immediately, or
call SEA PUP from another program, use RUN or BASIC SEAPUP/COM.  This is the
name of the program that performs automated file transfers.

[3] Exit SEA PUP to TRSDOS Ready - Ends the SEA PUP program and returns you to
the TRSDOS or LDOS Ready prompts.


                    >>>>>>>>  CREATING A BATCH FILE  <<<<<<<<

Upon entering SEA PUP, you should create the BATCH file that you will be using
to control the computer with.  After pressing option [1] from the Menu SEA PUP
will load the program SEAEDIT/BAS and in a moment you should see the Editor
screen.  You will then see the prompt:

         TADPOLE> 

From this prompt you may enter the following commands:

*** Commands Legal in SEA PUP BATCH File:

          WAIT   -  Tells SEA PUP to wait until a specified time (in 24 hour
                    format) before executing one or more SCRIPT files.

          CALL   -  Instructs SEA PUP to execute a SCRIPT file. The SCRIPT file
                    contains information on how to log onto the board you are 
                    calling, and how to download from that board.

          LOG    -  Issues a LOG message to the file SEAPUP/LOG.  This file
                    contains information about what SEA PUP is doing. Every
                    time SEA PUP executes a command, it is entered into the
                    log so that you may see exactly what SEA PUP did during
                    the program run.  Any errors encountered by SEA PUP are
                    also logged into this file.

          END    -  Tells SEA PUP that the events programmed are ended.  It
                    will stop the program and return to BASIC ready, or do 
                    any commands or run any programs that you specify in the
                    BATCH file.

          SYSTEM -  Will perform a SYSTEM command (library command, run a 
                    utility, or execute a CMD program.)

          RUN    -  Tells SEA PUP to run a BASIC program.  This command can
                    only be used AFTER SEA PUP has completed all SCRIPT files
                    and has recieved an END command.

          REM    -  REMark statement.  Used to document a BATCH File for easier
                    viewing. 

The above commands are used to initiate the proper SCRIPT files.  For example,
the following information might be entered in response to the SEA PUP input
request:

TADPOLE> REM  * Begin Execution at 1:30 a.m. *
TADPOLE> WAIT 01:03
TADPOLE> CALL GUYOMER/FIL
TADPOLE> CALL MICRO80/FIL
TADPOLE> REM  * Wait until 9:00 a.m. before continuing *
TADPOLE> WAIT 09:00
TADPOLE> CALL BBS/FIL
TADPOLE> LOG ** All Files Executed Program Ends **
TADPOLE> END
TADPOLE> SYSTEM RUN DESKMATE/CMD


The first line says WAIT 01:03 which tells SEA PUP to wait until 1:30 a.m.
before beginning execution of the two files beneath it.

At 1:30 a.m., SEA PUP will execute files GUYOMER/FIL and MICRO80/FIL.  SEA PUP
will then wait until 9:30 A.M. before continuing.  At 9:30 A.M., SEA PUP will 
begin running BBS/FIL.  When it is finished running this file, it will return 
to this BATCH File and input the next command.

The command is LOG.  As previously mentioned, the LOG command will send a
message that you write to the SEAPUP/LOG file.  You may send a message to the 
PUP log if you so desire by issuing the command LOG and the message.  Message
can be up to 60 characters long.

The final line in the BATCH file tells SEA PUP that the Event is over.  END 
is used to indicate that there are no more SCRIPTs to execute.  There are some
commands in SEA PUP that can ONLY be given AFTER SEA PUP has recieved the END
command.  These commands are explained below:

SYSTEM - SEA PUP can execute SYSTEM commands.  SYSTEM commands (either TRSDOS
or LDOS) may be initiated at any time between File Events.  Please note, that
while SEA PUP is running a File Event, it CAN NOT run a program, either BASIC
or machine language!  Only after SEA PUP has been issued the END command may 
you execute a ML program or BASIC program.  For instance, after SEA PUP has  
completed transfering files for the night, you might want to run a program in
BASIC or a /CMD program (such as Deskmate).  To do this, enter the command to
SEA PUP:  SYSTEM RUN FILENAME/EXT (for a machine language program only.)   To
run a BASIC program, the command is RUN (see below).

RUN - This will allow you to run a BASIC program after SEA PUP has finished all
SCRIPT file transfers.  You can NOT run a BASIC program until the command END 
has been issued to SEA PUP.  The syntax for running a BASIC program is
RUN FILENAME/EXT.


OVERVIEW OF SCRIPT FILE COMMANDS
================================


TIME                Format:    TIME XX:XX

This is a useful feature that limits the time that SEA PUP remains connected to
a remote host system and/or continues trying to reach a remote host system. For
example, at the beginning of the SCRIPT file you might issue the command
TIME 05:00.  SEA PUP will call the BBS and (provided a connection is made)
transfer files as normal. If SEA PUP should go past the designated time (05:30)
transfering a file it will terminate on completion of the transfer and hang up.
If a connection is not made, SEA PUP will stop trying to call the host at the 
designated time (05:30) and return to the BATCH file for instructions.  For
example:  TIME 05:30  issued at the beginning of the SCRIPT file tells seapup
to make sure that it does not stay connected to the remote host or continue 
calling the host no longer than 5:30 am.  TIME is in 24-hour format. If SEA PUP
is in the process of a transfering a file when 5:30 rolls around, it will
complete the transfer and them immediately log off the HOST.  When you issue a
TIME command, SEA PUP continually checks the time.


SET THE BAUD RATE    Format:    BAUD ####

Effectively sets the baud rate at which file transfers will take place. #### is
the baud rate.  BAUD 300 sets the baud at 300, while BAUD 1200 sets it at 1200.
Baud rates of 300, 1200, and 2400 are supported by this version.  This command 
should be issued near the top of the batch file, before DIALing is initiated.  
BAUD rate MUST be set or it will default to whatever the current rate is on the
COM/DVR utility.


DIAL PHONE NUMBER    Format:    DIAL xxxx###-####

Used to dial the modem.  xxxx is the modem dialing commands.  For Hayes and 
compatable modems, the command is:  DIAL ATDT###-####.  If you do NOT have a
Hayes-compatable modem, then substitute your own modem commands for x.  The
MODEM command string may contain up to 39 characters.  Note, this command will
call a remote host/BBS directly.  To use PC Pursuit with SEA PUP, use the 
command DIAL PCP (described below).


DIAL WITH PC PURSUIT Format:    DIAL PCP xxxx###-####

Allows you to use PC Pursuit when making calls to out-of-town areas.  When you
place a call through PC Pursuit, you MUST follow this guideline-  Issue the 
command to SEA PUP:  DIAL PCP xxxx###-#### which is IDENTICAL in format to the
DIAL command above. After issuing this command, you MUST enter a THREE (3) line
command as shown below:

* IMPORTANT SOFTWARE UPDATE: When calling with PC Pursuit, it is REQUIRED that
you set the modem string (DIAL PCP ATDTxxxx###-####) to DIGIT RESULT CODES and
EXTENDED RESULT CODES!  SEA PUP will loop otherwise.  For a 1200-baud Hayes   
modem or compatable, the command is DIAL PCP ATV0X1DT###-####  This sets the  
modem to DIGIT RESULT CODES, EXTENDED RESULT CODE SET.  For 2400 Baud Modems  
use their respective commands.

                       DIAL PCP ATV0X1DT233-0233; ENTER THE LOCAL PCP NUMBER.
                       C DIAL###/##,########    ; ENTER THE USUAL COMMANDS.
                       PASSWORD                 ; YOUR PCP PASSWORD HERE.
                       ATDT###-####             ; THE NUMBER YOU WISH TO DIAL.

(in the example above, omit the ; from the actual SCRIPT file.)

When using PC Pursuit, you not need to put a WAIT FOR CARRIER command (WC) on 
the line after DIAL.  There is a seperate subroutine in the program that will 
automatically wait for a carrier detect.  The next line in the above example
file should contain the logon procedures (discussed below).  Note, when using 
the DIAL PCP command, SEA PUP will automatically call the local PCP exchange #
in your area (top line) and wait for a carrier.  When it is found, it will log
onto PC Pursuit using the second line in the example above, followed by the   
password.  If the remote-exchange you are trying to connect with is busy, SEA
PUP will inform you and immediately re-enter your account code/information  
and try again.  SEA PUP will retry 100 times before disconnecting.  If SEA PUP
encounters a CONNECT on the exchange you are trying to connect with, it will  
inform you of this fact and immediately begin entering the PHONE NUMBER (line 
four) and wait for either a CONNECT or BUSY string.  If the number is BUSY, SEA
PUP will enter ATZ [ENTER] and the phone number again, and wait for either the
CONNECT or BUSY string.  If a connection is made (CONNECT string found) then 
SEA PUP will exit the PCP Dialing/Logon Mode and return to the SCRIPT file for
instructions on logging on.  Note, SEA PUP will redial the PCP number a total 
of 20 times.  It will send the ACCESS/ACCOUNT CODE/PASSWORD string a total of 
100 times before aborting, and will redial the remote HOST phone number (line 
four) a total of 100 times before aborting.  If it aborts, it will hang up the
phone and immediately begin dialing PC Pursuit once again, for a total of 20  
calls, or until a connection is made with the remote BBS you are trying to
reach.  You must supply your OWN password and account information in the above
example.  This information MUST be in EVERY file that you wish to call using  
PC Pursuit.


HANG UP MODEM        Format:    HANG UP

Will cause SEA PUP to immediately release the telephone line and disconnect
from the HOST.  This command should only be imployed AFTER the proper commands
have been issued to the host, instructing it to disconnect.  It is not a good
idea to use SEA PUP to drop carrier on the host systems that you will be using
it on.  ALWAYS instruct the host to disconnect before initiating this command!
It is a good idea to issue the commands to the Host to disconnect, and then 
issue the command to SEA PUP: WAIT NO CARRIER (see below).  HANG UP command is
not recommended.



RECEIVE TEXT         Format:    RECEIVE character from host

SEA PUP will wait until the specified text is recieved.  Text may be up to 1
character long.  If the text isn't recieved after 60 seconds, SEA PUP  will
disregard the next line in the SCRIPT File and continue with program execution
at that point.  This was done to allow for mail checking on some BBS systems..
On TBBS, if you have mail waiting, the prompt is: Read Now? (Y/N): and so you
could set up SEA PUP to RECEIVE ? (receive the character '?').  The next line
in the SCRIPT File should be SEND N. If you have mail then SEA PUP won't try to
read it, and if you don't have mail, SEA PUP will wait for the '?' and if it is
not receive after 60 seconds, it will continue with the next line in the SCRIPT
file.

SEND TEXT            Format:    SEND text or commands

Causes SEA PUP to transmit specified text or commands to the host computer. The
syntax is: SEND xxxx  where (xxxx) is the text or command(s) to be transmitted.
The text string may be up to 74 characters in length.


WAIT FOR CARRIER     Format:    WAIT CARRIER

Will force SEA PUP to wait until a valid carrier is detected. This command must
be entered after the DIAL command if a proper connection is to be made. SEA PUP
will automatically re-dial busy numbers, constantly, until it's 'quit' time is 
reached (via the TIME xx:xx command).  It will then abort that SCRIPT file and 
begins calling other numbers in the BATCH File.  SEA PUP waits 30 seconds for a
connection before redialing the number.  You may cause SEA PUP to immediately  
redial the number by pressing [F2].


WAIT FOR NO CARRIER  Format:    WAIT NO CARRIER

SEA PUP will wait until there is NO carrier over the data line before resuming.
Usually this command is entered after the signoff command is given to the host.
If, after 30 seconds, there is still a carrier over the data line, SEA PUP will
manually release the telephone line and disconnect.  The error message, "Host
idle.  SEA PUP Terminating" is issued to the SEA PUP Log file.


XMODEM RECIEVE       Format:    XMODEM R Filename[/ext(:d)]

Tells SEA PUP that you wish to recieve an XMODEM file.  This should be the very
last command in the BATCH File after the host has been toggled to send a file
via XMODEM (Checksum).  To abort a file transfer, press and hold down CTRL X.  


XMODEM SEND          Format:   XMODEM S Filename[/ext(:s)]

This command tells SEA PUP to SEND a file using XMODEM Checksum protocol.  Once
again, this should be the very last command issued to SEA PUP after you've
instructed the HOST to recieve a file.  Press and hold down CTRL X to abort a 
file transfer.


KILL FILE            Format:   KILL Filename[/ext(:s)]

Kills a file from BASIC.  This command might be used to delete files after
sending them to a host computer.


LOG MESSAGE          Format:   LOG message/text

This command will issue a message to SEAPUP/LOG.  You may send any message up
to 75 characters in length.  Do not include quotes or deliminators.  The text
may be in either upper or lower case, or a combination of both.


PAUSE x SECONDS       Format:   PAUSE xx

Causes program execution to pause for specified number of seconds (x).  Values
between 1 second to 10,000 seconds are allowed. PAUSE 1 will pause for 1 second
while PAUSE 255 will pause for 255 seconds, etc.


CARRIAGE RETURN       Format:   * or ^M (must be upper case)

In the BATCH FILE, an underline is used to denote a carriage return.  Any
commands sent to the host that require a carriage return as a terminator you
can use either an asterisk (*) or an ^M.  The carrot (^) denotes that the next
character to be sent is a control-code.  (see below).  The astersk was used
to provide convenience when specifying a carriage return as it is the most
often-used control code character.


REMARK                Format:  REM Text

Allows the documenting of SCRIPT Files.  Text may be up to 75 characters in 
length.  


CONTROL CODES         Format:  ^

Many times it is necessary to send control codes to a computer (CTRL S, CTRL Q,
CTRL C, CTRL K, CTRL M, etc.).  Since the Tadpole BATCH files do not allow you
to imbed actual control codes into the files, the command ( ^ ) is provided to
permit this.  For instance, a carriage return would be specified as ^M and an
XON/XOFF would be specified as ^Q and ^S respectively. *Please make a note that
you may not have more than ONE control code in any SEND command!*  The control 
code, in addition, must be the LAST code in the SEND command statement.  For  
example, SEND ^M HELLO is NOT permitted!  The correct syntax is SEND HELLO^M. 


*** Creating SCRIPT Files

The SCRIPT file is a file that is called by the BATCH File and contains all of
the commands and instructions for logging onto a bulletin board and begin an
upload/download, as well as a list of filenames that you wish to transfer.

To create a SCRIPT File from TRSDOS type BASIC SEAEDIT/BAS and press [ENTER]. 
From SEAPUP/BAS, press option [2] from the Menu.  After pressing this key, SEA
PUP will load the SEA EDIT Program.  You may immediately begin creating either
a BATCH File or SCRIPT file and save them to disk.  You may only create or edit
ONE BATCH or SCRIPT file at a time.  The prompt that appears on your screen
appears like this:

                    TADPOLE>

You may now begin to create the file.  For instance, if you have some files to
upload to a BBS, you might enter these commands:

TADPOLE> BAUD 1200                     ; Sets the Baud rate to 1200 bps
TADPOLE> TIME 02:30                    ; This event will last until 2:30 a.m.
TADPOLE> DIAL ATDT555-5555             ; Dial number 555-5555 (a bbs)
TADPOLE> WAIT CARRIER                  ; Wait for a carrier to be present
TADPOLE> PAUSE 2                       ; Pause two seconds after carrier found
TADPOLE> SEND S                        ; Send an 'S' to the HOST
TADPOLE> SEND NAME*                    ; Send your name to the HOST
TADPOLE> SEND PASSWORD*                ; Send your password to the HOST
TADPOLE> PAUSE 2                       ; Pause for two seconds
TADPOLE> SEND L*                       ; Send an 'L' and a Carriage Return
TADPOLE> PAUSE 1                       ; Pause one second
TADPOLE> SEND D*                       ; Send a 'D' and Carriage Return
TADPOLE> PAUSE 1                       ; Pause one second
TADPOLE> SEND FILENAME/EXT             ; Send Filename/ext to host
TADPOLE> SEND 3                        ; Send a '3' (maybe Xmodem specifier)
TADPOLE> XMODEM S FILENAME/EXT         ; UPLOAD via XMODEM, Filename/Ext
TADPOLE> PAUSE 1                       ; Pause one second
TADPOLE> SEND G*                       ; Send 'G' for Goodbye on the HOST
TADPOLE> SEND N*                       ; Send 'N' in response to question, "log
                                       ; off and leave SYSOP a msg?"
TADPOLE> WAIT NO CARRIER               ; Wait for NO carrier.

You MUST omit the comments (;) above from the actual file as SEA PUP does not
allow commenting in either the BATCH or SCRIPT file.

Note:   SEND 1*
        SEND 2*
        SEND 3*

is the same as:  SEND 1*2*3* ....... but SEND 1^M2^M3^M is NOT allowed.

========================
IMPORTANT NOTE: ALL commands issued in either the BATCH or SCRIPT File MUST BE
IN CAPITALS!  SEA PUP will not recognize lower-case commands.  Text received or
sent to the host may be either upper or lower case, however SEA PUP commands
may not! 
========================

*** Example of a SEA PUP set up:

To log onto a BBS the BATCH file must contain the file(s) that you wish to use
in calling certain host systems.  The BATCH Filename is ALWAYS SEAPUP/FIL!  You
may not have more than one batch file at any one time.  A sample batch file is
shown below:

REM  Batch File #1
REM
CALL GUY/FIL
CALL BBS/FIL
END
SYSTEM RUN DESKMATE/CMD

In the above example, SEA PUP will first call GUY/FIL.  GUY/FIL is the SCRIPT
file that contains all of the information necessary to log on to that BBS and
upload, download, and log off.  GUY/FIL might look like this:

REM ***** GUY OMER'S 8/N/1 #1   -  GAINSVILLE, FLORIDA *****
REM
DIAL ATDT1-904-377-1200
WAIT CARRIER
RECEIVE >
SEND NAME NAME*
RECEIVE >
SEND CAT 8N1*
PAUSE 5
SEND S
PAUSE 1
SEND DOWNLOAD CATALOG/TQT*
RECEIVE ?
SEND Y
PAUSE 1
XMODEM R CATALOG/TQT:1
RECEIVE >
SEND Q*
PAUSE 1
SEND Y*
PAUSE 1
SEND THANKS FOR THE FILE, GUY!*
SEND *
WAIT NO CARRIER

The first line dials the BBS number.  The second line instructs SEA PUP to wait
until a carrier is present before continuing.  If no carrier is present within 
30 seconds, SEA PUP will continually redail the number until a carrier is found
on the line.  The third line tells SEA PUP to wait until the character > is 
received through the modem.  The next instruction sends out NAME NAME and then
a carriage return.  The next command causes SEA PUP to wait until a > is 
received through the modem.  Then the text CAT 8N1 is sent to the host, with
a carriage return (*).  SEA PUP will then pause 5 seconds and send an S to 
interrupt the printing catalog.  SEA PUP will then wait one second before it 
sends the text DOWNLOAD CATALOG/TQT*  (remember, the * represents a CR).  Then
SEA PUP waits for question mark (?) before proceeding.  When it is received, a
"Y" is sent to the host followed by a one-second pause.  The next command tells
SEA PUP to receive an XMODEM file, called CATALOG/TQT and place it on drive 1.
After the file is transfered, SEA PUP waits for a Greather-Than (>) and then 
sends the text "Q" followed by a carriage return, instructing the host that it
wishes to disconnect. After a one-second pause, SEA PUP will send a Y[ENTER] in
response to the question "Leave message to sysop? (Y/N)" and transmit a message
and send TWO carriage returns, then wait thirty seconds for a loss of carrier.
If, after 30 seconds, a carrier is still present on the line, SEA PUP will
manually disconnect from the host.  After it has terminated from the host, SEA
PUP will return to the batch file for the next instruction.

The next line in the BATCH File tells SEA PUP to execute the BBS/FIL.  BBS/FIL
might be similar to the example file shown above.  After BBS/FIL is executed,
SEA PUP pulls the next line out of the BATCH FILE, and it is the command END. 
SEA PUP immediately resets all system flags and closes all non-system files. 
The next line instructs SEA PUP to run the program DESKMATE.



*** Notes

After completing a BATCH file, you should check the SEAPUP/LOG file by going
into TRSDOS or LDOS and typing "LIST SEAPUP/LOG" or loading it into a word
processor.  A recorded log of everything that SEA PUP did and everything that
happened is written to the logfile.

SEA PUP is currently compatable with 300/1200/2400 BAUD. Future versions of 
SEA PUP will allow CRC protocol transfers, and shorter and more efficient
Batch file routines.

This program is designated as PUBLIC DOMAIN and is distributed as such on the
condition that it be made available FREE OF COST to any and all users seeking
it.  SEA PUP is the product of many hours of work and experimentation.  It is
the copyrighted work of Michael Bailey.  It is requested that no modifications
to the program be made without notifying the author first.  SEA PUP vers 2.0 
is being distributed in a protected binary format.  SEA PUP is a microsoft(tm)
BASIC-based communications program.

The author of this program assumes no liability for the use of this program or
any consequences resulting from the use of this program.  The user takes all
all responsibility in using this program, and accepts any damages resulting
from its use or misuse.  
------------------------------------------------------------------------------
Future versions will be distributed to the following systems:

SAN DIEGO METRO MULTI-LINE TBBS
(619) 582-5656 | 300/1200 BAUD | 24 Hours a day/7 days | FidoNet 10/210 

GUY OMER'S 8/N/1 #1 BBS in Florida
(904) 377-1200 | 300/1200/2400 BAUD | 24 Hours /7 days 
----------------------------------------------------------------------------
Questions and suggestions regarding this Program may be directed to
MIKE BAILEY of SAN DIEGO METRO MULTI-LINE TBBS or by writing:

  Mike Bailey
  620 11th St.
  Ramona, CA 92065

Version 02.0 released December 15, 1987
