ftp.whtech.com/ftp.whtech.com.tar/ftp.whtech.com/club100/cat/vt100.exe/lha/VTDOC4.DO

Text File | 1991-08-07 | 15KB | 300 lines

100/100 supports a print screen function only.  If you want to
echo to the printer as the characters are received, you must
enter TELCOM (press F6) and use the ECHO (F5) function inside
TELCOM.

XON/XOFF

100/100 requires that XON/XOFF protocol be enabled.  It can't
support view mode without the ability to tell the host computer
to stop sending characters temporarily.  Beyond that, there are
several functions which take a fraction of a second to perform
and could cause lost characters, even at 300 baud if no XON/XOFF
protocol is enabled.  The program and all of the escape sequences
it must recognize, coupled with the slow LCD screen of the Model
100, keep performance well under 1200 baud without Fast Mode.
Even in regular TELCOM, the Model 100 can't run faster than about
600 baud if the data is being displayed on the screen.

The CODE 'x' key combination supports a special feature of
toggling the XON/XOFF protocol within the emulator.  If you think
you might need this feature, Appendix A explains this feature as
well as possible uses for it.

RELOCATING VT100.CO

VT100 can be relocated to any memory location you desire in order
to avoid conflicts with other machine language applications you
may have.  To do this you must locate the second program on your
tape called VTLDR, immediately following VT100.CO.  On disk, this
program is VTLDR.BA.  If downloaded from a bulletin board, it is
probably called VTLDR.DO.  When run, this program will install a
copy of VT100.CO at any memory location.

If you don't know how to locate a particular program on a tape,
you can simply put the tape at the beginning and type:

RUN "CAS:VTLDR"

It will take a while, but it will eventually find VTLDR and run
it.  If you have a disk, simply load it from disk and run it, or
run it directly from disk if you have a DOS which allows you to
do so.

The loader program will prompt you for an ending address.  This
address should be the lowest address of any machine language
programs you already have installed minus one.  This will put
VT100 immediate below your other programs.  The program will then
run to completion and save the results as VT100.CO for you.  You
can then save this copy to disk or tape.

If you wish to use VT100 with DIRACC as described below, relocate
the program before loading DIRACC.

DIRACC 100 and 100/100

100/100 is completely compatible with DIRACC 100.  DIRACC by Hugo
Ferreyra is  a program used in conjunction with TELCOM to allow
you to enter TEXT and BASIC while maintaining your online
connection.  In this way, you are able to create and edit files
off-line, using the Model 100's built-in TEXT program and then
upload them.  Or you can enter BASIC and kill files to create
more space for downloading of documents.  If you have a disk
drive which uses the system bus, you can save to and load files
from the disk while in BASIC, then return to TELCOM and the VT100
emulator.

Locate the file DIRACC.BA on our disk or tape, or download
DIRACC.DO from you bulletin board.  If downloading, use the
original version, not the version which supports no-scroll
downloading.

If you require no-scroll downloading, this version of 100/100
(v1.2) supports that feature.  Pressing CODE 'd' while in the
VT100 emulator will bring up the 'File to Download?' prompt.  You
can then download with the screen locked.  Press F7 to stop
no-scroll downloading, rather than F2.  See the paragraphs above
titled "Fast Downloading" for further and more complete
documentation as to how to use the no-scroll feature.  Enough
digression, now back to the DIRACC program.

DIRACC consists of a BASIC program which loads a small machine
language program.  Once loaded, the F6 key in TELCOM enters
BASIC, and the F7 key enters TEXT.  To be compatible with DIRACC,
100/100 redefines the function keys 6 and 7 as described in the
above documentation.  After 100/100 is loaded, the F7 key becomes
the DIRACC key.  When pressed, F7 will bring up the prompt,
"<T>ext or <B>asic?".  Responding with 'T' or 'B' will then enter
the appropriate application.  In this way, the F7 key serves the
functions of both F6 and F7 in DIRACC, leaving F6 free to use in
entering 100/100 from TELCOM.

The DIRACC loader program should be run after 100/100 is loaded
into memory.  Then, to activate it for the emulator, the utility
program DIRPOK.BA should be used.  This program is located after
100/100 on your tape, or is on your disk.  It can also be
downloaded from your bulletin board.

Run this program and it will poke the proper addresses into the
already loaded version of 100/100.  (Type "LOADM "VT100" to
insure it is loaded before running DIRPOK).  You can then save
DIRACC and VT100 as one program to insure that you always have
both loaded.  Once you have activated DIRACC by running DIRPOK,
pressing F7 in TELCOM should only be done if DIRACC is loaded.
Otherwise, you may experience serious consequences (i.e.
coldstart).  If you save the two programs (VT100 and DIRACC)
together as one program as described in the summary below, and
always enter TELCOM through the VT100 program, you will always be
safe.  If you remove the VT100 program you should remove the
TELCOM function keys definitions as well.  See SECTION III,
"Deactivating 100/100" on how to do this.  Until running DIRPOK,
the F7 key in TELCOM will bring up the 'Text or Basic' prompt,
but either choice will simply return directly to TELCOM.  This
allows you to use 100/100 without DIRACC.  A second utility
program on your program tape or disk called DEFKEY.BA will allow
you to redefine F7 to show files and free memory while online
See "Using 100/100 Without DIRACC" below.

When you run DIRPOK it will prompt you for the starting address
of DIRACC and VT100.  If you have not relocated VT100 and have
put DIRACC immediately below it in memory, you need only to press
the carriage return at the prompts.  Even if you have relocated
the two, as long as DIRACC is loaded at HIMEM and VT100.CO
follows immediately, you may press C/R at the prompts.  The only
time you need to actually type in the addresses is when you have
another machine language program loaded below DIRACC (i.e HIMEM
and start address of DIRACC are not the same) or when DIRACC is
not loaded immediately below VT100.  If you load VT100.CO
(original or relocated), then immediately run the DIRACC loader,
then immediately run DIRPOK, you will always be safe.

Remember, DIRACC is only available from TELCOM.  If you are in
the VT100 emulator, you must first press F8 to exit to TELCOM,
then F7 to get the DIRACC prompt.

In summary, to use DIRACC with 100/100:

1.  Load 100/100 into memory as described in the loading
instructions.

2.  Run DIRACC.BA/.DO

3.  Run DIRPOK.BA/.DO

4.  Save the two as one program by typing
    SAVEM "VT100D", 59402, 62960, 59554
     59402 is the beginning address of DIRACC
     62960 is the ending address of VT100.CO
     59544 is the beginning address of VT100.CO

USING 100/100 Without DIRACC

100/100 can be used without DIRACC exactly as it comes to you.
Pressing F7 while in TELCOM still brings up the 'Text or BASIC'
prompt, but no matter what response is given, the program
immediately returns to TELCOM.  This is why you need the DIRPOK
program explained above to activate DIRACC.  If you wish to use
the F7 function key for something else while in TELCOM, you can
redefine it by running DEFKEY.BA, found on your program tape or
disk.

DEFKEY allows you to place two calls into the VT100 program which
will be executed whenever you press the F7 key in the TELCOM
program.  The calls will be executed one after the other, without
prompts.  If you run DEFKEY with the defaults, it places the
calls to show files and free bytes.  In other words, after
running DEFKEY, anytime you press F7, your files will be
displayed and free bytes immediately after.  The F7 key will now
jump to VT100.CO which handles these two calls.  If you remove
VT100.CO, you must also remove the function key definition.  See
SECTION III, "Deactivating 100/100" for details on how this is
done.

DEFKEY also lets you define your own calls to be used with F7
within TELCOM.  If you have a small machine language program
(that ends with a RET and not a jump to MENU), or wish to use two
other ROM calls you can define those within DEFKEY.BA.  Just as
with the defaults, these two calls will be called, one
immediately after the other.  If you wish to only define one
call, then call 32755 with the second call, since this is a
simple return.


                           SECTION III

ADDITIONAL NOTES

FREE BYTES REQUIRED: 100/100 requires 2037 free bytes in order to
run.  Upon entry from TELCOM, the program creates a .DO file
exactly 1923 bytes long.  This file is used for storing the bytes
of the 80 column by 24 line screen.  This file is named
[SCRN].DO, but you should never see it.  It is automatically
created when you press F6 in Telcom, and automatically deleted
when you press F8 to exit back to Telcom.  By using a DO file for
storing the screen information, 100/100 avoids conflicts with any
other M/L programs, or having to reserve extra memory.  It will
use 2000 bytes, anywhere it happens to exist.  If for some reason
the program aborts (such as batteries run out and M100 turns
off),  this file will not be deleted.  However, as long as it
isn't edited, it can and will be used when the program runs
again.  In that light, it would use any file named [SCRN].DO so
you should never create a file with that name.

SCRATCH SPACE:  Every attempt has been made to make 100/100
compatible with other machine language programs and ROMS.  As
mentioned above, the screen memory is stored in a .DO file to
avoid any conflicts with reserved memory.  100/100 also uses a
small scratch pad area in the area reserved for the previous
screen in the TELCOM application.  This scratch space is freed up
in returning to TELCOM, so no conflicts are possible there.
100/100 should be a very "clean" application that can coexist
with whatever other software you use.

TESTING THE PROGRAM: You may want to insure that 100/100 is
loaded properly and working before actually going on-line.  This
testing can be done through the serial port without anything
connected.  Run VT100 which will enter TELCOM.  Press F3 and set
the STAT to 37I1E or some valid parameter which doesn't start
with 'M'.  Now press F4 to enter terminal mode, then F6 to enter
VT100 mode.  The TELCOM label line will disappear if VT100 is
working.  Press LABEL and you should see 'r1 c1' in the lower
left corner.  Press F1 and the cursor should move to the lower
right corner.  You are in view mode now.  Press PASTE and it
should return to the upper left corner as you exit view mode.
Press CODE x twice and you should hear one beep.  If all this
works, VT100 is working.  Press F8 to exit VT100 mode, then F8
again to exit TELCOM.

TAB STOP LIMITATION: 100/100 recognizes only 10 tab stops.  The
default tab stops which come with the program are at every eighth
character.  The SETUP.BA program can be used to change these
defaults.  Programs on the host can also change these tab stops,
but only the first ten stops are recognized.  The first ten
represent the first ten from left to right, not the first ten set
chronologically.  If ten tabs have been set and an eleventh one
is set before an existing one, the right most tab stop will be
lost.

LINE DRAWING MODE:  100/100 supports a subset of the VT100 line
drawing mode.  The program will interpret correctly the
characters used to actually draw lines and boxes, but the special
characters such as the tiny two character combinations, the pie
and English pound symbol, and some others are not translated.  If
you use applications which use these unsupported special
characters, you will see the wrong characters printed, lower case
alphabetic characters instead of the special character.  Other
than that, the program will run just fine.

The special line drawing characters are supported only as the
secondary character set.  What that means refers to the way the
VT100 defines the character sets it will use.  An application
running on the host has the ability to select a primary character
set (called G0) and a secondary character set (called G1).
100/100 supports only the regular character set as G0 and the
line drawing character set as G1.  If the application sets the
line drawing character set as G0 instead, this will be ignored by
100/100, which will continue to print the regular characters
only.  It is rare that the character sets are reversed, so this
should not be a limitation

BACKSPACE:  On the Model 100, the DEL/BKSP key generates ASCII
code 8.  SHIFT DEL/BKSP then generates ASCII code 127 which is a
delete.  Since most of Digital's computers interpret the code 127
to be backspace which erases the character immediately left of
the cursor, this key has been redefined inside of 100/100 to
produce 127 instead of 8.  If you need a true backspace character
(8), then SHIFT DEL has been swapped with BKSP to produce that
code.  For example, on CompuServe, you may need to do a SHIFT DEL
to backspace in VT100 mode, but only press BKSP in TELCOM mode.

DEACTIVATING 100/100:  If you remove VT100.CO, the definitions
for the F6 and F7 function keys remain within TELCOM.  These must
be deactivated to prevent jumping to non-existent code if pressed
while in TELCOM.  To do this, type in this small program and run:

     10 POKE 64268,243:POKE 64269,127
     20 POKE 64270,243:POKE 64271,127

Now pressing F6 or F7 in TELCOM will produce no results.

THE VT100 APPLICATION KEYPAD: 100/100 will emulate the keypad of
the VT100.  To do this, the GRPH key plus one of the keys used
with the NUM key are used.  For example, pressing GRPH plus 'm'
will produce the VT100 keypad zero since the 'm' key also has a
zero on it.  See the illustration at the end of SECTION I for a
complete description of all the VT100 keypad keys.

At this point, a brief explanation of how the VT100 keypad works
would probably be helpful.  Each key on the VT100 keypad is
capable of producing one of two possible codes.  In normal mode,
each key produces exactly what is on the keycap.  The zero key
would produce a zero, exactly as if you had pressed the zero key
on the top row of the keyboard.  In application mode, an escape
sequence is sent.  The host application is rfponsible for turning
application mode on and off on a VT100.  However, in the 100/100
program, this switching is not automatic.  You must determine
whether the host application is expecting an escape sequence and
press the GRPH key combination, or whether it is expecting a
number and press the NUM key combination

In most cases, it is easy to determine what the host application