HAM Radio 3/hamradioversion3.0examsandprograms1992.iso/packet/yapp/yapp.doc

Text File | 1986-08-26 | 8KB | 221 lines

              YAPP(tm) - Yet Another Packet Program

           (C) Copyright 1986 by Jeff Jacobsen, WA7MBL
                Released For Public Distribution
                       ALL RIGHTS RESERVED


  Permission is granted to freely distribute this code, provided
that this notice and the following disclaimer are included in
their entirety and without modifications of any sort.  This work
may not be sold, or modified and sold, or included with any other
product to be sold, without the written permission of the author.

  No fee or compensation may be requested or received by any
person or organization distributing this program, except by the
author and/or K7PYK, the authorized distributor.

Disclaimer:

  No guarantees or warranties of any kind are expressed or
implied.  This code is distributed "AS IS" without any warranty
of any kind, either expressed or implied, including, but not
limited to the implied warranties of merchantability and fitness
for a particular purpose.  You are soley responsible for the
selection of the program to achieve your intended results and for
the results actually obtained.  Should the program prove defec-
tive, you (and not the author) assume the entire cost of all
necessary servicing, repair, or correction.

  Neither the author nor anyone else who has been involved in the
creation, production or delivery of this program shall be liable
for any direct, indirect, consequential or incidental damages
arising out of the use or inability to use this program.


                      Jeff Jacobsen, WA7MBL
                          1400 E 900 N
                       Logan, Utah  84321


INTRODUCTION

YAPP(tm) was written to provide a terminal program for use in
testing the WA7MBL BBS code.  To help provide funding for the
continued development of the BBS code, it was decided to offer
this program.  The BBS code will continued to be offered at no
cost to the Sysops running it.

A contribution of $20 is asked of any users of YAPP who find it
of value.

User feedback and registration is also encouraged.  Your comments
and suggestions are welcomed.  The success of this method of
distribution will determine whether future versions of YAPP will
be distributed freely, or sold commercially.

Whether you make a contribution or not, you are encouraged to
copy and distribute this program for the private, non-commercial
use of others.

A copy of this program may be obtained by either sending $5 orby
sending a blank, formatted disk together with an addressed,
postage-paid return mailer to:

     Wes Morris, K7PYK
     7422 E McKinley Street
     Scottsdale, AZ  85257

A copy should also be available for downloading from Hamnet on
Compuserve.

Contributions or user feedback may be sent to K7PYK, or
directly to the author.


HARDWARE REQUIREMENTS


YAPP has been tested on an IBM PC, XT, AT, and a few
compatibles.  Another version of YAPP (YAPP2) is available which
uses an external resident I/O driver.  If you have an MS-DOS
computer which does not use the standard IBM communication port
locations, we may be able to help you adapt YAPP2 for your
computer.

We recommend that your CONFIG.SYS file has a FILES parameter of
at least FILES=10.  We uses FILES=20 and BUFFERS=20.


COLOR MONITOR

If you are using a color monitor, you may change the colors used
by editing the file YAPP.COL with a standard text editor.  See
the file YAPPCOL.DOC for help with color values.


TNC SET UP

This program uses hardware handshaking.  Your TNC should also be
set for no parity and 8 bit words.  If you plan to do binary file
transfer with YAPP (Yet Another Packet Prototcol) be sure that
the TNC type is set correctly.  TNC type 0 is used for testing
and does not send the commands to place the TNC into transparent
mode.  TNC type 2 sends a break signal to place the TNC into
command mode when necessary, while TNC type 1 uses the control-C
method.  The most common problem is with cabling.  Be sure that
your cable connects pins 1-8 and pin 20 for your serial port to
your TNC.

To enable Hardware handshaking be sure the following are set:

START 0
STOP  0
XFLOW OFF
XON   0
XOFF  0

If you are using split screen mode, you will probably want:

FLOW OFF
ECHO OFF

Other suggested parameters are included in TNC1.SET & TNC2.SET
which should be included on the program diskette.


COMMAND SUMMARY

The following commands are available from YAPP

F1    -  Display Help Menu
F2    -  Toggle printer on/off
F3    -  End File Capture
F4    -  Begin/Suspend File Capture
F5    -  Send text file
F7    -  Send binary file
F8    -  Receive binary file
F9    -  DOS Gateway

Alt-B    Send Break
Alt-C    Connect
Alt-D    Directory
Alt-E    Echo mode toggle
Alt-F    Change Defaults (port, baud rate & TNC type)
Alt-P    Strip 8th bit (parity) toggle
Alt-S    Split Screen toggle
Alt-T    Send Time & Date
Alt-S    Split Screen toggle
Alt-W    Write Scroll buffer to disk
Alt-X    Exit

All characters that scroll off the top are saved in the "scroll"
buffer.  You may redisplay this buffer by pressing Home, PgUp, or
the UpArrow.  Home starts from the oldest available screen in the
buffer.  PgUp shows the previous screen, and UpArrow the previous
line.  Once you are reviewing the scroll buffer, you may use PgDn
or DownArrow to move forward through the buffer.  End will exit
the review mode.

There are times when you wish you had saved something that
scrolls off the screen.  Alt-W will write the entire contents of
the scroll buffer to disk.

When in split screen mode, all received characters are displayed
on the top portion of the screen and everything you type appears
at the bottom.  Only that appearing in the top portion will be
saved in the scroll buffer.  If you wish to print or capture
everything, you should turn off split screen mode.

You may also save information by pressing F4 to turn on capture
mode.  This will write all received characters (or everything if
you are not in split-screen mode) to a temporary disk file.
Pressing F4 again will suspend the capture, or pressing F3 will
complete the capture and ask you what to name the file.

F5 simply sends the contents of a file to the TNC.  You may use
it to send commands to the TNC or messages.

F7 is used to send a binary file using the YAPP binary protocol.
The receiving station must also be using the YAPP protocol.

F9 suspends the program and lets you run DOS commands.  To return
to YAPP type EXIT at the DOS prompt.



NEW FEATURES

A connect directory has been added to this version.  Simply edit a
text file called YAPP.DIR with the nickname you wish to use for a
station (up to 6 characters) followed by the connect path.

For example:

Jeff   WA7MBL v WA7MXZ-1
Wes    K7PYK

To connect, press Alt-C and you will be prompted for who you wish to
connect to.  Enter the name, and the connect message will be sent to
the TNC.


If you have been capturing a file and decide not to save it, you may
cancel the save at the time you close the capture by pressing the ESC
key when prompted for the file name.


It is now possible (although not recommended) to pass messages during a
binary transfer.  The receiver may type messages to the sender easily.
At present the send side only polls the keyboard occasionally, so the
sender wont be able to type more than a few characters.  This is just an
experimental addition to the binary transfer protocol.  Any text typed
during the transfer will be lost if it hasn't been sent before the end
of the transfer.  Also, attempting to send text during a file transfer
with someone using an earlier version of YAPP will result in the transfer
being aborted.