--------------------------------------------------
Instructions for using some of the new features in
AnzioWin, Anzio Lite, version 12.5
--------------------------------------------------
 
I. INTRODUCTION
 
This file describes certain features of AnzioWin and Anzio Lite that are new
in version 12.5. It is intended to supplement the manual and online
information. Be sure to see also the file README.TXT, which contains change
history as well as some other notes.
 
Also below you will find the text of the HOWTO file originally included with
version 12.0 through 12.4, updated.
 
II. WHAT'S NEW, AND HOW TO USE IT
 
Note that some of the new features shown are provided in AnzioWin only, not in
Anzio Lite.
 
The Anzio manual is being revised; check the website (www.anzio.com).
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
Notes on 12.5:
 
1. SSH Support (AnzioWin only)
 
AnzioWin now supports the SSH protocol for secure (authenticated, encrypted)
communication. You will need to establish an SSH server on your host system;
several are available (but not from Rasmussen Software). In AnzioWin, simply
select SSH as your Communication Method, in Communicate:Setup. You can also
configure SSH from there.
 
The first time you use SSH to connect to a particular host, it will ask you to
verify the host's key. This is how SSH prevents "spoofing", whereby you might
think you were connecting to one server but in fact be connecting to a
different one set up to breach your security. You should check the host key
against the same information delivered by other means, such as a phone call.
Once you approve the host's key, it will be stored in the Windows registry.
 
If the SSH option is grayed out, and you have AnzioWin, you may have the
"exportable" version, which has SSH disabled. We are working out the legalities
of exporting SSH's encryption code from the U.S. If you are in the U.S., please
contact us to receive the full, non-exportable version.
 
Other particulars about AnzioWin's SSH support:
   * SSH versions 1 and 2
   * RSA
   * DES, Triple-DES, Blowfish
   * SHA1, MD5
   * Zlib compression
   * All standard Anzio functions, including passthrough print, Zmodem, and
     Kermit, should work over SSH
   * Username can be stored, but password is not
   * Window size changes are sent to host
   * Environment variables are sent to host (SSH2 only), although we don't know
     if any server implementations support this
   * Terminal type passed to host
   * Random numbers (necessary for encryption) are generated by routines in the
     Windows CryptoAPI, for high entropy (variability)
   * Works on Windows 95, 98, ME, NT4, 2000
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2. Automatic Multiple Font Support
 
Previously, Anzio used one font for all characters on the screen, and, in most
cases, one font for all characters in a print job. With version 12.5, this has
been greatly improved. Now, Anzio can display Latin, Chinese, Russian, etc.,
simultaneously, with no user action.
 
For screen display, Anzio will try to display all characters using the
user-selected font, which should generally be Courier New. When it finds that
it needs to display a character which is not in the primary font, however, it
will look through the fonts installed in Windows to find one that contains the
needed character, and use that font automatically. Preference is given to
mono-spaced fonts (for the screen). If nothing is found, the logic will also
look for variable-spaced fonts IF that is allowed in Edit:Advanced options. All
this should work invisibly to the user, except for a slight delay.
 
Similar support is provided for printing in AnzioWin, when Print Level is High.
 
When Print Wizard is used (in AnzioWin), Print Wizard Markup Language (PWML)
codes can specify a list of fonts to use, in the form
   <FONT FACE="font 1, font 2, font 3, auto">
When the LAST entry specifies "auto", the logic will search for other
appropriate fonts if necessary.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
3. International Character Entry
 
With Anzio, and the host applications it supports, becoming more multilingual,
there are more needs to enter international (non-Latin) characters. Anzio
provides many ways to do this:
 
   3.1 Alt-pad Unicode Entry
 
       Since the days of DOS, it has been possible to enter non-ASCII
       characters using the Alt key and the numeric pad (NOT the numbers at the
       top of the alpha keyboard). For instance, alt-144 enters an E-acute (on
       a US Windows system). This number is taken from the "DOS" or "OEM"
       character set.
 
       For a character from the Windows ("ANSI" or "ISO") set, precede the
       number with a zero, such as Alt-0255 for a y-umlaut.
 
       Now in Anzio, you can also enter any Unicode character by its decimal
       value. For instance, a Y-tilde has a Unicode value of hex 1EF8, which
       is decimal 7928. So you can do Alt-7928 to enter this character.
 
   3.2 Keyboard switching
 
       You can tell Windows you have a different keyboard. For instance, go to
       the Control Panel, then Keyboard. Add another keyboard, such as Russian.
       Then, while running Anzio, click on the language itendifier in the lower
       right "task bar". Here you can select from the installed keyboards. If
       you select Russian, and then hit some keys, Anzio will receive Russian
       characters.
 
       If you are not sure of keyboard layouts, some versions of Windows (at
       least ME and 2000) contain an on-screen keyboard, under
          Start:Programs:Accessories:Accessibility:On-screen keyboard
       This will show you the keyboard layout, and also let you mouse-click the
       keys.
 
       Note finally that there is an "United States International" keyboard,
       which has the same layout as the US English keyboard, but many accent
       keys are treated as "dead keys", combining with the next character.
 
   3.3 Dead key entry
 
       Anzio has built-in support for treating certain control-key combinations
       as dead keys, that will combine with the next character. This is
       modeled after Microsoft Word. The following table shows each key
       combination and its meaning. Note that in some cases you must include
       Shift in order to get the correct character:
          Key combination   Meaning         Combines with
          --------------------------------------------------------------
          Ctrl-`            grave accent    a e i o u A E I O U
          Ctrl-'            acute accent    a e i o u A E I O U d D
          Ctrl-6            circumflex      a e i o u A E I O U
          Ctrl-:            umlaut          a e i o u A E I O U y space
          Ctrl-,            cedilla         c C space
          Ctrl-~            tilde           a n o A N O
          Ctrl-&            ligature        a s A
          Ctrl-/            slash           o O
 
       So for example, if you type ctrl-colon (which is ctrl-shift-semicolon),
       you will see nothing; then when you type "a", Anzio will get an
       a-umlaut.
 
   3.4 COMPOSE command
 
       Anzio's command language includes a COMPOSE command. So you could build
       a macro, for instance, that would simply do
          COMPOSE
       This will prompt you, on the bottom line, to enter a two-character
       sequence, resulting in a special character or a character-diacritic
       combination. The sequences and their results are listed in the Anzio
       manual (starting 12.4). The command can also include one or both
       characters. So a command
          COMPOSE :
       will prompt you for the next character; if you enter "e", Anzio will
       receive "e-umlaut". The command
          COMPOSE :e
       will not prompt, but will immediately feed an e-umlaut to Anzio.
 
   3.5 UNICODE command
 
       The UNICODE command lets you enter the hex value of a Unicode character.
       For instance, the command
          UNICODE 1EF8
       will feed Anzio a Y-tilde. The command
          UNICODE
       will prompt you for the hex value.
 
   3.6 Paste from clipboard
 
       Whenever you paste into Anzio, whether to the host program or to the
       Function prompt, Anzio will pull Unicode characters from the clipboard
       if possible. So you can Copy data to the clipboard from various
       multilingual applications, such as Internet Explorer, Word, or Outlook,
       and paste it into Anzio. The converse is also true; you can copy from
       Anzio and paste into other applications.
 
   3.7 Macros
 
       Anzio's macros can contain Unicode characters, to be sent directly to
       the host. So you can build a library of often-needed international
       characters, words, or phrases, and invoke them just like any other user
       macro.
 
   3.8 Input Method Editors (IMEs)
 
       For Far East (CJK) character entry, Anzio supports Windows-level Input
       Method Editors (IMEs). So if you install and select a Japanese keyboard,
       for instance, and type with it, Anzio will understand that data. In
       Windows 2000, these IMEs are available in all locales. In earlier
       releases of Windows, you must have a Japanese version of Windows, for
       instance, to get the Japanese IME. For this reason we recommend using
       Windows 2000 for CJK (Chinese, Japanese, Korean) input.
 
   3.9 Add-on programs for CJK
 
       Anzio also works with most add-ons for Far East input, such as Union
       Way, WinMass, Twin Bridge, etc. However, it can be tricky to get the
       keystroke output of the add-on coordinated with Anzio's input.
       Generally, both need to be configured for UTF-8. Contact us for help on
       this.
 
With all these methods, Anzio receives a keystroke by its Unicode value. What
it does then depends on Anzio's configuration and ultimately on the
capabilities of the host system.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
4. International Support with Dynix
 
The Dynix system for libraries, from epixtech, can input and output in USMARC
encoding, which Anzio supports. The primary advantage of this is that you can
work with the full range of diacritics used in the library industry in western
libraries.
 
You will need to have epixtech install and configure a special terminal type
for you. Then, set Anzio's Communicate:Character Sets:8-bit:For Screen to
"USMARC". This tells Anzio that data coming from the host is in the USMARC
encoding.
 
With AnzioWin, you can do the same thing for printing (Print Wizard must be
ON).
 
With all this in place, Anzio will display (and AnzioWin will print) the full
range of USMARC special characters and diacritics, in any combination.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
5. International Support with Innopac
 
The Innopac system for libraries has various capabilities for international
character support. Each "terminal type" on Innopac has associated with it a
"diac table", which tells Innopac about the capabilities of the "terminal" to
handle diacritics, CJK, and other special characters. You would simply set
Anzio's Character Set to match what Innopac is sending out. Options include:
 
   VT220        Handles only a limited set (Latin-1) of diacritics.
 
   T160E        Handles about 400 special characters and diacritic
                combinations.
 
   Big5         Handles certain Chinese characters.
 
   CCCII        Handles over 20,000 Chinese, Japanese, and Korean characters.
 
   UTF-8        (Innopac r2001 and later) Handles the full range of Unicode
                characters. Allows intermixing of Chinese, Japanese, Korean,
                Russian, Turkish, diacritics, etc. simultaneously.
 
With this properly configured, Anzio can display all the needed characters.
Likewise, AnzioWin (not Anzio Lite) and Innopac can be configured to support
all these characters for passthrough printing.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
6. Additions to Advanced Options
 
The following items have been added to the Edit:Advanced Options dialog:
 
   a) SCOANSI compatible with pre-5.0.6
         If checked, Anzio's SCOANSI emulation emulates the console
         of older SCO Unix and Xenix systems.
   b) Printing initialization file
         Specifies what file is used to initialize printing (if it
         exists).
   c) Character set for output file
         Indicates which encoding to use for output from various
         capture and file transfer operations. Notably, UTF-8
         produces files that, when imported int Microsoft Word, can
         contain full Unicode.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
7. Interactive FTP (AnzioWin only)
 
It is now possible to do "point-and-shoot" FTP transfer within AnzioWin. A menu
item "FTP" in the Transfer menu will connect to the same host system, same
username, and same password as you are currently using. You can then select one
or more files to copy either direction between that host and your PC.
 
Another menu option, "FTP (different host)" prompts you first for the host
name, port, username, and password. This allows you to connect to an arbitrary
host system (different from the one you're telnetting to).
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
Notes on 12.4, updated:
 
1. In-place Activation
 
The downloadable demos of AnzioWin and Anzio Lite now use a license code, that
will enable them to be activated without the need for a new download or
installation. When you register your product, you will be given a serial number
and license code. When you enter this information, the program will no longer
"nag" you to register.
 
A license code will be valid for the lifetime of a point-release. So if you
register for version 12.4, and we later release version 12.4a, 12.4b, etc., you
can simply download the latest version and begin using it. However, at the
point 12.5 or 13.0 comes out, you will need a new license code, via our
standard update process.
 
Demo versions that have not been registered will cease operation after 60 days.
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2. SCO 5.0.6 Console Emulation
 
Anzio's emulation of "SCOANSI" has been enhanced to match changes made by Santa
Cruz Operation in SCO Open Server 5.0.6. This should still be compatible with
earlier versions of SCO. However, if you have compatibility problems there is
(in Anzio 12.5 and later) a compatibility switch, that will cause Anzio to act
like earlier SCO consoles.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
3. Script Engine Interface (AnzioWin only)
 
AnzioWin now allows you to invoke scripts, written in a variety of scripting
languages such as VBS. Arguments can be passed from Anzio to the script,
including data taken from the screen buffer. The script can also return
strings, which Anzio will treat as commands to run. More on scripting is at
   http://anzio.com/support/scriptctl.htm
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
4. Improved Macro Capabilities (Primarily AnzioWin)
 
In the past, commands in Anzio's macro language, and stored in .KYS files, were
limited to 255 characters, and were also always in the DOS (OEM) character set.
Both those restrictions have now been removed.
 
Macro commands can now be very long, and can contain ASCII characters, control
characters, keystrokes (such as <PageUp>), and Unicode characters. That means,
for instance, that you can create a macro to send Chinese characters to the
host. Or diacritics, Cyrillic, Hebrew, etc. Characters being sent to the host
are translated according to the current Character Set.
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
5. Multilingual Menus and Dialogs
 
Anzio now has built-in logic to handle language files containing user interface
elements such as menus, dialog boxes, and error messages. Currently we provide
   Spanish (as ANZIOESP.DLL)
   French (as ANZIOFRA.DLL)
   Italian (as ANZIOITA.DLL)
As we develop additional DLLs, you can simply download them, place them in
Anzio's directory, and they will be immediately usable.
 
You can change your language setting by going to View:Menu language. You can
also change it with the Anzio command "MENULANGUAGE", followed by the name or
number of the language. The numbering scheme uses Windows' standard language
numbers, such as 10 for Spanish. The language name can be given in the language
of the system, or in its native form, with or without the sort order in
parentheses. For example, on an English Windows system, to set the language to
Spanish, enter any of (case insensitive):
         MENULANGUAGE Spanish
         MENULANGUAGE Spanish (traditional sort)
         MENULANGUAGE Español
         MENULANGUAGE 10
(The word "Español" will not appear right in this file if you are using a DOS
program to view it.)
An error will cause Anzio to revert to English.
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
6. Phone Book Mode
 
We have made Anzio's "chooser" or "phone book mode" easier to find and to use.
A new menu item, created by Anzio's installer, brings Anzio up in chooser mode,
in which it will allow you to select from your available settings files; that
is, files with a ".DEF" extension that are in the current directory.
 
To establish a new connection, you may want to start with an existing
connection. Change whatever settings are appropriate, such as terminal type,
keys file, host IP address, etc. Then quit from Anzio. When it asks if you want
to save your settings, tell it "yes", and give it a descriptive file name,
complete with a ".DEF" extension, such as
   Main library.def
Then, when you start Anzio in chooser mode, you will see "Main library" as an
option.
 
You may instead want to start from a clean slate. Click the icon or menu item
"Anzio (new connection)", and answer the initial basic questions to get
connected. When you quit, save your settings as above.
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
7. Mouse Wheel Support
 
If your computer's mouse has a wheel, you can now use it in Anzio.
 
By default, scrolling the wheel UP will push Anzio into "review" or
"scrollback" mode, and you'll be able to see data that has scrolled off the top
of the screen. Continue to use the wheel to scroll through this data. When you
scroll back to the bottom of the buffer, you'll drop out of review mode.
 
You might prefer, though, to have the mouse wheel send arrow-key codes to the
host system. To do so, go to Edit:Advanced options:Mouse, down to Mouse wheel,
and select "Send arrows to host". In Pine on Unix, for instance, you can scroll
through your messages this way. Note that if you go into Review (scrollback) in
Anzio, though (via the menu or keystrokes), the wheel will continue to be
active.
 
Note too that if you hold the <Alt> key down when using the mouse wheel, your
setting will be ignored, and you will always go into Review mode, as above. So
you can have it both ways: plain wheel movements get sent to the host, and
wheel movements while <Alt> is pressed take you to Review.
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
Notes on 12.3, updated
 
1. SRP Authentication and Encryption (AnzioWin only)
 
AnzioWin now supports SRP, a protocol from Stanford University for
authentication (login and password) and encryption (of body text) in a telnet
connection. Information on SRP is at http://srp.stanford.edu
 
Your host (Unix) system will need to have certain components of SRP installed
on it. This is explained on the Stanford site. We can provide brief
instructions at no charge; further consultation is available and billable.
 
To tell AnzioWin to use SRP, go to Edit:Advanced options:Security. There are
two settings, each of which allows you to indicate whether SRP is
required, optional, or not wanted.
 
Authentication refers to the process of the client (Anzio) and the host
identifying each other, and ensuring that indentity. In SRP, this is based on
the password, but the password does NOT travel in cleartext across the network.
 
Encryption applies to the rest of the telnet session, after authentication.
Note that it is possible to use authentication, to prevent password sniffing,
but then to not use encryption, so as to reduce computational load on the host.
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2. Print Level = Spooler
 
We have added yet another "Print Level", called "Spooler". This is now the
preferred level to use when printing data that contains escape codes for
formatting, or to avoid formfeeds at end of job. To use, just select from the
File:Print level menu.
 
When set to Spooler mode, Anzio writes directly to the Windows spooler,
directed toward any printer that Windows can access. Compared to Raw mode, it
does NOT require that certain printer connectione be "captured". Thus Anzio can
now write low-level text directly to printers connected by all
Windows-supported methods, including printers on:
   * direct parallel connections
   * direct serial (Windows handles baud rate issues)
   * other Windows PCs
   * USB-to-parallel converters
   * Citrix clients
   * JetDirect and similar network interfaces
   * Novell servers
 
Because the spooler is used, there should be less problem of device contention
than with Raw mode.
 
When Print Wizard (in AnzioWin) is being used, if it detects escape sequences,
it will switch to Spooler mode (formerly Raw mode).
 
You can specify a different printer to be used for spooler mode, in File:Print
level:Spooler setup. This printer will be used if you manually configure to
Spooler mode, or if Print Wizard switches automatically. Note that this means
Anzio can be configured for three different printers, one for a) High and Low
mode, b) Spooler mode, and c) Raw mode. Switching the Print level then switches
printers.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
3. Print Wizard: Mini-page Logic for Labels
 
Print Wizard has new logic that is intended for use in printing labels, such as
library spine labels. Previously, we advised users to either print at the Raw
level, or configure a custom page size the length of one label. With this
improvement, Print Wizard should be able to print your labels. This has
advantages in font control, diacritic processing, etc.
 
Specifically, this technique is for:
   * Continous stock on tractor-feed
   * Print jobs consisting of just a few lines
 
Leave Print Wizard turned on. Set page size to a standard size, such as
"letter". Make sure "paper source" is set to "tractor feed". Print Wizard then
applies the following logic, when analyzing a print job:
   If paper source is "tractor feed"
   AND the number of lines in the print job (at 6 lines per inch) is less than
       80% of the page length
          THEN
             PW will create a custom page size just as long as the print job
             (at 6 lines per inch).
 
In addition, PW corrects for printer drivers such as the OKI 320 that make
rounding errors in page length.
 
The result is that if, for instance, you have a print job of 12 lines (printing
plus spacing lines), PW will print and advance exactly 2 inches.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
4. Print Wizard: Barcodes
 
We have added a capability in Print Wizard of printing many kinds of barcodes.
These do NOT require any special fonts; they are programmatically generated.
Barcodes are specified using Print Wizard Markup Language (PWML). The exact
specs can be found in the file Printwiz.doc, included with AnzioWin.
 
One way to use this would be to create a macro to pull various data from the
screen, and send it to the printer driver, forcing some of it into barcode
form. This could produce a label (using the mini-page logic), or a full sheet.
Of course, barcode legibility and durability will be determined by your
printer.
 
Please contact Rasmussen Software for assistance with this.
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
5. Print Wizard: Multi-page PCL Form Overlays
 
Print Wizard has for some time been able to print its text over a form image,
which was supplied as a bitmap. This gives you the ability to avoid some
preprinted forms. However, there is a sinficant load on the printer to print a
full-page bitmap.
 
We have now added another approach, but it works only on printers that use the
PCL language, and that are able to handle macros. This would include HP
Laserjet III and up, as well as others. With this approach, the form is in a
PCL printfile on disk, with a ".PCL" file extension. When you specify this file
as an OVERLAY to Print Wizard, PW will process it into one or more macros, and
load it (them) into the printer. If the file contains a single page, that page
will be printed on every page of output. If it contains multiple pages, they
will be printed in succession.
 
Here's an example. Suppose you access the IRS's web site, and download a
3-page tax form as a PDF file. You open it in Acrobat Viewer, and print it to a
disk file using an HP Laserjet III printer driver. Rename the file
"taxform.PCL". Now, in the beginning of your print job, list this file as an
overlay. For instance, place the following in the file "_prtinit.txt" in
Anzio's directory:
   <PWML><Pagesize overlay=c:\somedir\taxform.pcl><body><legacy>
Now, when you passthrough-print a print job, each page will be printed over one
page of the taxform, cycled in order.
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
6. Print Wizard: Support for filePro Database System
 
Users of the filePro database system, running on a Unix host, can now easily
make it generate Print Wizard Markup Language (PWML) in its print files. When
you use AnzioWin as your terminal emulation program, and configure filePro to
do passthrough (local) printing, AnzioWin's Print Wizard will process these
codes. You can then print formatted output on any Windows-supported printer,
including Windows-only printers and Windows fax drivers.
 
To use, just upload the files PRINTWIZ.PRT and PRINTWZC.PRT to your Unix
system, and place them in the same directory as other filePro printer drivers.
Then configure filePro to use PRINTWIZ for monochrome printers, or PRINTWZC for
color printers.
 
Printcodes are compatible with those in other HP printer drivers commonly used.
In addition, printcodes have been added to allow printing:
   * other fonts
   * the Euro character
   * barcodes
   * inline pictures
 
By adjusting these drivers, or by outputting PWML tags directly, you can also
print:
   * other international characters
   * bitmap forms overlays
   * PCL forms overlays
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
7. Print Wizard: Other Improvements
 
Many other improvements have been made in Print Wizard, and are documented in
the file Prinwiz.doc. Some highlights:
 
   * Bitmap files can be JPEG
   * Can specify duplexing (2-sided printing) in a tag
   * LEGACY mode works better with existing print files
   * White-on-black, and other background colors
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
Notes on 12.2, updated
 
1. Font Coverage for Diacritics
 
Many users of Anzio require it to handle a wide range of characters, notably
those character/diacritic combinations used in libraries. While Anzio has
supported this need for some time, there has been a problem in that Windows'
Courier New font, the font most often used with Anzio, does not contain all of
these characters. In the past we resolved this by providing our own font,
RSIMARC, which was derived from Courier New but with some additions. The
problem was, the font was ugly; it did not render characters as well as Courier
New did.
 
In version 12.2, we take a new approach. We have figured out how to tell
whether the font being used contains a particular character. If it does not,
Anzio tries several options, including displaying the character and then the
diacritic, displaying an alternate diacritic or character, and in the extreme
case using an internal bitmap for obscure diacritics. This process can be used
for printing as well as display.
 
The end result is that you can use Courier New instead of RSIMARC (which is no
longer provided), and your characters will look better. Just select Courier New
for Screen Font and for Printer Font.
 
Note that you will get the best results if you install Windows' support for
Eastern European languages, as this will expand Courier New to include more
characters.
 
(In version 12.5, this feature has been extended even further. See above.)
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2. JPEG Support (AnzioWin only)
 
AnzioWin's various mechanisms for dealing with bitmap files have been enhanced
to support JPEG files (with a .JPG extension), in addition to the previous BMP
and GIF support. JPEG is a compression scheme and file storage standard that is
especially appropriate for photographs. You can use JPEG files for:
 
   a) Screen background bitmaps
   b) Screen bitmaps such as photoes of employees, houses, parts, etc.
   c) Print Wizard overlays, as described above
   d) Print Wizard included images
 
JPEG files, like the other types, can be fetched from a local drive, a network
drive, or an FTP or HTTP server.
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
4. Passthrough Print Job Initialization File
 
This feature allows you to control, from the PC, certain initialization
processes to be applied to passthrough print jobs coming from the host
computer. Depending on Anzio's "Print Level", and whether Print Wizard is being
used (AnzioWin only), this can provide a wide variety of initialization
options. For instance, you could change orientation, page size, font, etc. You
could also include text, which would be printed first, before any data from the
host. And with Print Wizard, you could specify an OVERLAY.
 
The mechanism is fairly simple. When Anzio sees the beginning of a passthrough
print job, it checks the disk directory that contains the Anzio program, to see
if a file named "_prtinit.txt" is there (in the future you'll be able to change
that name). If it is, the entire content of that file, EXCEPT for a
return/linefeed at the very end of the file (if it's there), is sent to the
print engine BEFORE any of the print data from the host.
 
If you're running AnzioWin, and Print Wizard is turned on, this file can
contain Print Wizard Markup Language (PWML) commands as well as text. For
instance, the file could contain:
   <PWML><pagesize orientation=landscape overlay="c:\myform.bmp">
      <body leftmargin=1in><plaintext>
 
If Anzio's Print Level is Raw, then the contents of the file will be sent
directly to the printer. The file can then contain escape codes for that
particular printer type.
 
The file can be built in any plain text editor, such as NOTEPAD or EDIT. Note
that to include the Escape character in EDIT, you must hit <ctrl-P> and then
<Escape>. There may be no way to do this in NOTEPAD.
 
More information is in README.TXT.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
5. Modem Handling Improvements
 
Several improvements have been made in Anzio's interaction with a modem
(using TAPI), besides some bug fixes. Here are the main ones:
 
   5.1 Anzio's Communicate:Setup box now includes a place for the phone number,
       which is required for you to hit "OK".
 
   5.2 When you do Setup for the modem (from Anzio's Communicate:Setup), the
       changes you make are retained in Anzio's parameter file, and used
       whenever a new connection is made. If you need to dial in to a host that
       expects a 7-bit even-parity connection, for instance, you can set that
       there.
 
   5.3 If you're dialing in to a modem that will only communicate successfully
       if you connect at a certain rate, such as 9600, you can set that rate in
       the modem's setup, under "Maximum speed". This may not work on all
       modems. The best solution, however, is to properly configuring the host
       end modem.
 
   5.4 The Login Wizard will now function on modem connections.
 
   5.5 The setting "Auto connect on startup" now applies to modem as well as
       network connections. Consequently it has been moved out of the Network
       submenu into the Communicate menu.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
6. Programmability Improvements (ONERROR, ONSTARTUP)
 
Many Anzio users and administrators need to automate various aspects of Anzio's
behavior, especially when it starts up. New features in 12.2 make this easier.
 
   6.1 ONERROR - This command tells Anzio that certain operational errors and
       failures should cause it to execute a certain macro. Like other Anzio
       commands, this one can be entered from Anzio's Function prompt, or
       issued from the host, or executed as part of a macro. The syntax is:
          ONERROR <m>
       where <m> is a one-character macro designator. For instance,
          ONERROR E
       would tell Anzio that if an error occurs, it should execute the macro
       named "E". The kinds of errors that will cause this, as well as other
       details, are listed in README.TXT.
 
   6.2 Startup Macro - Previously, you could tell Anzio to run a macro on
       startup by naming that macro in Anzio's command line. Now you also have
       the option to have a startup macro identified in the settings
       (parameters) file that Anzio uses. This macro can be identified in
       Edit:Advanced Options:Keys, or with the ONSTARTUP command.
 
       Other changes affect how Anzio behaves when a startup macro is running.
       For instance, if "Auto connect on startup" is OFF, no connection will be
       established until the macro initiates it. For instance, this macro
       combination will do a programmed dial and login, and will notify the
       user of failures:
          DEFINE E <f6>MESSAGE dial failed|<enter>
          DEFINE L <f6>MESSAGE Login failed|<enter>
          DEFINE S <f6>ONERROR E|<f6>DIAL 999-1234|<f6>ONERROR L|
            <f6>WAITFOR Login 5|mylogin|<enter>
 
More information is in README.TXT.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
7. Notes on Sound
 
In a terminal environment, the host system can cause the "terminal" to beep by
sending a BELL character (control-G, hex 07). Anzio responds by trying to make
your PC beep. However, depending on your PC's hardware, this is difficult,
especially in the case where the PC has a sound card but no speakers attached.
We've now tried to cover more of these contingencies.
 
Start by going to Edit:Advanced Options:General, and looking at Beep Type. If
you have a sound card and speakers, you can select any of the sound names,
which are related to wave files in the Control Panel:Sounds applet. If you
select "PC Speaker", Anzio will tell Windows to use the speaker built in to the
PC's motherboard. However, this is a short "chirp" which you may not hear, and
this behavior seems not to be configurable. You then have two options:
 
   7.1 Windows NT and 2000 allow us to issue a tone at a certain pitch from the
       motherboard speaker. Anzio controls this with the PITCH command, which
       is not yet accessible from the menu. Do <alt-M>, then type
          PITCH 1000<ENTER>
       for instance to cause the beeps to happen at 1000 hertz.
 
   7.2 Windows 95 and 98 don't give us that option. The only solution is to
       install the "speaker driver" from Microsoft. See their instructions at
         http://support.microsoft.com/support/kb/articles/Q138/8/57.asp
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
Notes on version 12.1, updated
 
1. Right Mouse Context Menu
 
The new default action for the right mouse single-click is to open a popup
menu, sometimes called a context menu. You shouldn't have to do anything to
enable this feature; if it appears not to be working, go to Edit:Advanced
Options, as explained below.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2. TAPI Modems
 
Starting in 12.1, Anzio has support for connection via TAPI (Telephone
Application Programming Interface). Earlier Windows knew only about serial
ports; an application such as Anzio had to know that the serial port was
connected to a modem, and the application had to manage dialing and hanging up.
With TAPI, Windows knows about the modem, and how to dial it. Now Anzio can be
set to use a particular modem, by name, rather than by comm port. When Anzio
needs to dial, it tells TAPI to do it. And so forth.
 
TAPI support in Anzio solves several problems, including: a) some modems work
only with TAPI; b) Anzio can "borrow" a modem from fax reception software, for
instance; c) some network-pooled modems can be accessed only with TAPI; and d)
modems may have some special features that only TAPI will support.
 
The Communication Settings dialog in Anzio now lists "Modem" as an alternative
to "Telnet" and "Serial", and it will show your available modem(s). The nearby
"Setup" button allows you to configure that modem. Another box allows you to
enter the phone number to dial -- this box must have an entry.
 
There are ways of specifying a TAPI connection, including the phone number,
from the command line, e.g.,
         c:\anzio\anzio32 modem://phonenumber
See the README.TXT file for more info.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
3. IMEs in Windows 2000
 
Windows 2000 (a.k.a. NT 5) takes a large step in supporting multiple languages
from one installation. Especially important is support for Far East languages
Chinese, Japanese, and Korean (CJK). Because these languages have so many
characters, they use various Input Method Editors (IMEs) for character entry.
These IMEs can be installed and run on, for instance, a US Windows 2000
installation.
 
Anzio 12.1 has special code to support input of Far East characters via IMEs.
You shouldn't have to do anything to enable this feature in Anzio. Of course,
you must be connected to a host system that supports one or more of these
languages, have an appropriate Character Set selected, and have an appropriate
Screen Font selected.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
4. Entering Unicode Characters
 
Unicode is a standard for 16-bit characters that represents all the world's
major languages. If you are entering data in, for instance, a CCCII system, you
may know the Unicode value of a particular Chinese character you wish to enter.
You can now use Anzio's new command "UNICODE/S" (or UNICODE or UNIC) to enter
that character. For instance, if you do
   <alt-M>
   UNICODE<enter>
Then Anzio will prompt you for the Unicode value, up to 4 hex digits. This
character is then sent to the host, using the current Character Set encoding.
 
The command itself can also include the value, such as
   UNICODE 212B32
 
Unicode values can also be used for non-CJK characters, such as characters with
accents or diacritics, Cyrillic, Greek, Hebrew, etc.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
5. Rlogin
 
Version 12.1 has added the rlogin protocol, which is similar to, but simpler
and in some cases faster than the telnet protocol. Generally, you should use it
only if you know you need to. Just select "rlogin" instead of "telnet"
(formerly "TCP/IP") in the Communication Settings box.
 
You can also specify an rlogin connection from the command line, e.g.,
         c:\anzio\anzio32 rlogin://somehost.com
More examples are in README.TXT.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
6. The PrintScreen Key
 
It's such a simple idea! The PrintScreen should print the screen. Now it will,
unless it is disabled (see Advanced Options).
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
7. Bitmap Enhancements (AnzioWin only)
 
AnzioWin has long had the ability to show a bitmap graphic on the screen,
either on the entire screen or in a specified area. Text can be displayed over
the graphic. This can be used for a) a watermark screen background, b)
host-directed display of pictures of employees, houses, parts, etc., c)
text-over-forms applications, or d) whatever your imagination comes up with.
 
Enhancements in 12.1 provide more flexibility in this feature:
 
   * A graphic identified as a WATERMARK will show clear to the edge of Anzio's
     window, instead of just to the edge of the character space.
   * A graphic can be shown in a location identified in character coordinates,
     where previously it would be located only in pixel coordinates.
   * A graphic can be in GIF form (previously only BMP) (or JPG in 12.2).
   * A graphic can be fetched from an FTP or web server (previously only the
     PC's disk).
   * A graphic can be displayed zoomed to fit the specified space, while still
     maintaining its aspect ratio.
   * When the screen containing a graphic is printed, if Print Wizard is ON,
     the screen's aspect ratio will be maintained, so the bitmap will look
     right.
 
To load a watermark graphic, just do File:Background Bitmap. Other uses of
graphics are beyond the scope of this file. See the README.TXT and the Anzio
manual, then contact us for more information.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
8. Print Wizard Enhancements (AnzioWin only)
 
Anzio 12.1 adds the new features of Print Wizard 2.0, all related to Print
Wizard's markup language. These are detailed in the Print Wizard documentation,
but are highlighed here:
 
   * Included graphics can be in GIF (as well as BMP) form (12.2 allows JPG).
   * Graphics files can be fetched from an HTTP or FTP server
   * A new OVERLAY option allows for a full-page form overlay
   * Text color can be specified
   * Any character in Unicode can be specified to be printed
   * The Euro character can be printed
   * Various dimensions, such as for text or graphic placement, can now be
     specified in units of inches, centimeters, etc.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
9. Sounds
 
Anzio has long had the ability to play wave (.wav) files to make sounds on
suitably-equipped PCs, using the PLAYSOUND command. Like most Anzio commands,
this command can be sent from the host. Two new features make this more
powerful.
 
First, Anzio can be instructed to play the last file that was downloaded from
the host. So for instance, if a Unix system has a file "mailcall.wav", the
following two lines will download it (using Zmodem) and play it:
   sz mailcall.wav
   printf "\034playsound \${anz_last_recd}\035"
 
Second, the playsound command can now read the file from an FTP or HTTP server
and play it. So, for instance:
   printf "\034playsound ftp://ftp.anzio.com/pub/tada.wav\035"
This method requires a module called WININET.DLL, which comes from Microsoft as
part of various packages.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
10. Printing Net-based Files
 
Anzio's PRINTFILE command is a quick way of printing a file that exists on the
PC, using Anzio's print engine. If Print Wizard is turned on, it will be used.
Now, the PRINTFILE command can fetch the file to be printed from an FTP or HTTP
server. For instance,
   <alt-M>
   PRINTFILE ftp://ftp.anzio.com/pub/anzdiff<enter>
This also requires WININET.DLL as described above.
 
This opens up a new possibility in host-to-PC printing. A host system could
generate a printfile, and place it in its FTP directory. Then, either a) the
host could command Anzio to fetch and print the file, or b) the PC user, when
it was convenient, could cause Anzio to fetch and print the file.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
11. DDE Commands (AnzioWin only)
 
DDE is a method by which one Windows program can communicate with another.
Although it has been superseded by OLE, COM, etc., it remains a fairly simple
way to accomplish some tasks. AnzioWin 12.1 adds support for DDE, in the form
of several commands as listed below. Typically, you would program these
commands into Anzio macros, or send them as Anzio commands from the host
system. This makes Anzio work as a DDE client; we do not yet have support for
Anzio as a DDE server.
 
To use DDE, you must know the "language" of DDE that is supported by the server
application. With a few exceptions, we can't help you there -- you'll have to
rely on that other software's documentation.
 
AnzioWin's DDE support is modeled after that provided in Excel (and other
Office packages). However, Anzio supports only one "channel" or "conversation"
at a time. Anzio's DDE commands are:
   DDEINITIATE <programname> <topicname>
   DDEPOKE <item> <data>
   DDEREQUEST <item>
   DDEEXECUTE <command>
   DDETERMINATE
 
Note that the data returned from the DDEREQUEST function will be sent to the
host, unless redirected into another command.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
12. Faxing with WinFax Pro via DDE (AnzioWin only)
 
This feature has stopped working, with recent versions of WinFax Pro (9 and
10).
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
13. Faxing with MAPI (AnzioWin only)
 
AnzioWin has a command MAPISENDFAX, which can initiate an outbound fax through
the messaging system (MAPI) that is part of Windows. Note that Windows does not
automatically come with a component that will fax. You must be sure you have
obtained and installed a fax program, compatible with MAPI, before using
Anzio's MAPISENDFAX command.
 
Sending a fax with MAPISENDFAX (and MAPI in general) is considerably different
from the approach shown above for WinFax Pro. The process works like this:
   1) You tell MAPI that you want to fax a particular document file.
   2) MAPI makes sure that it has all the necessary information, including
      destination fax number, cover sheet options, etc.
   3) MAPI looks at the file's extension, and uses Windows' file type system
      to determine what program should "print" that file. Specifically, it
      looks for the "printto" action, and does the indicated command. Part of
      the command would ordinarily include "%2", which is replaced by the name
      of the fax printer driver which the application should print to.
 
The syntax for the command in AnzioWin is:
   MAPISENDFAX <phonenum> <filename> <profile>
where <phonenum> is the destination fax number, <filename> is the complete
pathname of the document, and <profile> is a user profile as configured in
Windows/MAPI. The profile is optional. If it is not mentioned, the default
profile will be used. The profile indicates whether a cover sheet should be
sent, and other details.
 
Because MAPI must send an existing file instead of being piped to, it makes it
more difficult to fax from Anzio this way than with the WinFax approach shown
above. You must print the document to a file, typically without adding any
printer-specific codes, and then tell MAPI to fax it. Unfortunately at this
point, AnzioWin is not set up so that MAPI can use AnzioWin to print a
document. We'll look at this. For now, if you wanted to use the Print Wizard
logic in processing the print data, you would need to have a freestanding copy
of Print Wizard (a separate product from AnzioWin).
 
Some additional information is included in PrintWiz.doc.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
14. Working with Word Perfect for UNIX
 
Anzio now has enhanced support for Word Perfect (WP) for UNIX, in the form of
an expanded 'anziotic.kys' file, with more key definitions, and a new
'anzio121.trs' terminal definition file for WP. This accomplishes:
   * Keyboard layout now aligns with WP/DOS and WP/Windows support
     for the enhanced PC keyboard, where F11 is Reveal Codes and
     F12 is Block. Ctrl-Enter now does hard page break. For other
     keys, do F3 F3 in WP.
   * WP is now able to display many International characters, using
     Anzio's support for UTF8 (Unicode) characters.
To enable these new features:
   * Set Anzio to an emulation type of 'anzio'
   * Be sure the (new) keys file 'anziotic.kys' is loaded
   * Place the file 'anzio121.trs' in Word Perfect's 'shlib' directory
   * Set TERM or WPTERM or WPTERM51 to 'anzio121'
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
15. Online Demo Site
 
We hope to have set up soon a machine you can telnet to, that will demonstrate
many of the features of Anzio.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
16. Arabic and Hebrew
 
If your host system, to which Anzio is connected, is displaying Arabic and/or
Hebrew, there are varying approaches to handling the issues of reordering
(right-to-left) and reshaping (of Arabic). In simple terms, we have to know
whether the host system is doing these tasks or Anzio should be doing them.
 
On Arabic and/or Hebrew enabled Windows systems, including Windows 2000, Anzio
CAN do them, or can be told NOT to. This is done in the Edit:Advanced Options
dialog box.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
17. New Installer
 
Effective with version 12.1g, we have a new installer, based on Install Shield.
This has several improvements over our old method, including:
   * Support for long file names
   * Support for installing fonts
   * The option of making Anzio your default telnet handler
   * Creation of an uninstaller
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
18. Other Changes You May Have Missed
 
Be sure to check the README.TXT file for changes significant and minor since
your previous version. Here's a list of major changes starting with 12.0a,
which have not been covered elsewhere in this document:
 
* Character set options
* RAW-SETUP, to specify port and configuration to use for raw printing
* Support for AUX serial input, as from a barcode reader
* Allow bold fonts on screen, printout
* CLONE command to create another identical session
* FTP commands for file transfer
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
19. Advanced Options Dialog Box
 
Go to Edit:Advanced Options to see the new tabbed Advanced Options dialog box.
This provides access to many configuration items that were previously
accessible only with HEXPATCH commands. The following explains the items:
 
   Mouse
      Mouse action (left double-click, etc.)
         Sets what Anzio does on each kind of mouse action. Note that
         for left click, Anzio actually uses this to select part
         of the screen.
      Block type
         Determines what shape is selected by dragging the mouse.
   Security
      Single instance (normally off)
         Controls Anzio's option to allow only one instance of Anzio to run
         at a time.
      Allow functions in kiosk mode (normally checked)
         When running in kiosk mode, should we allow Anzio functions which
         are contained in macros?
      Prompt to save parameters (normally "when changed")
         Controls when the "Parameters are changed, do you wish to save them:
         message comes up.
      Respond to control codes
         Hex-11 = Anzio command (normally off)
            This is a very old command usage, required with some file transfer
            software from Rasmussen Software
         Hex-1C = Anzio command (normally on)
            Turning this off will disable host-issued Anzio commands
         Ctrl-R = Passthrough print (normally on)
            Refers to DC2/DC4 control of an "aux" printer
         Ctrl-X = passthrough print (Wyse) (normally on)
            Some models of Wyse allow ctrl-X to start passthrough print
   Keys
      Allow accelerator keys (normally on)
         If you need to assign a macro to a key such as shift-insert, that
         ordinarily causes a menu action, temporarily disable this item
      Recognize PrintScreen key (normally on)
         Should the PrintScreen key print the screen?
      NumLock is programmable (normally off)
         If you really must assign a macro to NumLock, enable this item
      Startup Macro (in 12.2)
         The name of the startup macro to be run automatically, as described
         above.
   Screen
      Send window size to host (normally on)
         On some host systems, when connected via telnet, changing window
         size (such as going from 80-column to 132-column) causes problems;
         if so, disable this item
      Allow variable-spaced fonts (normally off)
         If you need to use a screen font (such as for Chinese) that reports
         itself as variable-spaced, enable this
      Window style (normally all on except Popup)
         Controls the features surrounding the window, on next startup. Not
         all combinations are legal.
      Arabic/Hebrew options
         Controls how Anzio will render Hebrew and Arabic, on systems that
         support that.
   General
      Euro character (normally disabled)
         Lets you specify a custom hex value to be used on the host to store
         the Euro character.
      Capture control characters (normally "All except Escape sequences")
         When you do a Capture to Printer or Capture to File, this setting
         controls which control characters and sequences are captured.
      Beep type (normally "Default")
         Controls what kind of sound Anzio will make when a beep is issued
         from the host.
      Auto-display GIF downloads (AnzioWin only) (normally off)
         If checked, whenever a GIF file is transferred from the host to the
         PC, it will automatically become the current screen bitmap.
      Debug printing
         When enabled, Anzio (and particularly Print Wizard) will give
         you various information on how it is printing (see below).
      Login Prompt (normally "login:|logon:|user:|username:")
         The Login Wizard watches for this string (or any of a series of
         strings, separated by "|") as a login prompt.
      Password prompt (normally "password:")
         The Login Wizard watches for this string as a prompt for the
         password (it can also contain several substrings).
      Prompt separator (normally "|")
         This is the character that separates substrings in the previous two
         items.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
20. Debug Printing
 
If you turn on "Debug Printing" in the Advanced Options (as above), Anzio's
print engine will give you information on how and where it is printing. This
can be very useful to analyze printing problems. This information is provided
in a series of message boxes. If you hit "Cancel" in any of these, the Debug
Printing will be turned off.
 
First, it will tell you on what printer or device it is printing (or attempting
to print). Then, if Print Wizard is being used, it will tell you if it switches
over to RAW mode. If it doesn't switch to raw mode, it will tell you its steps
in analyzing the print job and the conclusions it reaches about font size,
line spacing, and pagination. Also, if Windows selects a font other than what
you requested, it will tell you what you got.
 
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
Notes on version 12.0, updated
 
1. Character Set Support
 
SEE UPDATED INFORMATION above for version 12.5.
 
Anzio is now very international. It can handle characters in multiple
languages, scripts, character sets, etc. (although the user interface is not
yet internationalized). It supports CJK (Chinese, Japanese, and Korean) in a
variety of ways. It supports Hebrew and Arabic. In general, all these character
sets can be supported on any localized installation of Windows, if the
appropriate modules from Microsoft are downloaded and installed. There are some
restrictions on CJK and bidirectional (bidi) languages Hebrew and Arabic, as
noted below.
 
Internally, Anzio stores every character as Unicode (a 16-bit scheme that
encompasses all major languages). You must tell Anzio what coding scheme is
used by the host computer system. Then Anzio is able to translate every
character it receives from the host into Unicode, for display on the screen.
 
Keystrokes can be accepted from any Windows keyboard driver, and from certain
Input Method Editors (IMEs) for CJK. Characters are translated properly when
sent to the host. Clipboard operations are done correctly.
 
For printing of international character sets, Print Wizard (and therefore
AnzioWin) is required.
 
In general, what is required is to tell Anzio what character set or encoding is
used by the host software. This is done in Communicate:Character set. In
addition, you may need to select a different font. Microsoft has many good
fonts available on the various update web pages for Internet Explorer.
 
Following are a few special cases, restrictions, and notes:
 
a) To do CJK with Innopac, tell Innopac you're a CCCII terminal, set Anzio's
character set to CCCII, and choose a font such as MS Song.
 
b) To get full diacritics with Innopac, tell Innopac you're a T160E, set
Anzio's character set to T160E, and choose RSIMARC as your screen font (in 12.2
use Courier New instead).
 
c) For CJK input on Far East versions of Windows, no special setup is required.
 
d) For CJK input on Windows 2000, just make sure the appropriate language
support (for Windows) is installed. This is available an ALL versions of
Windows 2000.
 
e) For CJK input on NON-Far East versions of Windows 9x/NT, it is possible to
use add-on products such as WinMass or UnionWay. Contact us for help. We do
NOT yet have support for the "Global IME" available from Microsoft.
 
f) For bidi languages (Arabic and Hebrew), if the host system manages
reordering and reshaping, you can run on any Windows platform containing the
needed font. However, if the host outputs data in logical order, and Anzio has
to reorder/reshape, you must be running on a Windows platform with support for
that language (this is also available on any installation of Windows 2000).
 
g) You can create your own custom character mapping for 8-bit character sets,
by editing the file CUSTOM.UNI, and selecting "custom" as your character set.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 
2. Raw Printer Improvements
 
When Anzio is set to Print Level of Raw, or when Print Wizard is on and it
recognizes escape codes in the data stream and reverts to raw, Anzio writes out
to a file named, for instance, "LPT2". It derives this name from the printer
selected in Printer Setup. (In fact, that's all the printer driver/selection is
used for in raw mode.) The process for determining that name has been changed
in version 12, so it should work in more cases. Specifically, printing from NT
to a networked printer should now work.
 
If the printer is attached to a Novell server, you need to configure the
printer carefully for Anzio to be able to print raw to it. Configure it (to
Windows) as through it were on a local parallel port, such as LPT3. Then use
Novell's CAPTURE command to redirect LPT3 to the particular server printer
queue.
 
Other enhancements involve handshaking with the printer, and what happens when
it's busy. First, if the derived name indicates a comm port, Anzio will now set
up the port to make sure handshaking is used. Also, timeouts are established so
that Anzio will not "hang" when the printer gets busy or is otherwise not
ready. In those cases, if the printer stays not ready for 10 seconds, Anzio
will pop up a dialog box notifying you of that, and allowing you to cancel.
 
Effective with version 12.0c, you can exercise more control over the raw
printer. First, you can specify the port name directly. So, if your normal
printer driver writes to a printer on LPT1, you can now specify that your raw
print should go to LPT2, a different printer. Note that this means that Print
Wizard can function as an automatic printer switch, sending high-level printout
to one printer, and raw-level data to a different printer.
 
Finally, if the raw printer, either explicitly or implicitly, is on a serial
port, you can specify the baud rate, parity, etc. to be used.
 
To explicitly specify the raw printer destination, or configure the serial
port, just enter the command (after doing <alt-m>):
   RAW-SETUP
Enter the port name, or erase the name shown to revert to using the name
derived from the printer driver. Then, if it's a serial port, the program will
prompt you for port settings. (In 12.2, there is a menu item
File:Print level:Raw setup).
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
3. Kiosk Mode
 
This is a way to limit the menu options given to a user. It is offered as an
alternative to earlier methods, which included removing menu items with a
resource editor and changing the "style" of the window. Those options still
remain.
 
This method is activated with a command-line switch. That is, when you
construct a Windows icon or Start-menu item, or configure a web browser to
launch Anzio, you can insert options which Anzio will see. In this case, the
command line contains either "/k" or "/k:nnn", where "nnn" is a number. The
parameter is case-insensitive.
 
Any use of "/k" qualifies as kiosk mode. When Anzio sees that it is in kiosk
mode, it does not load its standard menu. If nnn is zero, NO menu is used;
otherwise, a special limited menu is loaded, and then stripped down according
to the value of nnn (if given). The nnn value, specified in decimal, represents
a sum of bit values, where each bit indicates a menu item to include. Values
are:
         1 = Print Screen
         2 = Eject
         4 = Quit
         8 = Capture to printer
        16 = Capture to file
        32 = Copy (to clipboard)
        64 = Paste
       128 = Dial
       256 = Hangup
 
Note that there is no way to save parameters. Note that if Quit is removed, the
only way to quit from Anzio is to quit the host application, on a TCP/IP
connection.
 
For kiosk applications of this sort, you will also want to prevent the user
from running Anzio in other ways, such as through Start:Run or a command
window. That's up to you.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
4. Using a Custom Euro Character
 
The introduction of the Euro character has brought about the need to
modify many previously standardized coding schemes. For instance, maybe your
host stores its data according to ISO-8859-2, but now you need to store the
Euro character somewhere, and be able to input, display, and print it.
Instead of requiring a custom translation table, we have made it possible to
tell Anzio where you want to store it.
 
To continue the example, suppose you decide that you want to store it as hex
F7, because you don't really need the "divide" symbol. To do that, go to
Edit:Advanced Options:General, enable the "Euro character", and enter "F7".
 
The Unicode standard sets a value for the Euro character as 20AC. More
important, Microsoft has assigned it a place in many codepages at hex 80
(decimal 128). Thus you can enter this character by doing <alt-0128> (using the
numeric pad). On many European keyboards (if drivers have been updated),
you can do <AltGr-e>, where <AltGr> is the right <alt> key.
 
When Anzio receives that character, if the Euro variable has been set as above
and is not zero, Anzio will send the contents of the Euro variable. Translation
in the reverse direction will also take place.
 
Note that the Euro character translation takes precedence over the CHARSET
translation.
 
For another approach, effective 12.0q, Anzio supports the pending standard
ISO-8859-15, described elsewhere.
 
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
5. Using AUX Input for Barcode Readers, etc.
 
On a dumb terminal, the "aux" port was a second serial port, sometimes used for
a passthrough printer. But alternatively, it could be used to receive serial
data from a device such as a barcode reader or electronic scale. Or, sometimes
these devices were "wedged" into the serial line to the host.
 
Anzio now supports serial input from a COM port on the PC, regardless of
whether the PC is connected to the host via serial or TCP/IP. Note that in the
first case, two serial ports would be used.
 
To configure aux input, do the command (after hitting <alt-M>):
   AUX-SETUP
This will prompt you for the port name, and then the port settings. Then, to
enable receiving serial data, do
   AUX ON
and conversely,
   AUX OFF
 
When ON, characters sent by the serial device will be sent to the host just as
though they'd been entered from the keyboard. Also, an AUX indicator will show
on Anzio's status line (if it's turned on).
 
Wiring a serial keyboard wedge can be tricky. We recommend that you wire the
HOST side (not the keyboard side) of the wedge, through a null modem, then
through a 25-to-9 pin adapter if needed, to the PC serial port.
 
Effective with 12.3h, there is an AUX-DEBUG command, that lets you see what the
AUX port is sending Anzio. Effective 12.4, this can be enabled from the
Advanced Options box.
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
6. Integrated FTP
 
We have added commands to AnzioWin (not Lite) to allow FTP file transfers both
to and from the PC. AnzioWin acts as the FTP client. Commands can be entered
manually, programmed into Anzio macros, or sent down from the host. So a
program or shell script running on the host can direct Anzio to FTPGET or
FTPPUT from/to the same host Anzio is communicating with, or a different host.
 
Of course this works only over a TCP/IP connection. It also requires a module
on the Windows PC named WININET.DLL, which is provided with some versions of
Windows as well as with Internet Explorer. If you need this feature, and do not
have WININET.DLL, please contact us.
 
This feature does NOT make Anzio an FTP SERVER, just an FTP client that is
programmable.
 
The commands in AnzioWin's language are FTPGET, FTPGET/S, FTPPUT, and FTPPUT/S.
The GETs move a file from the host to the PC, the PUTs go from PC to host. In
other words, everything is from Anzio's perspective. The "/S" suffix means that
Anzio will send a result code to the host when the transfer is finished. This
not only lets the host know whether the transfer succeeded, but also can serve
to synchronize a host-based script with Anzio. The result code for success is
"00" followed by <enter>.
 
As an example, suppose you want to move a file named "myfile" from your own
home directory on the host to your PC. Just do (after an <alt-M>):
   FTPGET myfile
These commands assume that you are dealing with the same host, the same user
login, and the same password that Anzio is already accessing. Be sure you have
the username and password entered in Anzio's Communicate:Login menu.
 
You can use any of the following variations:
   FTPGET ASCII myfile
   FTPGET myfile pcfilename
   FTPGET hostname/myfile
The full syntax is:
   FTPGET[/S] [ASCII] <hostfile> [<PCfile>]
where <hostfile> can be a name, a pathname (with either kind of slash),
or a URL matching:
   username[:password]@hostname[:port]/filepath
(note that you can't do username and filepath but not hostname). The
"ASCII" modifier causes an ASCII (text mode) transfer.
 
If <PCfile> is not given, the PC file name will be derived from the basename
(name without directories) of the hostname. Anzio's DOWNLOAD DIRECTORY will
affect downloads (FTPGET[/S]).
 
FTPPUT uses the same syntax as FTPGET:
   FTPPUT[/S] [ASCII] <hostfile> [<pcfile>]
 
One more example, a shell command telling Anzio to do a transfer:
   printf "\034ftpput/s uploaddir/newfile c:/transfer/upfile\035";read rslt
(note that using forward slashes simplify the shell scripting).