Anzio
Anzio
The information contained within this document is subject to change without notice. No
warranty of any kind is held in regards to this material.
The original nor any of the backup copies shall be sold, leased, gifted or otherwise be
transferred or used by any other party, other than the purchaser, or on more than one
machine at any given time. Purchaser may not under any circumstance tamper with
any copyright protection scheme in use on the ANZIO distribution media.
The liability of Robert Rasmussen and Rasmussen Software, Inc. shall not exceed the
cost of the software. Neither Robert Rasmussen nor Rasmussen Software, Inc. can
be held responsible for any damages due to loss of data that may result in loss of
dollars.
Acknowledgments
Windows is a registered trademark of Microsoft Corporation
Other product names are trademarks of their respective owners.
Printing History
Edition 8.6r March 1988
Edition 9.0 November 1988
Edition 9.0 Second printing December 1989
Edition 9.5 February 1990
Edition 9.7 March 1993
Edition 9.8 June 1993
Edition 10.9 July 1996
Edition 11.0 November 1996
i. TABLE OF CONTENTS
i. TABLE OF CONTENTS..............................................................
ii. INTRODUCTION........................................................................
ii.1 KEY FEATURES................................................................
ii.2 HOW THIS MANUAL IS ORGANIZED...........................
PART I. NARRATIVE.....................................................................
1. USING ANZIO..............................................................................
1.1 INSTALLING ANZIO.........................................................
1.1.1 INSTALLING THE FILES TO THE PC.................
1.1.2 INSTALLING THE TRANSFER PROGRAMS.....
1.2 HOOKING UP THE PC.......................................................
1.2.1 WIRING THE CABLE............................................
1.3 STARTING THE PROGRAM.............................................
1.4 GETTING YOUR PARAMETERS STRAIGHT................
1.4.1 OPERATING SYSTEM...........................................
1.4.2 PORT........................................................................
1.4.3 BAUD RATE............................................................
1.4.4 TERMINAL TYPE..................................................
1.5 GETTING ACQUAINTED.................................................
1.6 LOGGING ON.....................................................................
1.7 USER PREFERENCE ITEMS............................................
1.8 TERMINATING THE PROGRAM....................................
1.9 MEMORY-RESIDENT OPERATION...............................
1.9.1 RUN..........................................................................
1.9.2 STAY........................................................................
1.9.3 MEMORY USAGE..................................................
1.10 CONFIGURING YOUR HOST SYSTEM........................
1.11 TERMINAL TYPES..........................................................
1.11.1 DEALING WITH FUNCTION KEYS..................
1.11.2 USING A TERM TYPE OF "ANZIO"..................
6. THE m KEY...................................................................................
6.1 USE AS A FREESTANDING OPERATION.....................
6.2 IN A DEFINED KEY..........................................................
6.3 INVOKED FROM THE HOST...........................................
6.4 THE EDITING KEYS.........................................................
6.5 A SPECIAL USE: COMMAND LINE EDITING..............
7. USING A MODEM.......................................................................
7.1 THE DIAL COMMAND.....................................................
7.1.1 MODEM RESPONSE CODES................................
7.2 THE WAIT COMMAND....................................................
7.3 SIGNING OFF.....................................................................
7.4 BAUD RATE SHIFT...........................................................
7.5 FLOW CONTROL...............................................................
9. PRINTING.....................................................................................
9.1 HOW TO PRINT.................................................................
9.1.1 PRINTING THE SCREEN......................................
9.1.2 CAPTURE TO PRINTER........................................
9.1.3 PASSTHROUGH PRINT.........................................
9.1.4 FILE TRANSFER TO PRINTER............................
9.2 THE WPRN PRINTER MODULE......................................
9.2.1 PRINTER SETUP....................................................
9.2.2 CHOOSING A PRINTER........................................
9.2.3 CHOOSING A FONT..............................................
9.2.4 THE FLUSH TIMER...............................................
9.2.5 LOW-LEVEL PRINT..............................................
9.2.6 THE PRINT WIZARD.............................................
9.2.6.1 AUTOMATIC TEXT HANDLING.............
9.2.6.2 PRINT WIZARD’S MARKUP
LANGUAGE........................................................
12. COMMANDS..............................................................................
12.1 COMMANDS BY TYPE...................................................
12.1.1 OPERATOR PREFERENCE ITEMS....................
12.1.2 COMMUNICATION PARAMETERS..................
12.1.3 FILE TRANSFER..................................................
12.1.4 LOCAL PROCESSING.........................................
12.2 COMMANDS ALPHABETICALLY................................
7E1.....................................................................................
7E2.....................................................................................
7N1.....................................................................................
7N2.....................................................................................
7O1.....................................................................................
7O2.....................................................................................
8E1.....................................................................................
8E2.....................................................................................
8N1.....................................................................................
8N2.....................................................................................
8O1.....................................................................................
8O2.....................................................................................
ANSWERBACK <string>.................................................
AUTO-LF [ON] | AUTO-LF OFF.....................................
BACKSPACE 8 | BACKSPACE 127...............................
BAUD <nnnn>...................................................................
BEEP [ON] | BEEP SLOW | BEEP OFF..........................
FLUSHTIMER <value>....................................................
FONT <size> | FONT LARGER | FONT SMALLER.....
FULL [DUP] | HALF [DUP].............................................
GAUGE [ON] | GAUGE OFF...........................................
HALF [DUP].....................................................................
HELP..................................................................................
HELP <keyword>..............................................................
HOLD [ON] | HOLD OFF | HOLD TOGGLE.................
HOSTNAME/S..................................................................
HOTKEY <xyy>...............................................................
IGNULL [ON] | IGNULL OFF.........................................
IMOS..................................................................................
INTERPRET......................................................................
INVOKE <macro>............................................................
IRQ <n>.............................................................................
ITX | IRX | IMOS | RMCOS | VRX | UNIX....................
JUMP OFF | JUMP MEDIUM | JUMP FAST..................
KCOMMAND <command> [<parameters>]....................
KEEP [<x1> <x2> <y1> <y2>]........................................
KEEP/N [<x1> <x2> <y1> <y2>]....................................
KEYS.................................................................................
KRECEIVE [<filespec> [AS <filespec>]]........................
KSEND <filespec> [AS <unixfilespec>]..........................
LAUNCH <program> [<parameters>].............................
LINE [DELAY] <nnn>.....................................................
LOCK [ON] | LOCK OFF | o ............................................
LOG [<unit>:]<directory>................................................
MENUBAR <x1> <x2> <y1> <y2> <x3> <x4> <off>
<len> [<cols>]...............................................................
MERGE <filename>..........................................................
MESSAGE <string>..........................................................
MKDIR <dirname>...........................................................
MKDIR/S <dirname>........................................................
MODE-132 <xx>...............................................................
MONITOR [ON] | MONITOR OFF.................................
OPENI <filename>............................................................
OPENI/S <filename>.........................................................
OPENO <filename>..........................................................
OPENO/N <filename>......................................................
OPENO/S <filename>.......................................................
PAN <n> | PAN LEFT | PAN RIGHT..............................
INDEX................................................................................................
ii. INTRODUCTION
While ANZIO is running, the PC behaves very much like the terminal it
is emulating. The host system thinks it has a terminal attached, and
displays information accordingly. Keys you hit send characters to the
host. Function keys and special keys such as } are usually configured to
send certain control-character sequences to the host system, although
certain key combinations allow you to exercise control over the PC and
ANZIO itself.
ANZIO generally uses the bottom line of the screen (or window) for
special functions and messages. As a rule, anything that you type on the
bottom line is not sent to the host.
aX
File transfer
Several file transfer protocols are included, as appropri-
ate to the particular host system.
Configurability
The user can configure many "comfort" features, such
as colors, non-blinking cursor, status/gauge line, and
beep pitch and control.
Fonts (Windows)
The user can select any fixed-space font to use on the
screen, including such character sets as Cyrillic and
Greek.
Font sizing (Windows)
The user can scan through available font sizes, with the
window following. Or, ANZIO can take over the whole
screen, with font sizes chosen to fit.
Clean-screen approach (Windows)
Under Windows, the program adds as little as possible
to the screen layout.
Alternate screen widths
DOS versions of ANZIO can deal with 132-column
hardware capabilities, or can maintain a 132-column
virtual screen on an 80-column actual screen. Windows
versions intelligently handle 80 and 132 column
screens, as well as custom screen sizes.
Memory-resident operation (DOS)
DOS versions of ANZIO can be pushed into the back-
ground, and then can pop up at the stroke of a hotkey.
ANZIO can also shell to DOS.
Cut-and-paste
Columns of data on the screen can be picked up and
written to a disk file in comma-separated values format,
to be imported into spreadsheets and word processing
programs. Under Windows, part or all of the Window
can be copied to the clipboard (in both text and bitmap
mode), and text from the clipboard can be pasted to the
host program.
Printer control
From within ANZIO, the user can send the printer setup
control characters. Also, ANZIO can deal with more
than one printer connection. Windows versions can set
printer font and size, or let Print Wizard handle the task
automatically.
Mouse actions (Windows)
Several options are available for how ANZIO deals with
various mouse-click combinations.
Calculator
A built-in calculator allows 4-function arithmetic in
decimal or hex.
High-level screen commands
Certain commands can be sent from a host program
written specifically to support ANZIO, allowing easy
menus, boxes, windows, and area fills.
Online help
ANZIO contains a system of online help information on
all commands.
Multiple emulations
ANZIO emulates the essential terminal types: VT220,
SCO ANSI, AT386, Wyse 50, Wyse 60, Versyss C332,
ADDS Viewpoint/NCR 7901, and NCR 7900.
Local operations
ANZIO allows many local operations, such as DIR,
RENAME, TYPE, LOG, etc.
The last part is a group of appendices. Check through them for helpful
information that might apply to your particular installation.
PART I. NARRATIVE
1. USING ANZIO
In this section, you'll learn how to get the ANZIO program up and run-
ning. This involves making the correct physical hookup, starting the
program, and doing a little configuration. In most cases, fortunately, the
configuration is quite easy. The subsections will tell you how to save
your settings so you won't have to go through that again.
ANZIO can be installed to and run from any disk accessible to your PC --
floppy, local hard disk, or networked disk. It cannot, however, be run
from the distribution disk, because the files are compressed there.
The installation process consists of two phases. First, you will install the
necessary files to your PC disk, using a simple procedure listed below.
Then, depending on your host system type and your file transfer require-
ments, you may transfer certain programs from ANZIO to the host
system.
If you are installing ANZIO onto a hard disk, you may want to put it in its
own subdirectory. If you don't understand about subdirectories, ignore
that for now and get a good book soon on hard disk management.
Put the distribution disk (disk 1) in the A drive (or any available diskette
drive).
For DOS: Log to the disk drive that contains the original disk, such as:
A:f
INSTALL <dest>f
where <dest> is the disk (and directory) where you want to put ANZIO,
and <op-sys> is your target operating system as defined above. Do NOT
put in the less-than or greater-than ("<", ">") symbols. Some examples:
INSTALL C:\ANZIODIR f
INSTALL D:f
The INSTALL batch will take you through the whole process. If some-
thing goes wrong in the installation process, there is no harm in trying it
again. If you continue to have problems, please call us.
Along with the ANZIO program on the distribution diskette, may be in-
cluded a series of transfer programs to be loaded to the host computer.
By following the procedures for a simple upload found in Part II (File
Transfer) for your particular host operating system, it is easy to move the
proper files from the distribution diskette to your host. These will then
need to be compiled on the host in order for file transfer (other than a
simple upload) to take place.
If your host system does not have the appropriate compiler (such as "cc"
on a UNIX system), there may be other ways to install file transfer
programs. First, check the file "READ.ME" on the distribution diskette.
Then, if you still have questions, please call us.
The physical hookup between your PC and your host machine is usually
very simple. Keep in mind that the host machine "thinks" that your PC is
a terminal (a CRT). So the cable coming from the host is the same kind
of cable that would otherwise go to a CRT. We recommend, in fact, that
you unplug a line from a CRT to use initially, because that way you'll
know that the line works and is properly configured, thus elimi nating one
potential source of problems.
Your PC must have a "serial port". This is the device by which the PC
talks to the outside world of host computers, modems, some printers
(serial ones), and other devices. Some PCs have a serial port "on the
mother board" as standard equipment. Other serial ports are contained on
add-in boards. An internal ("integrated") modem has its own serial port,
as well as the modem.
For DOS: ANZIO accesses the serial port at a very low hardware level,
using the specified PORT and IRQ, as explained below.
Finally, if your serial port is at an unusual location, you can store its
address in a location reserved by the BIOS, and have ANZIO reference
that location. This would be a very unusual situation. Please contact us
for more information.
If your IRQ does not correspond to the PORT as above, ANZIO now lets
you set it explicitly - see the IRQ command in the reference section.
WATCH YOUR GENDER! The serial port always has a MALE plug. A
25-pin female plug is probably a parallel printer port. If your cable from
your host system ends in a male plug, you will need a 25-pin female-to-
female gender converter (available from any PC supplier). This should
NOT be a "null modem" (a special type of adapter)!
Your serial port may instead have a 9-pin male plug (because of space
considerations). If this is the case, your best bet is to buy a standard 9-to-
25 pin adapter or cable (such as a modem cable), and a gender con verter
if necessary.
If you are using an integrated modem, it is simply plugged into the phone
jack. You may also be able to plug your phone into the modem.
Now that you've got it plugged in, you can get the program up and run-
ning.
For your initial venture into Anzio, just run the program.
For DOS: Change to the appropriate directory, and run the program. For
instance,
C: f
CD \ANZIODIRf
ANZIOf
The first thing ANZIO does is to try to read a "defaults" file called
ANZIO.DEF (for DOS) or ANZIOWIN.DEF (for Windows). This file
can contain all the system settings for such things as baud rate, tabs, etc.
It will not exist the first time you run the program, so the program will
ask you four questions: a) operating system, b) port, c) baud rate, and d)
terminal type. We'll look at each one closely.
ANZIO presents you with several options to tell it what the operating sys-
tem of your host computer is. This information is important for ANZIO
to make some educated guesses as to how to communicate and handshake
with the host machine. Enter the number that corresponds to your
answer.
1.4.2 PORT
ANZIO needs to know which serial port is connected to your host com-
puter. For a definition of serial ports, see section 1.2.1.
Your PC and your host machine must communicate at the same speed,
known as the baud rate. We'll assume that the host end is already set
(either through software or with switches), and we must match it. If you
don't know your baud rate, you might try to find out from someone who
manages your system, or you might try guessing - you won't hurt any -
thing.
If you are connected to a modem, you might need anything from 1200 to
38400. If not, it's probably 9600 or 19200. Enter the number.
After you answer these questions, ANZIO will make some assumptions
about several of its parameters. It will also try to read a sample macro
key file, named RMCOS.KYS (if you told it you were running with
RMCOS) or SAMPLE.KYS (if you told it anything else). By hitting any
key (or waiting 15 seconds), you will get beyond the banner screen to the
"live screen".
From the live screen, any "normal" key you press will go out through the
communication line to the host computer. Function keys and special keys
can either cause a special code to be sent to the host, or can invoke some
function native to ANZIO. We'll get into that later. For now, let's see if
we can communicate.
1.6 LOGGING ON
If you are connected to a UNIX system, but haven’t seen a login prompt,
just hit f. You should see the UNIX login prompt. At this point you can
enter your login name and password just as you would with a terminal.
AT (n) f
On IRX or ITX, you must log on. This is done the same as with a termi-
nal, using either bC and f, or b~. If your login doesn't "take" the first
time, you may need to try it again - hit o1 first to make sure your keyboard
is unlocked. See Appendix F on sample defined keys for a couple of
"login" keys.
If you get "garbage" on the screen, chances are that your BAUD rate is
incorrect. To try another baud rate, enter aM to get the "menu" screen,
then enter:
BAUD 9600f
or whatever rate is appropriate. An f will get you back to the live screen,
where you can try again.
Once you successfully log on, you will see the operating system's
"banner" at the top of the screen, just as on a normal terminal. Now try
running some of the host programs you are accustomed to running.
If something goes wrong at this point, you'll need to skip ahead in the
manual. Section 4. tells you how to enter commands. Section 12. details
all commands. We'll cover some common problems here.
If you see intelligible characters, but the positioning is all wrong, see
TERM.
If you see "foreign" characters, you may need to change PARITY and
DATA BITS.
1 If you have redefined function keys to emulate a terminal, see section 3..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
If you have gotten no response at all, you have a problem with a) your
PORT and/or BAUD setting, b) your serial port hardware, or c) your ca -
bling.
Now that you've gotten past the essentials, you may want to look at some
of the "user preference items". These are parameters that affect the way
the ANZIO "CRT" appears and sounds. We'll just mention some of the
commands here that you might want to investigate in chapter 11:
COLOR, CURSOR BLINK, BEEP, BEEP IDLE, PITCH, STATUS
LINE, and GAUGE.
If your screen hardware (i.e., your EGA or VGA card) can display 132
columns at once, ANZIO would like to know. That way, ANZIO can
respond to a command from your host computer to switch to 132-col umn
mode. The problem is that there is no standard "video mode" number -
each card has its own.
You'll find this information by checking the manual for that EGA/VGA
card. If your board can display 132 columns, find out what "video mode"
corresponds to 132 by 25. What we need here is a hex number. Once
you have determined that number, use it with the MODE-132 command.
For an example, see section 8.1.
If you have made changes to either the settings (the defaults file informa-
tion) or the defined keys (macros), and have not saved those changes, or
if this is your initial run, ANZIO will ask you if you want to save them,
and to what file names.
ANZIO can store your settings in two groups. One group is called
"defined keys", which we haven't gotten to yet. This group is stored in a
"key file". The other group is basically all of those parameters you saw
on the HELP screen. This second group is stored in a "defaults file".
Whenever you start up ANZIO, it will look for a defaults file called
ANZIO.DEF. If it finds one, it will load those settings. If it doesn't find
one, as in the first time you ran the program, it will ask you for the basics.
The defaults file can also tell the program to load a key file, thereby
recreating your whole setup.
At this point, we suggest you simply enter "Y" to save each file, and enter
f to accept each default file name.
ANZIO has two ways of staying in memory while you run something
else. These use variations of the RUN and STAY command.
1.9.1 RUN
The RUN command tells ANZIO to stay in place and run some other pro-
gram over the top of it. That is, if you tell ANZIO to
RUN WP.EXEf
it will load the indicated program. At the point that you are finished
using WP.EXE and quit from it, you will be returned to ANZIO.
ANZIO's screen will be intact, and your connection to the host should
still be good, unless the program you ran messed with the serial port.
Note that it is possible using this method to have either a macro key in
ANZIO or a command from the host computer cause the PC to execute a
particular program.
If you just do a RUN with no program name, ANZIO will "shell to DOS".
That is, you will end up at the DOS command line. From there you can
run any series of programs. To return to ANZIO, simply enter at the DOS
command line:
EXITf
1.9.2 STAY
STAYf
ANZIO will go to sleep, and you'll be back at the DOS command level.
Now run some other program, such as:
WPf
Once you are into your word processing program, you can at any point
enter
al
ANZIO can pop up on most video boards, over most programs that run in
text mode. If you will need to pop up over a program in graphics mode
(i.e., WP in preview mode, WORD in a graphics mode, 123 re lease 3,
etc.), you must do a STAY/G rather than a STAY the first time, in order
to save enough memory for graphics.
ANZIO can be unloaded at most times when nothing else is loaded on top
of it, by doing the normal END or aX command.
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
ANZIO is a complex, and therefore large, program. You may not be able
to run it and your other application(s), depending on memory re -
quirements and availability. There are two ways you may be able to
solve this problem. First, it is possible to reduce ANZIO's memory usage
at the expense of REVIEW memory. See section 13.3. Second, there is a
"stripped-down" version of ANZIO, called ANZIOS.EXE. See section
13.4.
ANZIO can NOT be loaded into high memory or extended memory, due
to its size.
In order for ANZIO and your host computer to communicate effec tively,
they must speak the same language. There are many aspects to this lan-
guage, including BAUD rate, PARITY, TERM type, DUPLEX, and
more. We have covered most of these.
On a UNIX system, these parameters are set up in three files. The file
"/etc/inittab" or "/etc/ttytype" determines the assumed terminal type for
each physical connection to the system. That file also references an entry
in the file "/etc/gettydefs", which can set parity, echo, etc. It is also
possible for each user to have a file (a shell script) named ".profile" in its
home directory, which can do things such as query for terminal type and
issue "stty" commands.
On an ITX system, all the parameters for each terminal are set in the
SYSGEN entry for that terminal line.
1 If you have redefined function keys to emulate a terminal, see section 3..
ANZIO, when set in VT220 mode, responds to control sequences for the
VT100, VT102, and VT220 (except for some obscure VT220 commands),
as well as some additional sequences we have defined. This is ANZIO's
most powerful operating mode.
The WYSE 60, on the other hand, allows character attributes, meaning
each location can have its own attribute, and attributes do NOT occupy a
position. This is a much preferred approach, and the one ANZIO uses.
However, most software for WYSE 50 will also work with ANZIO.
The WYSE also has an advantage in that its arrow keys send single-byte
control codes. Some software, notably "vi" under UNIX, seems to deal
better with this.
The NCR 7900 is not widely supported outside the NCR community.
Attributes are strictly field-level, occupying a screen position. Using a
7900 with some software requires disabling that software's use of at-
tributes in order to be consistent.
In conclusion, if you have a choice, set ANZIO for VT220 mode, and set
your host system for VT100, VT220, or ANZIO mode (see section
1.11.2).
Who owns the function keys? That is, if ANZIO is emulating a WYSE
60 (which has function keys), and you hit p, does that cause a certain code
to go to the host, or does it invoke ANZIO's HELP screen?
When you set ANZIO to emulate a certain terminal, it does NOT au-
tomatically adopt the function keys. This makes ANZIO easier to use if
your host software never uses function keys.
Likewise, ANZIO does NOT respond to function key downloads from the
host - this could cause much confusion.
If you would like to use function keys with your host software, you have
two choices. First, you can load one of our macro key files, such as 2
MERGE VT220.KYSf
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
The MERGE command reads the key file in, just like the READ com -
mand, but it leaves your assumed key file name the same as it was, and
does not wipe out any macro keys already defined.
If you define p to send a certain sequence to the host, you can still get
ANZIO's HELP screen in two ways. First, you can use ap, jp, or bp if you
haven't defined them also. Second, you can use aM.
When you use certain host software, this special key business can get
quite confusing. For instance, let's take the spreadsheet package 20/20.
The documentation for 20/20 will refer to the PAGE DOWN key. You
must then look in an appendix to determine that for the VT100, for in-
stance, a PAGE DOWN is equivalent to a <PF1> y. Now if you are using
ANZIO and you have loaded VT100.KYS, l on your keyboard will
generate the control code equivalent to the VT100's <PF1> key. So, you
could accomplish the PAGE DOWN by hitting ly. For simplicity's sake,
if you use 20/20 a lot, you might want to define your } key to send the
entire combination.
For ANZIO users with a UNIX host, we have provided some files to let
UNIX know your terminal is actually ANZIO. This has several advan-
tages: 1) many function keys and special keys are defined; 2) color is sup -
ported; and 3) ANZIO has some capabilities which go beyond those
found in a standard VT220.
Note that the ANZIO.TIC file assumes a color capability on your PC. If
you are running a monochrome PC, use "ANZIO-M" below instead of
"ANZIO".
Next, upload the file "ANZIO.TIC" to your UNIX system, using the
SIMPLE UPLOAD procedure listed in section 11.5.1. On UNIX, make
the name lower-case ("anzio.tic"). This file is a terminfo source file.
For the next step, you will need to be super-user (root). If you don't
understand that, you're in over your head here. Get help.
This tells UNIX to run the terminfo compiler "tic", reading the file
"anzio.tic". YOU WILL PROBABLY GET WARNINGS, since this file
has entries for both UNIX and AIX. Barring serious problems, however,
your UNIX will now consider "anzio" or "ANZIO" a legal TERM type,
for any program that uses terminfo. So set your TERM variable to
"anzio":
TERM=anzio;export TERMf
Note that if you have application software that uses a method other than
terminfo (such as Word Perfect), it will not understand a TERM of
"anzio". We are in the process of developing ANZIO definitions for
popular software -- contact us.
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
You have already seen that you can get some help just by hitting the aM or
the p key1. This brings up the HELP screen, which shows all the settings
and commands. It is, of course, brief. For more help, you can use the
online help file. To get information on a certain command, enter at the
"Function" prompt the word "HELP", followed by a space, followed by
the first word of the command in question. For instance, 2
HELP BAUDf
Two special options have been added to the HELP file. First, HELP
INDEX will produce a list of available topics (see below). Second,
HELP ASCII will show you the ASCII character chart with hex equiva -
lents.
At nearly any point in the program, you can hit aH for help. This will
bring up an index of topics on which you can get help. Simply move the
highlight to the appropriate subject, using the arrow keys, and hit f.
1 If you have redefined function keys to emulate a terminal, see section 3..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
Several of the function keys have special meanings to ANZIO. These key
assignments are displayed as part of the KEYS screen.
aU
is the same as o.
aM
performs the same function as p. That is, it brings up
the HELP or MENU screen.
aF
performs the same as q, above.
aA
performs the same as t, above.
b~
can also be used as a break key.
aX
exits from ANZIO.
aH
brings up ANZIO's HELP INDEX.
By now you may have noticed that, when entering functions, ANZIO lets
you get away with some "sloppiness". Let's take a look at exactly what
the program expects and needs at this point.
Commands to ANZIO, are entered in one of two places. First, you can
hit q or aM and enter the command at the bottom of the "live" screen.
Second, by hitting p or aM you get the "HELP" screen. It brings up a
screen showing you all the commands available to you, as well as the
current settings of all configuration options. At the bottom of this screen,
you can also enter commands, and see them immediately be updated on
the screen. When you are finished setting up, you can hit f to return to
your "live" screen. Here is what the program will allow as far as entering
commands:
2. The first word, which identifies the command, does not need to
be complete. It only needs to be long enough so the program can
distinguish it from some other command. So if you can't
remember how to spell "INTERPRET", use "INT". However,
the command "DEFINE" can not be abbreviated.
Some commands can get lengthy, so the program provides some editing
capabilities when working on the bottom line. The keys perform
functions as follows:
<BACKSPACE>
Deletes the character to the left of the cursor, and backs
up the cursor.
x, z
Move the cursor without changing the contents of the
line.
h
Switches between "insert" and "overtype" mode. An
INS indicator shows at the right end of the command
line.
c
Deletes the character at the cursor.
g
Takes the cursor to the beginning of the function entry.
d
Takes the cursor to the end of the line.
l
Erases all characters from the cursor to the end of the
entry.
r
When function keys are entered on line 25, they will show in reverse
video with the function key name, preceded if necessary by an 's' mean -
ing 'shift', a caret (^) meaning 'Control', or an 'a' meaning 'Alt'. Other
special keys will show appropriate names, or hex codes.
The line-25 entry can be up to 255 bytes long. When you move too far to
the right on the screen, the line will "slide" to accommodate you.
Defined keys are possibly the most useful function in ANZIO. Anywhere
you need to repeatedly type something, you can assign that "something"
to a single key. Then, rather than typing the entire sequence every time,
you can cause ANZIO to type it for you. Several special functions, listed
below, can be included within defined keys to further expand their
usefulness.
KEYSf
This will first display all system-assigned keys. Then it will show user-
defined keys. The key that is defined is shown first in reverse half video
(or its color equivalent), followed by its contents, followed by a space in
reverse half video to show where the end of its contents is. Any non-
ASCII character in the contents will be shown, in reverse video, either by
name or as a hex number; e. g., 01 for a <control-A>.
There are three general categories of keys that can be DEFINEd. The
first consists of all printable characters, from space (hex 20) to tilde (hex
7E). The second consists of "special" keys, including function keys,
named keys such as g, and a keys. The third set is control codes, that is,
hex 00 through hex 1F.
Function keys l through u can be defined four ways each: normal, with j,
with b, and with a. Also, if your systems supports keys <F11> and
<F12>, ANZIO will support them also, both normal and shifted.
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
Keys are defined with the DEFINE command. The format is: 2
where <x> is the key to be defined, and <string> will become its con -
tents. Note that the word DEFINE can not be abbreviated, and that there
must be exactly one space after DEFINE and one space after the
keystroke shown as <x>.
If you define a key that has already been defined, the old one will be de-
leted (without warning). If you define a key with no <string>, any defini -
tion in place will be deleted and nothing will replace it.
Defined keys may be edited as they are being entered by making use of
the command-line editing features explained in section 4..
A variation on this is also possible for a key that has already been de-
fined. That is, you can edit it rather than reenter it. To begin this, enter: 2
DEFINE <x>?
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
As soon as you enter the question mark (note that it does not have a space
before it), ANZIO will erase it and display the existing contents of the
key to the right. Now you can edit it as necessary, again using the
command-line editing keys discussed in section 4..
To copy a string from one key to another, begin editing the first one, then
back up and change the command. For instance, to copy the string
assigned to X to Y, enter: 2
DEFINE X?
by the key.
We strongly advise you NOT redefine aF, aM, aU, aA, or aX.
There may be some keystrokes that you don't want to allow the operator
(or yourself) to inadvertently send to the host system. Examples might be
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
1 If you have redefined function keys to emulate a terminal, see section 3..
DEFINE bC {}f
As you will see shortly, the curly braces have a special meaning, that in
this case causes nothing to happen - the bC will not be sent to the host.
After you have built a library of defined keys, you will probably want to
save them on disk so they can be reused. Simply enter: 2
SAVE <filename>f
This tells ANZIO to save all defined keys into a file named <filename>.
Be careful with this filename, since any existing file of that name will be
deleted in the process of saving these keys. Note that ALL user-defined
keys are saved.
You can also tell ANZIO to save the keys to its current key file name (the
file they were read from in the first place), by entering: 2
SAVEf
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
READ <filename>f
This will read a set of defined keys into memory. Any defined keys al -
ready in memory will NOT be erased, but they MAY be overwritten, if
the same key is defined in the file being loaded.
ANZIO keeps track of the name for the key file, in its "default" file, so it
will find them automatically the next time ANZIO is run.
To give ANZIO a clean slate (no function keys defined), from the DOS
prompt enter:
ANZIO NONEf
If you exit from ANZIO using END, STOP, STAY, or aX, and you have
not saved alterations to your defined keys, ANZIO will ask you if you
want to save them.
5.8.1 TABS
Tab characters may be included in the defined key by simply hitting the
<TAB> key. This will show as a reverse video TAB on the screen dur ing
the DEFINE process, but will take up only one keystroke in the defined
key. When the defined key is sent, the tab will be processed ac cording to
the current tab settings, just as though you had typed it.
Anywhere a f is required, use the vertical bar character, '|'. For example,
to create a defined key to get you into text editor on an I-system (see
UNIX example later), you might enter the following: 2
(this is all entered on one line). Once the E key has been defined like
this, any time you enter lE1, the PC will send this to the host: 2
AS EWF EWF(3)f
AS A TEXTFILE(2),OWf
AS LO (LP)f
EX $EDIT,REf
5.8.3 PAUSES
To wait for operator input in a defined key sequence, use the number
sign, '#'. When this character is found while transmitting a DEFINE
string, the ANZIO program will stop transmission, accept your entry up
to a f and send it (the f itself will not be sent). Then, transmission of the
key string continues with the character following the '#'. For example, to
create a key sequence to copy files on an I-system (see UNIX example
later): 2
DEFINE C AS A #(3)|
AS B #(1),NE,300,AP|
MOV A B|f
Then, when you enter lC, the PC will send to the host:
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
1 If you have redefined function keys to emulate a terminal, see section 3..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
AS A
Then it will wait for you to enter text (a file name). Any key you enter
will be sent, until (but not including) the f. The "defined key" then takes
over, and sends:
(3)f
AS B
and waits for another filename. Your filename is sent to the host. When
you enter f, the defined key continues with
(1),NE,300,APf
MOV A Bf
The PC is then finished transmitting its defined key sequence, and re turns
to normal text entry.
DEFINE C AS A
{Source filename}#(3)|
AS B {Destination name}#(1),
NE,300,AP|
MOVE A B|f
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
DEFINE v vi
{ENTER FILE TO EDIT}#|f
(entered on one line). Now, if you enter 1 lv, ANZIO will issue to UNIX:
vik
When you enter a file name, it will be sent to the host to complete the
command.
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
1 If you have redefined function keys to emulate a terminal, see section 3..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
The vertical bars (|) shown are necessary to terminate the embedded q
functions.
DEFINE S qOPENI #|
qTRANSMIT|f
5 .8.5.2 LINE EDITOR WITH m
An m embedded in a defined key will initiate the line editor. If there are
keystrokes in the defined key following the m, these will be processed by
the m editor until a vertical bar (|) is reached. If there are NO keys fol -
lowing the m, or a number sign (#) is encountered, the operator will be
given control. When the operator is finished with the line editor and hits
f, the line editor will process any remaining keys in the defined key (up
to a '|'), send the edited line to the host, and control will resume with the
rest of the defined key.
DEFINE { qREVIEW|{
will define the { key such that it will first take you into the REVIEW
routine, then feed that routine a {, telling it to show the prior screenful.
Because you may have a need to send one of the characters that cause
special actions in defined keys, we have given you a way to do that.
Simply prefix it with a tilde (~). Any character immediately following a
tilde will be transmitted, not interpreted. So, to program a key to send
'{A}', you would do:2
DEFINE a ~{A}f
The tilde here causes the left curly-bracket to be sent, rather than cause
the 'A' to be displayed locally.
Two of ANZIO's commands have been set up so that they can feed their
results to other commands. These are DIR/S and MENUBAR. For
instance, if you want to have a macro key open a file for transmission, but
you want to display to the operator a list of possible files, you can define
a macro to do:
The MENUBAR command would place a menubar over the existing file
names, and allow the user to select one. The selected name would then
be used to complete the KRECEIVE command.
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
For more complex macro key requirements, you can nest or branch macro
keys, using the CALL and INVOKE commands.
If a macro key contains the ANZIO command to CALL another key, that
key will be started. When the called key is finished, ANZIO will resume
processing the first (calling) macro.
The INVOKE command is similar, but it will NOT return to the calling
key.
6. THE m KEY
The m key1 invokes a powerful and flexible line/field editor that is usable
in most host systems. It can be a function in and of itself, or it can be
part of a more complex function built into a defined key.
In a nutshell, the m editor "picks up" the screen line on which the cursor is
positioned and reads it into a special buffer, then allows you to
manipulate it, and then sends the entire line or field back to the host
computer. If the displayed field uses video attributes (reverse, underline,
etc.), then the m editor will deal with a field (as wide as the current
attribute). Otherwise, it will deal with an entire line. When dealing with
the entire line, it assumes that columns 73-80 are a COBOL I-D area, and
treats them specially, as explained below.
Manipulation options include the ability to move the cursor either direc-
tion, or to either end of the line; typeover, character insertion and
deletion, tabbing both directions, and partial erasures. Many of these
operations duplicate those used in editing function entries on line 25.
The m editor can be invoked at the beginning, or in the middle of, a line of
entry on the screen. Ordinarily, it makes sense only when there is data on
the screen to be edited, but that is not always true. In order for you to
judge when it is appropriate, consider the steps that the m editor goes
through.
First, the program looks at the position of the cursor on the screen. If you
wish to select another line from the live screen, simply use the w and y
keys to select the desired line. The POSITION of the cursor on the line is
also important. If you have entered characters immediately BEFORE
invoking m, those characters have already been sent to the host computer,
and it is waiting for more. Let's call this spot the CURSOR START
POSITION.
1 If you have redefined function keys to emulate a terminal, see section 3..
Second, the program reads the screen memory for the entire field or line
in question into the editor buffer.
Then, you the operator are given a chance to modify the line's or field's
contents. This proceeds until a f is entered. Key functions for editing are
explained below.
Finally, the program sends the edited line or field to the host. If the
cursor start position (as explained above) was 1, the entire line/field is
sent. If it was not 1, and you never edited the contents of the line to the
LEFT of the cursor start position, that part of the line/field from the
cursor start position to the end of the line/field will be sent. If you
BACKED UP, that is moved to the left of the cursor start position and
changed something there, ANZIO will send the necessary
BACKSPACES, then the rest of the line/field.
The functions of the m key are the smallest logical unit. Most of the time
the use of m requires some additional jumping around, so it is embedded
into a defined key sequence.
CHf
This causes the editor to redisplay the line, then move the cursor to the
next line and allow us to reenter it. Finally the editor responds by
showing us the changed line again. Now let's see how a defined key
might make this easier (this sample is included in SAMPLE.KYS, see
Appendix F).
CH|{w}m
The 'CH|' goes through to the editor and says 'CH f'. After the editor dis-
plays the line and positions the cursor, the defined key takes over again.
The brackets ('{' and '}') mean that whatever is between them happens on
the screen only, without letting the host computer know about it. The w
shown here represents the cursor-up arrow key. So the cursor-up arrow in
brackets will move the cursor up a line, unbeknownst to the host.
Finally the m invokes the line editor, using the line where the cursor is
now positioned.
If the user terminates the editing with an w or y, ANZIO will tack that
keycode onto the end of edited field. The host program must deal with
that, of course.
Following are descriptions of the special editing keys used in the m line
editor. Any key that represents a normal character will either TYPE
If you are in "line mode", that is, there are NO video attributes on the
line, the line is treated as having two "sections", positions 1 to 72 and 73
to 80. If you are in field mode, you are dealing with only one "section".
<BACKSPACE>
Deletes the character to the left of the cursor, and backs
up the cursor. In line mode, if the cursor position is less
than 73, the deletion will not affect columns 73-80.
x, z
Move the cursor without changing the contents of the
line.
w, y
If the editor was invoked from the PC, grab data from
some other line on the screen. If invoked from the host,
send the edited data terminated by the arrow key's code
sequence.
h
Switches back and forth between INSERT and
OVERTYPE modes.
c
Deletes the character at the cursor. Again, if the posi-
tion is less than 73 (and you are in line mode), the I-D
columns will not be changed.
g
Moves the cursor to column 1 or column 73, depending
on which section it is currently in.
d
Moves the cursor to the position just beyond the last
non-space character in the section; that is, it will not
jump into positions 73-80 if in line mode.
l
Clears to spaces all positions from the current cursor
position to the end of the section.
<TAB>
Moves the cursor right to the next tab stop.
<BACKTAB>
Moves the cursor left to the next tab stop.
^
Escapes from the line editor - it does not send back the
edited line.
f
Terminates the process and sends the results back to the
host, followed by a <return>.
When you wish to edit a prior line, first hit the m. Then hit w one or more
times. Each time, the contents of a higher line will appear on your line.
When you have grabbed the right line, fix it. When you're done, simply
hit the f key and the line you just edited is sent to the host. Try it, you'll
be surprised at how often you use it.
7. USING A MODEM
You may need to have your PC talk to your host computer via a modem,
over a telephone line. The modem at the PC end can either be an
"internal" modem, that is a modem on a card inside the PC, or an
"external" modem, connected to the PC's serial port. The following
comments apply to both setups.
When you first bring the system up, you will be talking to the modem,
rather than to the host computer. Make sure you are in "LOCK OFF"
mode, or you won't get far. If appropriate, switch back to "LOCK ON"
after you connect. Also, be sure you work in upper case, as the modem
may not recognize lower case.
All commands to the modem start with "AT" for "ATTENTION". These
commands are NOT entered on line 25, but on the live screen.
Remember that ANZIO does not know it is talking to a modem instead of
a computer.
or for example:
This command tells ANZIO to dial the modem using <string> as the
phone number, if the connection is not made wait a certain amount of
time (<wait>, in 1/10 seconds), and then try again <retries> times. So the
example would send the string "5551234" to the modem (prefixed by cer-
tain characters needed to tell the modem that this is a number to be
dialed), the modem would dial the number and respond with a response
code. If the response indicates that a connection was made, the command
is completed. If a connection is not made, the PC would wait 10 seconds,
and try 6 more times (always waiting 10 seconds). If the connection was
still not made, an error message would appear, requiring an operator
response. The <wait> and <retry> parameters are optional.
If something goes wrong in the DIAL process, you can abort the opera -
tion by hitting t1, the panic button.
The parameter <string> can contain, prior to the phone number, any other
modem setup characters necessary, such as "T" for touch-tone. These
may be entered into a defined key also, such as: 2
By then pressing "lD", ANZIO tells the modem to dial touch-tone, the
number 0-555-2478, wait for four counts (a delay to wait for the
telephone company's computer to accept a credit card number) and then
enter the credit card number 1-2345-67-89.
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
1 If you have redefined function keys to emulate a terminal, see section 3..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
The WAIT command also has been added to facilitate certain types of
modem operations. In some applications, after the modems have made
their connection a pause is required before proceeding. This command is
used for that. The syntax is: 2
WAIT <nnn>f
Signing off is the process of disconnecting the modems, and "hanging up"
the phone line. Either modem can initiate the process, depending on the
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
host operating system. When one modem hangs up, the other will detect
that and hang itself up, notifying the computer to which it is connected.
The general convention for making the host end hang up is to enter the
command "exit" or "BYE" to the host. This tells the host that the session
is finished, and the host tells its modem to hang up (this may not work on
all operating systems). When the modem on your end detects the hangup
("carrier drop"), it will give you a response code, and place you back into
the mode in which you are talking to the modem.
To hang up the modem from your end, you must regain control of the
modem. On the Hayes compatibles, the standard method for this is to
enter "+++" with no f. That is, the modem must see these characters with
a pause both before and after. The modem will then drop into
"command" mode, but the phone line will still be "off hook". Then tell
the modem
ATH0f
This tells it to go "on hook", or hang up the phone. If all else fails, you
can turn off the modem and turn it back on again.
Many modems will do a "baud rate shift", which means the baud rate
between PC and modem is different from the baud rate over the phone
line (modem to modem). This introduces a chance for problems.
Assume you have a 9600 baud modem, and your ANZIO is set to 9600
baud. You dial into a remote host that has only a 2400 baud modem.
Generally, your modem will "sync up" with the remote modem, and start
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
But now you modem must make a decision: at what rate will it talk to
you? First, it can assume you want to talk at the modem-to-modem rate
(2400), and start doing so. Or, it can continue to talk to you at 9600, but
internally buffer data and do a baud rate shift. The modem makes this
decision based on one of its parameters.
If your modem responds the first way (by changing its baud rate to you),
there will be problems. ANZIO has no way to recognize this shift, and
will from then on fail to communicate with the modem. So, your modem
MUST be configured the second way, to do a baud rate shift.
Note that the same problem exists on the host end - if your host end
modem changes its baud rate, the host system may no longer be able to
communicate.
When a modem is doing a baud rate shift as above, and in other situations
as well, flow control is necessary. There are many nuances to flow
control: hardware vs. software, whether the software codes are passed
through, etc. We are working on this area. Please contact us if you have
problems you believe are related to flow control.
There are three ways to change the video mode. First, you can set it
before you run the program. ANZIO will then initialize itself according
to that setting. Second, you can use the RUN (or RUN/N) command in
ANZIO to run a mode-setting program that was provided with your video
board. On return from any RUN, ANZIO checks its parameters and
readjusts as necessary. Third, ANZIO has a SCREENMODE command
which MAY be able to set your hardware to the mode you want.
Most boards will have a "BIOS mode number" that corresponds to 132 by
25. This information would come from the documentation on your board.
Let's say for purposes of demonstration that it's a hex 55. You can then
tell ANZIO to set up that mode by doing: 2
SCREENMODE BIOS-55f
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
You could then switch back to normal color mode (80 by 25) by doing: 2
SCREENMODE COLORf
You can also tell ANZIO what the correct mode number is for 132 by 25
operation, by doing:2
MODE-132 xxf
where <xx> would in this case be 55. Once ANZIO knows this informa-
tion, it can switch to 132-column mode in response to a control-code
sequence from the host. You could also then switch it manually using: 2
SCREENMODE 132f
Note that the software on the host system may not work particularly well
with other than the standard screen size. It may assume, for in stance, that
moving the cursor past line 24 position 80 will scroll the screen. We give
you the tools, you figure out if you can use 'em...
The virtual screen width is set using the WIDTH command. Note that
you can set the WIDTH greater than the physical width, but you can NOT
have the WIDTH less than the physical width. That is, if your video
hardware is showing 132 characters, WIDTH must be 132. For the
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
following discussion, then, we will assume that the screen shows you 80
columns, and WIDTH is 132.
In this mode, you can think of your screen as providing a window to your
data. Once there is data outside the normal 80-byte limit, you can see it
in one of three ways.
The PAN command moves your window back and forth horizontally. By
entering the following, you can move the ANZIO screen left, right, or so
it begins in a certain column: 2
PAN LEFT
PAN RIGHT
PAN <n>
You can also see this data in REVIEW mode, by scrolling in all four di-
rections. Note also that the g and d key are active in REVIEW mode.
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
9. PRINTING
ANZIO can print the currently active screen at any time. This can be the
“live” screen, showing the emulation session to the host, or any part of it.
Use the PRINT command for this. It can also be an internal ANZIO
screen, such as the HELP, INTERPRET, KEYS, or any screenful of the
REVIEW buffer, by variously entering “P” or “PRINT” from the
keyboard.
Printing the screen does not automatically eject the page -- see the expla -
nation of the FLUSH TIMER below.
WIN only
In Windows, you can also print the screen using the menu item File:Print
Screen, or its accelerator aP. Note that the menu item always goes to the
WPRN module, regardless of the setting of PRINTER. As such, it is
subject to the settings for printer selection, font, Print Wizard, etc.
ANZIO can capture to the printer any text coming to the screen (this text
will also show on the screen). This gives the user a way to start and stop
printing without altering what happens on the host.
Because ANZIO supports the accepted protocols for passthrough print for
all the terminal types it can emulate, it will work very well where the host
system already supports passthrough print. If you would like to do pass-
through print but do not have host support for it, contact Rasmussen Soft-
ware for more information.
For those who are creative, you can do file transfer (using Kermit, etc.),
specifying an output file named “LPT1”, “LST:”, or “WPRN” as
appropriate.
All these settings will be set into place, and used the next time you have
ANZIO print something. In addition, they will be tracked between
sessions in ANZIO’s settings file.
Because a Windows PC often has access to more than one printer, there is
a way in ANZIO to select a printer. You can direct ANZIO either to use
a specific printer, or to use whatever printer is the default. To choose the
printer, select File:Printer Setup, then choose “Setup”.
Use the menu item File:Printer Font to choose a font and size for your
printing.
All fonts are available to you, but some will work better than others.
Fonts that are fixed-space will do a better job of lining up columns.
TrueType fonts will give you more options for size. OEM fonts will do a
better job of printing line-drawing characters. A good choice meeting all
these requirements is “MS Linedraw” from Microsoft, available with
many of their software packages and also available for download.
Another alternative is “Courier New”, although it does not contain line-
drawing characters and so ANZIO will use “+” and “-”.
The font size you choose will directly affect horizontal spacing (therefore
characters per line) and vertical spacing (therefore lines per page),
UNLESS you are using the Print Wizard feature (see below). So if you
switch from printing an 80-column page to a 132-column page, you will
probably want to change your font size from 12 point (10 cpi) to about 7
point.
What is the end of a print job? At what point are you finished printing,
and ready to close the job, letting it work its way through the Windows
spooler and out to the printer? In a passthrough print situation, nothing
from the host indicates the end of a print job. So ANZIO has the FLUSH
TIMER.
You can set the FLUSH TIMER to a certain number of seconds. The de-
fault is 5. That means that if something has been sent to the printer, and 5
seconds go by without anything more being send to the printer, ANZIO
assumes you are done printing, and it flushes the job. So 5 seconds after
you do a screen print, or 5 seconds after your last passthrough print data
comes in, the information is printed on the printer.
If passthrough print data arrives sporadically from the host, with pauses in
between, you may need to increase your FLUSH TIMER. You may want
to disable this feature (by setting FLUSH TIMER to zero) -- in this case,
the job will be closed only when you do a File:Eject (menu item) or an
EJECT command, or when you quit from ANZIO.
So ANZIO offers you Low-level Print, in the File menu. If this is turned
on, ANZIO will send characters to the printer at a lower level, similar to
writing to a device in DOS, although spooling still happens.
If the data from the host contains escape code or PostScript code, turn
Low-level Print on.
When the Print Wizard is turned on, it will store and analyze data to be
printed, and automatically deal with such things as 80-column versus
132-column reports, backspace-underlining, embedded escape codes, and
line wrap.
Print Wizard also gives you a unique ability to control the printer, making
it possible for a host-based program to specify everything from paper ori -
entation to inclusion of bitmaps, in a device-independent manner.
ANZIO has the ability to track prior screens of information that have
scrolled by. These prior screens are kept in review memory and are ac-
cessible through the REVIEW command. ANZIO attempts to allocate up
to 64KB to use for this purpose. Each character position takes two bytes,
so that means you can have a maximum of 402 lines in 80-column mode,
and 244 lines in 132-column mode.
Ordinarily, ANZIO will store in its review memory any lines that are
scrolled off the top of the screen. In addition, if you turn SCROLL ON,
then any screens that are ERASED will be "scrolled" instead.
If you have WIDTH set to 132 (on an 80-column screen), you can also
use REVIEW to look to the right (or left) at characters that are out there
in the virtual screen.
REVIEWf
move the window to the far left and far right, respec-
tively
P
prints the current screen
REVIEW can also perform a split-screen function. That is, you can go in
to REVIEW, scroll back a ways, find something you want to keep on the
screen, and lock it in. That becomes the "REVIEW window", which
covers up anything you might have in that area of the screen. The fol -
lowing keys, used in REVIEW mode, manipulate the REVIEW window:
Once a review window is opened over the top of the original screen, you
must re-enter REVIEW in order to close that window with the m key.
Utilizing the PC means more than just terminal emulation. People want
the power to capture data directly from the host, either right off of the
live screen or through file transfer. ANZIO allows you to pick data off
the screen, or transfer ASCII sequential files, including spool files, to and
from the host.
This command works the same as the PICK command, except data is not
formatted on the PC; the data will appear in the file as it was displayed by
the host software. Using ANZIO just as a terminal, run the program to
display the information. Open an output file with the old familiar: 2
OPENO <filename>f
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
KEEP r
KEEPf
The PRINT command allows the user to print what is currently displayed.
Only the first “live” lines are printed, not the status line. This is done on
the command line: 2
PRINTf
In many cases we can transmit data directly into existing software on the
host system, and it will think we are typing it. In some cases the host will
limit us to 80-byte records. In nearly all cases we are limited to passing
ASCII data only (no packed numerics, etc.).
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
You will notice that the only software distribution medium we use is
diskette. When a module is needed on the host, we have included it in
source form on the distribution diskette. You will need to transmit it up
to the host, using the methods detailed in SIMPLE UPLOAD, and then
compile it. We assume you know how to compile a program; if not,
contact us, or get some help from a software house in your area. IF YOU
DO NOT HAVE A COMPILER, please contact us.
This system has very few remaining users, so we have a couple of holes
in our coverage. Contact us if you need to work in the IMOS-II envi -
ronment.
AS A <filename>(<unit>),
NEW,<size>,APf
AS EWF EWF(<unit>),OWf
EX $EDITf
IN*f
OPENI <pcfilename>f
TRANSMIT TRAILER \f
SA Af
QUf
AS A <filename>,NEW,<size>,APf
MOV SYSIN Af
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
AS SI <sourcename>(<unit>)f
AS BO <objectname>(<unit>),
NEW,<sectors>,APf
EX $COBOLf
AS A SEND-PC-S(3),NEW,200,APf
MOV SYSIN Af
aFOPENI SEND-PC.CBLf
aFTRANSMIT TRAILER END$f
AS SI SEND-PC-S(3)f
AS BO SEND-PC(3),NEW,200,APf
EX $COBOLf
f
The program will ask you for the name of the file to be created on the PC.
Answer that question - you may include a full path if needed. If the file
named already exists, the program will ask if you want to delete it. If you
answer "N", the program will terminate without transferring the file. To
transfer to the printer, use a file name of "LST:".
Now all you have to do is sit back and watch. If you don't want to see it
work, and want it to run somewhat faster, you can enter this command to
ANZIO:2
If you get a file status 95 or 98, it means that the file you are trying to
transmit doesn't match one of the file specs of the SEND-PC program.
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
To use the parameter file with SEND-PC, tell the host system:
AS PRM <prmfilename>(<unit)>f
EX SEND-PC(<unit>)f
Finally, it is possible to tell SEND-PC from the ITX command line what
file to transfer:
EX SEND-PC(unit) <itxname>(<unit>)
<pcfilename>f
AS A <filename>(<unit>),NEW,
<size>,APf
EX RECV-PC(<unit>)f
The program will ask you for the name of the file on the PC to be up -
loaded. Answer the question, using a unit designator if needed.
The program will then ask you what type of file you want to create,
listing several options. Select one.
RECV-PC at this point does not have options to a) use a parameter file, or
b) process command-line parameters.
AS LO <spoolfile>,NE,<size>,SP,APf
EX RECV-SPL-O(<unit>)f
The program will ask for the name of the print file on the PC to be up -
loaded. Answer the question, using the unit designator and directory
name as needed. At the end of the transfer the program will tell the
number of lines received by the host and the number of lines it had to
truncate (those over 132 bytes). The program assumes a standard print
file on the NCR host of 132 characters in length. However, several PC
products handle print files of greater length. RECV-SPL will truncate
these records to 132 characters.
As the program transfers the lines, they will appear on the screen and
scroll up, if RECEIVE QUIET is OFF. If you do not wish to see these
lines and want the transfer to run somewhat faster, you can enter this
command to ANZIO: 2
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
EX $IKERMITf
At this point, ITX will only accept Kermit server commands. That means
you cannot simply type commands to it to tell it what to do, but must use
ANZIO's Kermit commands, such as KSEND, KRECEIVE, and
KCOMMAND FINISH (see section 12.2).
$IKERMIT assumes you want to transfer to and from disk unit 0. There
are two ways to override this. On startup, you can tell it to work with
unit 3, for instance, by telling ITX:
EX $IKERMIT 3f
Or, once $IKERMIT is running, you can change its working disk by using
its CWD (Change Working Directory) command. To do this, tell
ANZIO:2
KCOMMAND CWD 3f
$IKERMIT also assumes you are dealing with a TEXT file, as opposed to
a BINARY file. To override this assumption, invoke it with the "B"
parameter:
EX $IKERMIT Bf
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
KCOMMAND FINISHf
There are several; approaches to file transfer between ANZIO and UNIX,
as detailed below. Note, however, that the COBOL programs (such as
SEND-PC.CBL) are NOT intended for UNIX, and will probably not
work.
The following steps will upload a file into UNIX. Note that this
procedure is effectively limited to records less than 255 bytes. First,
enter this command to UNIX:
cp /dev/tty <filename>f
If UNIX loses some characters, you may need to boost ANZIO's DELAY
setting. The DELAY is necessary because no handshaking is being used.
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
cd /usrf
cp /dev/tty send-pc.cf
OPENI SEND-PC.Cf
TRANSMIT TRAILER bDf
cc send-pc.c -o send-pcf
The last line tells UNIX to compile a "c" program (cc) named "send-
pc.c", and put its compiled output (-o) in a file named "send-pc".
If you do not have a "C" compiler ("cc"), we may have provided you with
objects (executable programs) for your particular UNIX system. Check
the READ.ME file on the distribution diskette.
This C program included will transfer virtually any UNIX text file down
to the PC (do not try to use it on an RM/COBOL indexed file). Upload it
and compile it as explained above. To use it simply enter:
The program will delete an old <pcfilename>, create a new one, and send
the file down.
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
chmod +x downloadf
DOWNLOAD will take any file or list of files and download it (them) to
ANZIO, using the same file name for the PC as on the host. EXISTING
FILES OF THE SAME NAME WILL BE DESTROYED! As an
example, the following command (to UNIX) would download the
specified COBOL files:
download *.cblf
The Kermit file transfer protocol is available for UNIX, for a small distri-
bution charge. Kermit allows transfer of many kinds of files between
many kinds of systems, with error checking, data compression, and more.
Contact us for information on obtaining Kermit for your UNIX machine.
kermit -p ef
shf
SERVER MODE
For less confusion, we recommend putting UNIX
Kermit in "server" mode, by telling it:
serverf
KCOMMAND FINISHf
quitf
11.6 RM/COS
For uploading, we will use the ability of the RMCOS system to copy from
the terminal to a file. First, tell RM/COS:
CRf
(for LOGICAL NAME, enter f)
(answer following questions as appropriate)
FCf
(for SOURCE, enter "MEf")
(for DESTINATION, enter the pathname of the created
file, then f)
bX
EXITf
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
This program will read an 80-byte variable file and transfer it using the
CAPTURE procedure. Upload the program and compile it, as explained
above. To use it, tell COS:
OPENO <pcfilename>f
CAPTURE ONf
LOCK ONf
f
CLOSEOf
CAPTURE OFFf
LOCK OFFf
X
RELff
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
This program will read a 510-byte variable file and transfer it using the
CAPTURE LONG procedure. This means the program will break the re-
cord into pieces to send it, and ANZIO will put it back together. The pro -
cedure is exactly the same as for SEND-RM, above, except that you must
specify
CAPTURE LONGf
This program allows you to upload records up to 510 bytes long into
RMCOS. It produces a file that is 510 bytes variable, although every re-
cord is 510 bytes long (padded with spaces). As with the other programs
discussed here, it can be adjusted by a programmer to create files with
other specifications.
(create the destination file using "A" as the logical file name)
(assign the object program)
EXECf
RECV-PCfff
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
LOCK OFFf
RELff
You may need to adjust your DELAY factor, if you get errors in your re -
ceived file.
11.7 VRX
Simple upload should work going into VRX's OLPD editor, or other
simple input programs. We do not support file transfer with VRX at this
point - that is up to the user. However, the programs are simple to adapt
to any VRX system for your own specific needs. Each program only
requires minimum changes.
11.8 PC-TO-PC
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
OPENO <filename>f
LOCK ONf
OPENI <filename>f
PLAY NCR ONf
LOCK ONf
TRANSMITf
Any file can be moved from one PC to another with little or no trouble
when there is no common media. Set up the sending PC the same as
above, except use "TRANSMIT CRC" instead of "TRANSMIT". On the
receiving PC, use "RECEIVE CODED". Again, no guarantees.
There are, as mentioned, some variations on file transfer we have not pro -
vided. The most common of these requirements involve either a) using
host-generated data with word-processing and spreadsheet programs on
the PC, and b) moving more complex kinds of files between PCs and
hosts. More information on the first is given in section 19.. If you would
like to discuss specific requirements, please give us a call. We do have
two programs available which may be of help to you.
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
A popular use of ANZIO is to bring data from the host's files down to the
PC in order to use it in a spreadsheet or word-processing system. In order
to do that, some extraction and data conversion must generally take place
on the host. In other words, you don't want to bring your entire file down
to the PC, only some selected data.
11.9.2 UFT
UFT stands for Universal File Transfer. Two versions of UFT are avail -
able, one for I-systems and one for UNIX.
UFT for I-systems runs on an IMOS III, IMOS V, IRX, ITX, or RMCOS
system, in conjunction with ANZIO on the PC. It deals on the host side
with any file: indexed, relative, or sequential, even object programs. It
also deals with packed-numeric and other eight-bit non-ASCII data
(which is transferred transparently). On the PC side, it deals with text
files as well as binary files and RM/COBOL-compatible binary sequential
files. It also does error checking during transfer.
With UFT on different host systems, you can use the PC as a stepping
stone to move files from one system to another. When you put all the
parts together, you obtain the ability to transfer:
I-system to I-system
I-system to/from RM/COS
I-system to/from RM/COBOL on PC
RM/COS to/from RM/COBOL on PC
I-system to/from UNIX
Listed below are all the text commands that ANZIO can process. These
can be 1) entered manually; 2) part of a macro; or 3) sent from the host
computer.
This section lists all the commands in ANZIO. The command listing
shows the exact form (syntax) of the command. A vertical bar (|) indi -
cates alternate commands in the same group. Square brackets ([ ]) in-
dicate optional parameters. Anything in angle brackets (<>) must be
replaced by your appropriate entry.
7E1
Shortcut equivalent to DATA BITS 7, PARITY EVEN, and
STOP BITS 1.
7E2
Shortcut equivalent to DATA BITS 7, PARITY EVEN, and
STOP BITS 2.
7N1
Shortcut equivalent to DATA BITS 7, PARITY OFF, and STOP
BITS 1.
7N2
Shortcut equivalent to DATA BITS 7, PARITY OFF, and STOP
BITS 2.
7O2
Shortcut equivalent to DATA BITS 7, PARITY ODD, and STOP
BITS 2.
8E1
Shortcut equivalent to DATA BITS 8, PARITY EVEN, and
STOP BITS 1.
8E2
Shortcut equivalent to DATA BITS 8, PARITY EVEN, and
STOP BITS 2.
8N1
Shortcut equivalent to DATA BITS 8, PARITY OFF, and STOP
BITS 1.
8N2
Shortcut equivalent to DATA BITS 8, PARITY OFF, and STOP
BITS 2.
8O1
Shortcut equivalent to DATA BITS 8, PARITY ODD, and STOP
BITS 1.
8O2
Shortcut equivalent to DATA BITS 8, PARITY ODD, and STOP
BITS 2.
ANSWERBACK <string>
Sets the ANSWERBACK to <string>. The ANSWERBACK can
be sent to the host, on host request, in certain terminal
emulations. If the ANSWERBACK requires a <RETURN>,
code it as “|”.
BACKSPACE 8 | BACKSPACE 127
Different host systems require different codes for backspace.
ANZIO can send either a DEL (decimal 127, hex 7F) or a BS
(decimal 08, hex 08, ctrl-H) for backspace (or any other decimal
value). This command sets that value.
BAUD <nnnn>
Sets the Baud rate of the connection. All the standard rates (50,
75, 110, 134.5, 150, 300, 600, 1200, 1800, 2000, 2400, 3600,
4800, 7200, 9600, 19200, 28800, 38400, 57600) are available,
should you need to use them. The current baud rate is displayed
by the p (HELP) key.
BREAK
The BREAK command sends a break to the host computer.
CALC
This command brings up a four-function calculator on line 25.
This allows you to do some arithmetic without grabbing a calcu-
lator. The calculator can work in decimal or hex mode.
When you are finished calculating, hit the ^ key. This will
return you to your live screen, while leaving the result on line
25. Or, you can hit the l key, which will exit the calculator and
send the RESULT (the contents of the accumulator) to the host
computer. The result will be retained in the calculator the next
time you enter it.
CALL <macro>
This command allows one macro to start another macro. When
the second macro finishes, the first (calling) macro will resume.
See also INVOKE.
At any time that there is data in the receive buffer, and an output
file is open, the captured data will be written out to the output
file.
WIN only
CAPTURE WPRN captures the received data to the Windows
printer driver.
CHARSET <name>
Sets the National Replacement Character (NRC) set to <name>.
If <name> is “INTERNATIONAL”, no NRC translation will be
done. Other possible values are: 'UK', 'FINNISH', 'FRENCH',
'CANADIAN', 'GERMAN', 'ITALIAN', 'SWEDISH',
'SPANISH', 'NORWEGIAN', and 'SWISS'.
CHOOSEPRINT
WIN only
Brings up the Windows Printer Setup dialog box, so the user can
select (and setup) a printer.
WIN only
Copies the indicated rectangle (or the whole window) to the
Windows Clipboard.
CLOSEI
Closes the input file. See OPENI.
CLOSEI/S
This command also closes the input file, but sends a response
code to the host indicating completion. Possible results are:
00 : Completed successfully
01 : Error occurred
CLOSEO/S
This command also closes the output file, but sends a response
code to the host indicating completion. Possible results are:
00 : Completed successfully
01 : Error occurred
COLOR
This command allows the user to specify which colors/attributes
are to be used, both for normal text and for highlights and so
forth. The terminal which ANZIO is emulating can have four
video attributes: reverse video, half intensity, underline, and
blink. These may be used in any combination, making 16
combinations.
In the COLOR screen, just hit the key for the attribute you want
to change (0 through 9, A through F), followed by the two-byte
color/attribute code you want, selected from the table of all
possible values shown at the right. Repeat this as necessary,
then hit f to exit.
WIN only
DEFAULTS
Tells the program that you want to save the current parameter
settings. You will be prompted for the name of the file to save
into. See section 1.8.
DELAY <nnn>
Sets the time delay between characters sent to the host. This is
necessary on some systems to prevent overloading the commu ni-
cation hardware on the host. <nnnn> is a number from 0 to
65535; larger numbers cause more delay; zero is no delay.
Unlike in earlier versions of ANZIO, DELAY is now in units of
10 microseconds, regardless of PC speed.
DELAY/S
Causes ANZIO to report to a host program what its DELAY and
LINE DELAY settings are.
DELETE B:ANYFILE.XYZ f
If ANZIO can not find the file indicated, an error message will
be generated.
DELETE/N <filename>
This command is the same as DELETE, except that an error
message is not generated in the event that the indicated file is not
found.
DELETE/S <filename>
This variation of DELETE returns a status code to the host. Pos-
sible results are:
00 : Completed successfully
01 : Error occurred
DIR [<pathname>]
Displays a directory of a disk unit, subdirectory, wild-card direc-
tory, etc. Format is the same as at the DOS prompt.
DIR/S [<pathname>]
Behaves as DIR, above, but allows you to select a file name and
send it either to the host or to another function. See section
5.8.5.5.
DROPOUT
Exits from ANZIO, just like END or STOP, except the program
does not restore the communication port to its original state.
This is for use in unusual situations only.
END
Causes the program to terminate, and return to the operating sys-
tem. Same as STOP. Can be abbreviated to “E”.
EJECT
Ejects the page on the printer.
ENV/S <variable>
Looks up <variable> in the DOS environment, and sends its
value to the host, without any terminator.
F2
Invokes the line editor. section 6..
FIND/S <filespec>
Causes ANZIO to report to the host the first file name matching
the wildcard entry in <filespec>
FINDNEXT/S
Causes ANZIO to report to the host the next file name matching
the wildcard entry in the last FIND/S command.
FLUSH
Causes ANZIO to flush all data to the PRINTER, by closing and
reopening the printer file. If spooling is being used, on a network
printer and/or through Windows, this will cause the print job to
be released so it can be printed.
FLUSHTIMER <value>
Sets the flush timer to <value>, in seconds. Default is 5 seconds.
When this number of seconds has elapsed since Anzio sent
something to the printer, Anzio will execute a FLUSH command
automatically, thereby allowing the data to be printed.
WIN only
Changes the Windows screen font size. Anzio will change the
window size to follow the font size. You can specify a <size> as
either <height> or <height>x<width>. Note that Anzio will not
necessarily find the indicated size available.
HALF [DUP]
Sets Half Duplex mode. See FULL DUP.
HELP
This will display many available commands, any open files, and
the current option settings. You may also use the p key.
Note that the PRINT command at this location will print the
HELP screen, not the live screen.
HELP <keyword>
Tells the program to give you some information on a particular
command (those listed in this section). In this case the
<command> must be spelled out completely - it can not be
abbreviated. See section 2..
If your initial disk is no longer in the system, the help file will
not be accessible.
HOSTNAME/S
Causes ANZIO to send its hostname to the host.
DOS only
Specifies what hotkey combination will be used to pop up
ANZIO after the STAY command. The <xyy> parameter is a
keycode combination, where x indicates shift modes and yy is a
keyboard scan code (all in hex). Shift modes are:
8 = alt
4 = ctrl
2 = left shift
1 = right shift
IMOS
Sets IMOS mode. See ITX.
INTERPRET
Displays the 2048-character input buffer, that is, the last 2048
characters that were received from the host. Non-printable char-
acters appear as reverse-video hex numbers. This display is of
value when something strange has occurred at the terminal, as it
shows the input conditions.
IRQ <n>
DOS only
Tells ANZIO what interrupt level (IRQ) the current PORT is set
for. Note that if you do a PORT command, ANZIO will change
your IRQ automatically to the standard value for that port.
Therefore, if you are using a non-standard setup, you will need
to then do an IRQ command.
WIN only
KEEP r
KEYS
Shows all currently defined keys and their text (see DEFINE
above). Also shows the system-defined function keys, and any
not-obvious editing keys for use with m and with the command
line editor.
KRECEIVE <filename>f
KSEND <filename>f
KSEND <filename>
AS <filename>f
KSEND <wildcard>f
KSEND <wildcard>
AS <wildcard>f
WIN only
Starts another program, similar to RUN, but ANZIO does not
wait for the other program to complete.
LOG [<unit>:]<directory>
Allows you to change the "logged" or default disk unit and sub-
directory. The logged unit is assumed whenever no unit and/or
directory is specified for local operations such as DIR and
OPENO.
MERGE <filename>
Reads in a file of macro keys, just as READ does, but does not
change the default key file name. Thus, a subsequent SAVE will
save to the prior file name. Also, MERGE will leave your
existing macros defined (unless they are superseded by some in
the new file).
MESSAGE <string>
Pops up a box containing <string>. When the box is acknowl -
edged, it is removed.
MKDIR <dirname>
Creates a directory, similar to the DOS command of the same
name.
MKDIR/S <dirname>
Creates a directory, similar to the DOS command of the same
name. Reports its success to the host as:
00 : Operation successful
MODE-132 <xx>
DOS only
Tells ANZIO what BIOS mode on your particular screen
hardware corresponds to 132 by 25 characters. <xx> must be in
hex. This allows ANZIO to set itself into 132-column mode in
response to a command from the host. See section 8.1.
OPENI <filename>
Opens the specified file on the PC's disk for INPUT, to send to
the host (see File Transfer, section 11.). The <filename> can
optionally include a unit designator and/or a subdirectory des-
ignator. If none is included, the logged drive and subdirectory
will be used (see LOG, above).
Only one input (and one output) file can be open at a time.
OPENI/S <filename>
This command is intended to be sent from the host computer. It
behaves the same as OPENI, above, except that a result status is
sent to the host. Possible statuses are:
00 : Operation successful
01 : File not found
02 : Input file already open
Only one output (and one input) file can be open at a time.
If the file already exists on the PC, you will get a message to that
effect. You may want to use DELETE to delete that file, or see
OPENO/N below.
Output files are used for a) file transfer (see section 11.), b)
CAPTURE, c) KEEP, d) PICK, e) WRITE, and f) pass-through
printing.
If you OPENO LST:, the printer will be your output file. In this
way you can do file transfer from a host computer directly to the
PC's printer. The logical printer name that will be used by
ANZIO in this case is determined by the PRINTER setting as
explained below. You can also open as output any DOS device,
such as COM2 or LPT2.
OPENO/N <filename>
This command performs the same as OPENO, except that IF a
file already exists with the name specified, it will be DELETED
WITHOUT A MESSAGE before the new one is created.
OPENO/S <filename>
This variation of the OPENO command is intended to be sent
from a host computer. Instead of giving error messages to the
operator, it sends a result status to the host, as below:
00 : Operation successful
01 : File already exists
02 : An output file is already open
03 : File or subdirectory error
PASTE
WIN only
Tells ANZIO to paste clipboard text data to the host.
PLAYSOUND <filename>
WIN only
Causes Windows to play a WAV sound file.
PORT <n>
Specifies which hardware port is to be used for communication.
PRINT
Prints the current screen display on the printer. Only the lines of
the "live" screen are printed, and video attributes are ignored.
The logical printer name is that defined by the PRINTER
command below.
PRINTER <printer-name>
This parameter tells the program what logical device name is to
be used as the standard printer. This is usually PRN, LPT1, or
some derivative of one of them, depending on the PC.
WIN only:
Setting PRINTER to WPRN tells ANZIO to use its internal Win-
dows printer driver.
PRINTER-SETUP <text>
This command lets you send any text or control characters to the
printer. It is particularly useful inside a defined key, as a way to
set the printer into special modes (compressed pitch, for
instance).
PRINTER-SETUP bP
^bP
bNf
PRINTFONT <SIZE>
WIN only
Tells ANZIO’s “WPRN” printer driver what character size to
print in. The <size> can be in the form of <height> or
<height>x<width>.
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
WIN only:
If the specified printer is “WPRN”, and PRINT WIZARD is
turned on, the Print Wizard will inspect the data to be printed,
and will set the line spacing, character size, and margins
automatically to make the document fit well on the page.
WIN only
Tells ANZIO’s “WPRN” printer driver whether to do low-level
print.
PURGE
This command causes ANZIO to delete all data stored in its
"received file" buffer. Data is put into that buffer by a)
CAPTURE and b) file transfer. Ordinarily, if data is building up
in the buffer (as shown on the HELP screen), it is because an
output file has not been opened to place the data into.
READ <filename>
Reads in a previously SAVEd file of defined keys. This new
data REPLACES any keys you already have defined. The
specified <filename> becomes the new assumed key file name,
so if you do a SAVE without specifying a name, it will be used.
See also MERGE.
RECEIVE CODED
Tells ANZIO that the file being received is coded and that all
information should be written out to disk as a coded file. This
has its use in transmitting from one PC to another (see section
11.8).
NET only
This setting tells ANZIO how to behave when the host system
drops its end of the connection, such as when you log off of a
UNIX host. If RECONNECT is ON, ANZIO will immediately
try to establish a new connection (leading to a new login
prompt). If OFF, ANZIO will quit.
RESET
Resets several aspects of terminal emulation: character sets,
attributes, and wrap mode.
REVIEW
Allows the user to see what has scrolled away off the top of the
screen. See section 10..
RMCOS
Sets the program to talk to an I-TOWER. See ITX above.
RTS-MODE 0 | RTS-MODE 1 |
RTS-MODE 2
DOS only
This communication parameter should be set only by those fa-
miliar with communication protocol. It governs the behavior of
the "request-to-send" line which is part of the RS232 communi-
cation protocol, and generally can be ignored except when
working with certain types of half-duplex modems or other spe-
cial communication environments. The settings are:
For Windows: ANZIO will start the other program, and then go
to an inactive state until the other program finishes, for
compatibility with DOS versions of ANZIO. See LAUNCH for
an alternative.
Do NOT run any program which takes over control of the serial
port, or any terminate-stay-resident (TSR) programs.
For many programs, you will need to LOG to the disk that con-
tains the program before running it.
Note that if you have transferred data from the host to the PC
with ANZIO, the output file must be closed before that data can
be accessed. The HELP screen will show you if you have an
output file open.
When you return to ANZIO, it will ask you to hit a key before it
restores the screen.
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
SAVE [<filename>]
Saves all currently defined keys to the indicated file on the PC.
Any existing file of the same name will be deleted. If no
<filename> is given, ANZIO will save to the defaults file which
was read at startup. If none was used, ANZIO will use the
default “ANZIO.KYS”.
SCREENMODE <string>
This command allows you to make ANZIO switch screen
drivers.
DOS only
Possible options are:
COLOR Standard color 80x25
MONO Standard monochrome 80x25
MONO/C Monochrome screen on color driver
BW80 (same)
43X80 80 columns by 43 (50) lines on EGA
(VGA)
80X43 (same)
132 132-column mode - requires that
MODE-132 has been set
80 COLOR or MONO as appropriate
BIOS-xx BIOS mode xx (in hex).
The last option can be used to set your screen into a non-stan-
dard mode, if it is supported by the normal BIOS interrupt
convention.
WIN only
Possible options are
132 132-columns wide
SCREENMODE/S
ANZIO will report to the host computer several parameters
about the screen. This will be returned to the host as one line
with several fields:
TYPE 1 character, C for color, M for mono, B
for BW, blank if unknown
MODE 2 characters, hex mode as per BIOS
LINES 3 characters, number of lines on screen
COLS 3 characters, number of physical columns
WIDTH 3 characters, number of logical columns
TEXT The mode shown in SCREENMODE on
the HELP screen
STAY
DOS only
Causes ANZIO to go memory-resident (TSR). Does NOT save
enough memory to pop up over graphics-mode programs. See
section 1.9.2.
DOS only
Causes ANZIO to go memory-resident (TSR), saving enough
memory to allow it to popup over graphics-mode programs. See
section 1.9.2.
STOP
Stops the ANZIO program and returns to the operating system.
Same as END.
DOS only
Some video adapters (notably CGA) produce "snow" if screen
updating is not synchronized with horizontal retrace. Try SYNC
OFF. If you see snow during operation, then use either SYNC
ON or SYNC FAST. SYNC FAST is similar to SYNC ON, but
it blanks the screen temporarily during scrolling, resulting in
faster scrolling but more flicker.
Sets the tab stops to columns <i>, <j>, ... The column num bers
are entered in order, separated by any non-numeric character.
There are ten tab stops; those not specified are not used. Tab
stops can also be set with control codes from the host computer.
TAB 8 12 15 18 21 24 27 30 33 73
TERM <termtype>
Tells ANZIO what type of terminal to emulate. Current options
are:
N7900 NCR 7900 model 1
N7901 NCR 7901
VIEWPOINT ADDS Viewpoint (same as N7901)
VT100 DEC VT100
VT220 DEC VT220
WYSE50 Wyse 50
WYSE60 Wyse 60
C332 Versyss C332
SCOANSI Console of SCO UNIX
Make sure ANZIO's TERM setting agrees with the host com -
puter's assumption of terminal type.
TERMNAME <name>
NET only
Sets a TERM variable that will be sent to the host as part of the
telnet protocol, during the initial phases of the connection. If
none is specified, ANZIO will send the name set by the TERM
command.
TIME
TIME allows ANZIO to send the time according to the PC's
clock to the host (format HH:MM:SS f). Along with DATE, this
provides the user with a means of setting up a defined key to
log-on and enter the correct date and time.
TIMEOUT <n>
The timeout time (in 1/10 seconds) is used primarily during file
transfer. If ANZIO sits locked for the specified time, it will a)
beep, b) unlock itself, and c) RETRANSMIT. This can get a file
transfer going again after certain communication errors.
Primarily used with UFT.
TITLE <string>
WIN only
WIN only
If TRACK-WINDOW is on, ANZIO will remember the position
of its window on the screen, and will automatically readjust to
that position the next time it is started. This works, however,
only if you save parameters between sessions. Some users prefer
to turn this feature off to prevent ANZIO prompting to save
parameters on exit.
TRANSMIT CRC
Same as TRANSMIT ON, but causes ANZIO to use a CRC
protocol on transmission. For use with special software on the
host computer.
TRANSMIT LONG
This is a variation on TRANSMIT ON. It initiates file transfer
to the host, but uses a special protocol that takes long records
apart and sends them in pieces to the host. The host, of course,
must have software (such as RECV-PC.CBL) that understands
this protocol and puts the records back together.
TTY
Tells ANZIO that you are working with a bulletin board system
or some other unspecified host. See ITX.
TYPE <filename>
Causes a PC file's contents to be displayed on the screen. This is
particularly useful for verifying file transmission. Note that if
you have just finished a file transmission to the PC, and the
output file is still open, the TYPE command will not work
properly. In that case do a CLOSEO first.
If the file being TYPEd has control codes in it, these will be
shown as reverse video hex codes.
VERSION
Tells you which version of ANZIO you are running.
VERSION/S
Tells the host which version of ANZIO you are running.
VRX
Tells the program that the NCR host is running the VRX oper-
ating system. See ITX.
WAIT <nnn>
This command simply tells ANZIO to wait a certain amount of
time before sending anything else to the host. The <nnn> pa-
rameter is in units of approximately 1/10 second. See section
7.2.
WINDOWCLOSE
Brings the most recent WINDOW's old data back to the screen.
See WINDOW.
WIN only
Causes Windows to print the indicated file using the program
associated with its file extension (in the same way the File
Manager/Explorer does).
WINSTART <filename>
WIN only
Causes Windows to “open” the indicated file. This can be a
program or a data file. If it is a data file, it is opened using the
program associated with its file extension (in the same way the
File Manager/Explorer does).
WRITE <text>
Writes the specified text to the current output file.
XN
Used in conjunction with TRANSMIT SINGLE, this tells
ANZIO to send one more line to the host.
ZRECEIVE [<filename>]
Tells ANZIO to receive a file using the Zmodem protocol. If
<filename> is specified, the received file will be stored with that
name; if not, the received file will be stored with the same name
as on the sending machine.
Warning: this section applies only to DOS. When you start up ANZIO,
the operating system (DOS) must be able to find the program
(ANZIO.EXE). There are three ways this can happen. ANZIO has been
written to be able to run in any of these modes, while still being able to
find its associated files.
First, you can log to the disk/directory that contains ANZIO, such as:
C:f
CD\ANZIODIRf
ANZIOf
C:ANZIOf
or:
\ANZIODIR\ANZIOf
For Windows: Command line parameters are coded into the program
icon.
If no command line parameters are present, ANZIO will try to load its
standard defaults file (ANZIO.DEF or ANZIOWIN.DEF). This file, if
present, will set ANZIO for all the correct user-settable parameters. In
addition, it will tell the program what defined-key file, if any, ought to be
loaded.
A parameter that a) is more than one character long, and b) does NOT
start with a slash, is understood to be the name of a parameter (settings)
file to be used INSTEAD of ANZIO.DEF or ANZIOWIN.DEF. Thus:
C:\>ANZIO REMOTEf
would initiate the program and cause it to attempt to read a defaults file
called "remote". So you could have one defaults file with the correct set -
tings for local operations, and one with the correct settings for remote
(modem) operations.
A>ANZIO NONEf
C:\>ANZIO Sf
will load ANZIO, which will load its standard defaults file, which will
tell it which defined key file to load, which will then be loaded, and fi -
nally the "S" defined key (case sensitive) will be automatically initiated.
DOS only
/M:<nnn>
NET only
For network connections, this parameter specifies the host system to con-
nect to, overriding the one contained in the parameter file. The format is:
/H:<hostname>
If you need to specify a host port, add it to the end, after a colon:
/D<key><space><string>
where <key> is the key to be defined (an ASCII key), and <string> is the
definition.
WIN only
/C
causes ANZIO to prompt the user for which “.DEF” file to use.
WIN only
DOS only:
If ANZIO has access to more memory than it needs, it will release that
memory when it does a RUN or STAY.
ANZIO /M:<nnn>f
ANZIO /M:1f
DOS only
Now, if you run ANZIOS, you will have a smaller, but limited function,
option.
ANZIO has a keyboard lock indicator which shows on the status line,
unless you have turned STATUS LINE OFF.
Both the status of the LOCK mode and the operating system setting can
be determined by displaying the HELP screen p.
1 If you have redefined function keys to emulate a terminal, see section 3..
This section contains the nitty-gritty of file transfer protocols, and is in-
tended only as a reference for those who are interested in that sort of
thing. Only the operation of ANZIO is explained here - the other side can
be determined from the various source programs that are included.
The entire line on the PC file will be read, regardless of its length. Each
segment transmitted includes 3 characters of control followed by up to 77
characters of file data. The first two characters in the transmission
indicate the number of characters of file data (01 to 77) in ASCII form.
The third character is an ASCII "Y" or "N" indicating whether this seg -
ment is the last in a record.
TRANSMIT CRC uses a special protocol for error checking, and is in-
tended only for use with a special program, called UFT, from Rasmussen
Software, Inc.
15.4 RECEIVE
At some point when a) there is data in the receive buffer, b) an output file
is open, AND c) the program is "unlocked", then ANZIO will do three
steps. First, it will write the receive buffer out to the output file. Second,
it will clear the receive buffer. Third, it will respond to the host with a
<return>, indicating that the host can proceed with the next transmission.
Note that in order to end up with "records" on the PC file, the CR and LF
codes must also be sent from the host, bracketed by DC2 and DC4.
CAPTURE takes each line off the screen, as soon as the cursor moves to
another line. It only captures incoming characters. The captured
information is then written to the output file. If ANZIO is running in an
RMCOS environment, it then responds with a f, because it assumes in
that case that CAPTURE is being used for file transfer.
1 If you have redefined function keys to emulate a terminal, see section 3..
When ANZIO receives a hex 1C (octal 034) from the host computer, it
processes anything following that, up to but not including a hex 1D (octal
035), as an q command. So for instance, if the host sent a line that con-
tained
<hex-1C>OPENO DOWNFILE<hex-1D>
OPENO DOWNFILEf
In other words, although a function is initiated from the host, all displays,
error messages, and subsequent input will be from/to the PC's screen and
keyboard. So some functions are just not practical to be initiated in this
way.
Several commands, though, have been specifically designed for this ap-
proach. These commands contain "/S", indicating that the status of the
command (or a result code) should be sent to the host rather than generate
a message to the screen. Section 12.2 explains the response codes these
commands generate.
This works because the UNIX shell understands "\0034" to mean octal 34,
and "\0023" to mean octal 23.
The ANZIO program is first and foremost trying to make your PC act as a
terminal does. This means that certain control codes, when received from
the host, have special meanings. Also, ANZIO will respond to some
additional codes, making it more useful than the terminal it is emulating.
Note that ANZIO does not necessarily respond to ALL codes that the cor-
responding terminal does. Some we have judged either of little value to
our customers, or of great difficulty given the hardware platform that is
the PC.
Some of the codes here actually emulate the NCR 7930 in 7900M1+
mode, including line-drawing.
Received codes:
Code Hex Action
SOH 01 Home (go to top of screen)
STX 02 Unlock keyboard
EOT 04 Lock keyboard
ACK 06 Move cursor right
BEL 07 Ring bell (see BEEP commands, section 12.)
BS 08 Same as NAK
Keystrokes
Key Hex Code
<Home> 01 <ctrl-A>
<Up> 1A <ctrl-Z>
<Left> 15 <ctrl-U>
<Right> 06 <ctrl-F>
<Down> 0A <ctrl-J>
<DEL> 7F
<Backspace> as determined by BACKSPACE command
Some of the codes here actually emulate the NCR 7930 in 7901M1+
mode, including line-drawing.
Received codes:
Code Hex Action
SOH 01 Home (go to top of screen)
STX 02 Unlock keyboard
EOT 04 Lock keyboard
ACK 06 Move cursor right
BEL 07 Ring bell (see BEEP commands, section 12.)
BS 08 Same as NAK
LF 0A Linefeed (cursor down, scroll at bottom)
VT 0B Vertical position, indicated by next character
FF 0C Clear screen and cursor home
CR 0D Return
SO 0E Turn on tagged attribute
SI 0F Turn off tagged attribute
DLE 10 Horizontal position, indicated by next character
DC1 11 XON or received command
DC2 12 Printer on - following characters up to DC4 go to output
file
DC3 13 XOFF or end of received command
DC4 14 Printer off
NAK 15 Backspace (non-destructive cursor left)
CAN 18 This "cursor-on" code from RMCOS is IGNORED.
SUB 1A Cursor up
FS 1C Initiate ANZIO command
GS 1D Terminate ANZIO command
RS 1E Initiate ANZIO command
US 1F Terminate ANZIO command
ESC K 1B 4B Erase to end-of-line
ESC k 1B 6B Erase to end-of-screen
ESC Y 1B 59 Alternate method for cursor positioning, indicated by next
two characters
ESC 0 1B 30 Video attribute indicated by next character will be tagged
attribute
ESC 3 1B 33 Begin pass-through print.
ESC 4 1B 34 End pass-through print.
ESC M 1B 4D Insert line
ESC l 1B 6C Delete line
ESC 5 1B 35 Lock keyboard
ESC 6 1B 36 Unlock keyboard
Keystrokes
Key Hex Code
<Home> 01 <ctrl-A>
<Up> 1A <ctrl-Z>
<Left> 15 <ctrl-U>
<Right> 06 <ctrl-F>
<Down> 0A <ctrl-J>
<DEL> 7F
<Backspace> as determined by BACKSPACE command
Received codes:
Code Hex Action
BEL 07 Ring bell (see BEEP commands, section 12.)
BS 08 Move cursor left
TAB 09 Tab
LF 0A Move cursor down
VT 0B Move cursor up
FF 0C Move cursor right
CR 0D Return
SO 0E Unlock keyboard
SI 0F Lock keyboard
DC1 11 XON or received command
DC2 12 Printer on - following characters up to DC4 go to output
file
DC3 13 XOFF or end of received command
DC4 14 Printer off
Keystrokes:
Key Hex Code
<Home> 1E <ctrl-N>
<End> 1B 54 ESC T
<Up> 0B <ctrl-K>
<Left> 08 <ctrl-H>
<Right> 0C <ctrl-L>
<Down> 0A <ctrl-J>
<DEL> 7F
<PgDn> 1B 4B ESC K
<PgUp> 1B 4A ESC J
<Insert> 1B 71 ESC q
<Backtab> 1B 49 ESC I
<ctrl-Home> 1B 7B ESC {
<Backspace> as determined by BACKSPACE command
Received codes:
Code Hex Action
BEL 07 Ring bell (see BEEP commands, section 12.)
BS 08 Cursor left
TAB 09 Tab
LF 0A Cursor down
CR 0D Return
Error indicators in ANZIO fall into two categories. The first consists of
temporary indicators on the status line, showing communication errors.
The second consists of textual error messages which are indicated usually
on line 25.
PARITY
This means that the chip has detected a parity error. It
may mean that your parity is not set correctly, and so
your host system is sending its characters with a differ -
ent parity than you are expecting. Correct your parity
setting.
OVERRUN
This one is a little tougher. When a character comes in
to your PC's serial port, it generates an interrupt. This
causes the PC to interrupt whatever it is doing, go fetch
the character, and put it into ANZIO's buffer. If another
character comes in before the first is processed, an over-
run has occurred.
FILE EXISTS
The file name you are trying to OPENO already exists
on the disk. Either delete it or use a different name.
INSUFFICIENT MEMORY
The dynamic memory space available to the program
has been filled with a) defined keys and/or b) received
data.
INVALID FUNCTION
Your function specification does not fit one of the func-
tions available.
OVERFLOW ON RECEIVE
A communication chip overflowed during a file recep-
tion operation. Your receive file is corrupted.
RESTRICTED COMMAND
You are using a restricted version of ANZIO, and the
command you have selected is not available to you.
One of the most popular uses of ANZIO involves transferring data from
the host system to the PC in such a way that it can be used by any of the
various tools available on the PCs, particularly spreadsheet and word
processing systems. For instance, you might wish to capture your general
ledger balances from the host and bring them into LOTUS 123 to create a
financial statement. Or you might want to extract from your accounts
receivable system the names and addresses of any customers who are past
due, pass that information to the PC, and merge it into a standard dunning
letter, using a word processing package.
The first point to understand is that "data" on one system is not neces-
sarily "data" on the other. That is, the various means of storing infor-
mation on the host system and on the PC may not be compatible. The
second point is that more is required than simply doing file transfer. In
the second case above, you would not want to transfer the entire A/R file
- it could take hours, might not fit, and you'd still have to do the ex -
traction.
The particular format that is used by the PC software varies quite a bit.
There has been some effort made at establishing standards, but the stan -
dards are a long way from standard. In general, these programs deal with
"fields" of data. A field can be either numeric (a number), or
alphanumeric (any combination of characters, such as a line of an ad-
dress). There may be a requirement for some kind of indication of
whether a field is numeric or alphanumeric, such as quotes around al-
phanumeric fields. And there must be agreement on "delimiters", which
are special characters and/or carriage-returns (CRs) used to indicate
where one field ends and another begins.
First, you must have an output file open. This is done with the old fa -
miliar:
OPENO <filename>f
PICK r
The r key initiates a "highlight" function that allows you to indicate what
column you want to deal with (we'll do this one column at a time). Your
highlight appears in the center of the screen. Use the cursor arrows to
move one corner. Each time you hit r, you take control of the opposite
corner, and can move that one. So, between the arrow keys and the r key,
you can place the highlight so that it covers the column of data you want
to pick. This includes working with a screen width of 132 columns, such
as picking from a spool file display (see Appendix B on SPOOLCRT).
When you hit f, your command line will suddenly show four numbers,
representing the row and column of each of two corners. Thus you have
defined your column. Now you must give a "type" indicator. These are:
A = Alphanumeric
N = Number
- = Number negated
The minus indicator works as a number, but ANZIO will reverse the sign
before writing it out, so for instance liability accounts which ordinarily
carry a negative balance can be inverted.
If you wish to define more than one column, enter a k and hit r again.
You can continue this way until you run out of room in the command
string (total of 255 characters). Note that "PICK" is entered only once,
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
When you hit f, the action begins. ANZIO reads the screen, and for each
screen line, determines which columns intersect that line, in the order in
which they were defined (not the order they appear on the screen).
ANZIO then builds and writes out a record (a line), in CSV format, for
any screen line with defined columns. Numbers are rearranged into a
standard floating-point format, with leading minus signs as needed. Any
number which on the screen contains a minus sign, a parenthesis, a "D",
"B", "C", or "R", or any combination, will be considered negative by
ANZIO. Dollar signs and commas will be removed.
Once the PICK is completed, you can continue to generate other screens
and do other PICKs as needed. When you are finished, be sure to do a 2
CLOSEOf
Like almost anything else in ANZIO, this operation can be put into a
defined key, if it is something you'll do more than once.
The primary problem with this approach is that it lacks flexibility. End
users who are accustomed to working with the various PC tools have
come to expect flexibility, but this approach requires the programmer to
"hard-code" every particular extraction needed.
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
The most common cause for conflict is use of the serial port. If another
program sharing control with ANZIO manipulates the same serial port,
such as it might if it had an auto-dial capability, ANZIO may lose con trol
of that port and be unable to communicate. It is best to disable any auto-
dial feature in this situation, or configure it to use another port.
Most of the instructions in this manual apply to all host operating sys -
tems. This section details some variations necessary for particular host
systems.
When working with UNIX, be sure its TERM setting agrees with
ANZIO's TERM setting. You can verify UNIX's setting by using the
"set" command. To change UNIX's setting, tell UNIX:
for instance. Note that certain application software on UNIX may assume
you are using a certain TERM type, regardless of the current setting.
If you use RM/COBOL under UNIX, and configure ANZIO (and UNIX)
for the NCR 7900, you will find that they don't get along too well,
because of the 7900's use of propagating attributes (attributes take a space
on the screen). You can either modify the terminfo to disable attributes,
or use a different terminal type.
stty -ixanyf
Finally, set ANZIO for UNIX, LOCK OFF, FULL DUP, BACKSPACE 8,
and probably TAB OFF.
When working with one of these I-systems, be sure your parameters are
set as follows:
LOCK
LOCK should be ON at most times with these systems,
in order for keyboard buffering to work. Exceptions are
1) when talking to a local modem, 2) during bootup of
some systems, and 3) newer releases of SCLEDIT and
VIEW under ITX, which do not beep.
TERM
The I-systems were originally designed for the 7900 ter-
minal, so you'll probably want to set TERM to N7900.
This is changing even as we write this, however, with
later releases of ITX including support for other
terminal types. Just be sure that TERM in ANZIO
agrees with your SYSGEN setting.
CABLING
We have received reports of problems with RMCOS
locking up the terminal line, effective RMCOS release
2.7. We have also heard that an alternative wiring
scheme for "intelligent terminals", suggested by NCR
support, eliminates the problem. This new cabling
scheme is embodied in NCR cables with part numbers
1308-C045 (for 9-pin) and 1308-C046 (for 15-pin).
Contact us or your NCR FE for more information.
DUPLEX
Always use FULL DUP.
LOCK MODE
You should generally work in LOCK OFF mode, except
when doing file transfer. This is because the operating
system does not ordinarily send a BELL code with each
prompt.
TAB
Some programs under RM/COS are designed to make
use of the TAB key. In order to send the tab code (hex
09) to the host, instead of translating it into spaces, set
TAB OFF.
DEFINED KEYS
We suggest you set up a function key for
"acknowledge" (control-G A), and one for "interrupt"
(control-X). See the sample key file (RMCOS.KYS), as
described in Appendix F.
FILE TRANSFER
As mentioned, file transfer works differently on
RM/COS. Be sure to check section 11.6.
ANZIO has a "dumb" mode, called TTY. Use this mode when you are
using ANZIO to talk to a bulletin board system or some other foreign sys-
tem (or, you may want to use VT220 mode). In TTY mode, ANZIO does
not respond to most of the control codes listed in this manual.
When you PICK data from the screen, you create a file in CSV format.
That means each line in the file represents a line in a spreadsheet, fields
are separated by commas, and there are quotes around alpha fields. Q-
GRAPH can read this file in to a mini-spreadsheet, make some decisions
about it, and quickly place a graph on the screen.
TITLE1, TITLE2, etc. are optional titles for each variable. They are
presently ignored.
LABEL1, LABEL2, etc. are optional X-axis labels, and must be alpha.
The numeric values y1, y2, etc. are plotted as the first line. If additional
columns exist (z1, z2, etc.), they will be plotted as additional lines.
OPENO PICKFILE.TSTf
PICK 1 40 1 1Af
PICK 12 15 2 2A 25 28 2 2A
f
PICK 1 3 3 14A 6 17 3 14N
20 31 3 14Nf
CLOSEOf
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
and the graph would appear on the screen. Where you see STD in this
example, we are telling Q-GRAPH to use its "standard" graph mode,
which means it will attempt to determine what video hardware it is run-
ning on and use the appropriate mode. You can also override this, by
substituting one of the following:
CGA
EGA
VGA
HERC (Hercules)
6 (monochrome on a CGA)
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
SPOOLCRT is a program for IMOS III, IMOS V, IRX, and ITX to read
and display a manual spool file on the screen. It allows you to move for -
ward and backward in the file by lines, screens, or pages.
The program does not restrict itself to ANZIO as a CRT. In fact, it con -
tains the necessary code to switch a WYSE terminal into and out of 132-
column mode.
Once loaded, SPOOLCRT will give you a list of its command options.
ANZIO is constantly evolving to meet the needs of its users. If you are
installing a new release, you will need to check on a few things.
If you have problems with a new release, start ANZIO with a command
line parameter of “NONE”. That is, for Anzio for DOS, issue the
following command to start ANZIO:
ANZIO NONEf
5. Make sure your cable from the host system is plugged into
the serial port (I know it's obvious, but . . .).
2 ANZIO commands must be entered at the "Func:" prompt; see section 4..
ANZIO.EXE
This is the actual ANZIO program. Might instead be
ANZIOD.EXE.
ANZIOS.EXE
This is a special SMALL version of the ANZIO
program. It is designed for situations where memory is
limited. It does not have many of the advanced features
of ANZIO.
ANZIO.HLP
This is the help file used by ANZIO.
SEND-PC.CBL
A COBOL source program for file transfer of various
file types from IMOS III, IMOS V, IRX, or ITX, to a
PC (Section 11.4).
SEND-PC.C
A "C" source program for file transfer of any UNIX text
file to a PC (Section 11.5).
SEND-RM
A source program for file transfer of 80-byte variable
files using ANZIO's CAPTURE procedure under the
RMCOS operating system (Section 11.6).
SEND-L.RM
A source program for file transfer of 510-byte variable
files using ANZIO's CAPTURE LONG procedure under
the RMCOS operating system (Section 11.6).
RECV-PC.RM
A COBOL source program for file transfer of any file
larger than 80-byte variable files to an RMCOS ma-
chine from a PC. Currently it is set for 510-byte files
(Section 11.6).
RECV-SPL.CBL
A COBOL source program for file transfer of a PC print
file to an IMOS III, IMOS V, IRX or ITX spool file or
printer (Section 11.4).
SPOOLCRT.CBL
A COBOL source program for the I-SYSTEMS, to dis-
play spool files on a CRT or PC (Appendix B).
Q-GRAPH.EXE
A quick graph program to produce line graphs from a
simple CSV formatted file on the PC (Appendix B).
MENUDEMO.CBL
A COBOL source program for I-systems, demonstrating
several ANZIO features. See Appendix B.
SAMPLE.KYS
A sample key file for all systems except RMCOS. See
Appendix F.
RMCOS.KYS
A sample key file for RMCOS. See Appendix F.
VERSION.EXE
A program used in the installation process, to create the
correct version (IMOS V, ITX, etc.) of various source
programs.
READ.ME
A file of last-minute notes, etc. To see them, enter:
TYPE READ.ME f
SET-EGA.EXE
A PC program that allows you to configure an EGA or
VGA video adapter to allow underlining, etc.
SET-EGA.DOC
A file that describes how to use SET-EGA.EXE.
DOWNLOAD
A UNIX shell script for downloading files to ANZIO.
RECV-PC.C
A UNIX source program that allows upload of longer
records into UNIX.
VT100.KYS
Sample function keys for VT100 emulation.
VT100.DOC
A file that explains the keys used in VT100.KYS
VT220.KYS
Sample function keys for VT220 emulation.
VT220.DOC
A file that explains the keys used in VT220.KYS
VT220S.KYS
Sample function keys for VT220 emulation. Uses a dif-
ferent approach to translating PC function keys to
VT220 function keys than does VT220.KYS.
VT220S.DOC
A file that explains the keys used in VT220S.KYS
WYSE60.DOC
A file that explains the keys used in WYSE60.KYS
KERMIT.KYS
A file of function key definitions to work with Word
Perfect 5.0 on a UNIX system, when WPTERM is set
for KERMIT.
KERMIT.DOC
A file that explains the keys used in KERMIT.KYS
ANZIO.TIC
A terminfo file for UNIX, that will enable you to set
your TERM variable to ANZIO. See section 1.11.2.
ANZIO-M.TIC
A terminfo file for UNIX, that will enable you to set
your TERM variable to ANZIO-M, for monochrome
PCs. See section 1.11.2.
ANZIOTIC.KYS
A file of function key definitions that is synchronized
with ANZIO.TIC (and ANZIO-M.TIC).
ANZIOTIC.DOC
A file that explains the keys used in ANZIOTIC.KYS.
NCR3000/SEND-PC.ECH
A file for installing "send-pc" on a UNIX V.4 system
that doesn't have a C compiler. See READ.ME for
more information.
NCR3000/SEND-PC
A file for installing "send-pc" on a UNIX V.4 system
that doesn't have a C compiler. See READ.ME for
more information.
NCR3000/RECV-PC
A file for installing "recv-pc" on a UNIX V.4 system
that doesn't have a C compiler. See READ.ME for
more information.
NCRTOWER/SEND-PC.ECH
A file for installing "send-pc" on an NCR Tower system
that doesn't have a C compiler. See READ.ME for
more information.
NCRTOWER/SEND-PC
A file for installing "send-pc" on an NCR Tower system
that doesn't have a C compiler. See READ.ME for
more information.
NCRTOWER/RECV-PC.ECH
A file for installing "recv-pc" on an NCR Tower system
that doesn't have a C compiler. See READ.ME for
more information.
NCRTOWER/RECV-PC
A file for installing "recv-pc" on an NCR Tower system
that doesn't have a C compiler. See READ.ME for
more information.
As an aid in getting started in both using ANZIO and setting up and using
defined keys, we have included two sample key files, one for RMCOS
and one for everything else.
B
For ITX, this is a special BREAK/SUSPEND key. It
captures the entire screen as a WINDOW, does a
BREAK and S for SUSPEND, thereby saving the old
screen. See "b".
b
Undoes the "B" key, above. Does a RET to exit the
current process, then restores the screen saved above.
C
Takes you to the COLOR screen.
D
Sends today's DATE.
T
Sends the current TIME.
H
Hangs up a modem.
L
Logs on to an ITX system, with a series of BREAKs
and R, so that you should end up at the command level
regardless of what state ITX was in when you started.
R
RUN/N - takes you to the DOS level.
t
Prompts for a file name, opens it, and transmits it with
trailer END$.
u
Does a UNIX simple file upload, with prompts.
r
Takes you to CALCulator.
sor {
Takes you to REVIEW.
g
Causes line editing under $EDIT (on I-systems), with
qCH|{w}m
bz
Does a PAN LEFT.
bx
Does a PAN RIGHT.
al
Does a STAY/G. Causes ANZIO to go memory-resi-
dent.
H
Hangs up a modem.
R
RUN/N - takes you to the DOS level.
r
Takes you to CALCulator.
s or {
Takes you to REVIEW.
D
<ctrl-G>Z for DELETE LINE
I
<ctrl-G>N for INSERT LINE
j<TAB>
<ctrl-G>B for BACKTAB.
g
<ctrl-G>C for ERASE FIELD
{
<ctrl-G>A for ACKNOWLEDGE
d
<ctrl-G>R for ERASE RIGHT
}
<ctrl-G>Q for COMMAND
h
<ctrl-G>I for INSERT CHARACTER
jl through ju
<ctrl-G>1 through <ctrl-G>0 for FUNCTION 1 through
FUNCTION 10.
Note also that the following keys work properly with RMCOS: <TAB>
(if TAB OFF), c for DELETE CHAR, and the arrow keys.
The question often comes to us, "Can ANZIO work on a network?" But
this question means several things. Here is what you can and can't do
with ANZIO.
You CAN put the ANZIO program itself on a network (but please don't
violate licensing restrictions).
You CAN talk to the host computer via the network, with AnzioWin,
Anzio Lite, AnzioNet, or Anzio14.
ANZIO DOES NOT provide the underlying network software. That must
come from other sources. For AnzioWin or Anzio Lite to communicate
via the network, you need a WINSOCK.DLL (for TCP/IP) or support
software for PicLan or WLIBSOCK. For AnzioNet or Anzio14, you need
DOS-level network software.