-------------------------------------------------- Instructions for using some of the new features in AnzioWin, Anzio Lite, version 17.2 -------------------------------------------------- I. INTRODUCTION This file describes certain features of AnzioWin and Anzio Lite that are new in version 17.2. 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 17.1, 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). * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Changes in 17.2 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 1) Updated Location Awareness (AnzioWin only) With updated support in AnzioWin and Windows 10, AnzioWin can be "location aware". Or more typically, software running on the host computer can be aware of the location of the PC running Anzio. Possible uses include fleet tracking, login security, checking the location of product delivery, etc. This implies that the PC running Anzio is mobile yet connected. It might be a laptop being used in a coffee shop, or a Windows tablet being used in a vehicle with wifi, or a Windows device connected via a mobile hotspot (such as a cell phone). Location is as good as Windows can provide at that point in time, dependent on the location data provided by the network connection. To test your PC's location, use the Windows Maps program. For the host program to inquire about the location of the device running Anzio, the host should send Anzio the command LOCATION/S (The protocol for sending Anzio a command is documented in the Anzio manual.) The host should then accept an alphanumeric string input (as though the user was typing). AnzioWin will query Windows for its location, then send a string in the following format: ,,, followed by a . The first three variables are reported in degrees in floating decimal format. The is reported in meters, in floating decimal format. Here is an example provided by a PC running in the Rasmussen Software office in Portland, Oregon, USA: 45.445620,-122.786728,0.000000,83.00 If Windows cannot report a location, Anzio will return 0.000000,0.000000,0.000000,-1.00 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 2) Virtual Scroll and Virtual Clear Support Anzio's screen scrollback feature (Diagnose:Review) is a handy way of seeing the history, of the screen - what used to be displayed. It captures individual lines that scroll off the top of the screen. Also, when the screen is cleared in various ways, it captures a whole screenful of lines. However, sometimes the screen driver on the host clears the screen by repainting every line. Similarly, it simulates scrolling by redisplaying certain lines. In the past these lines were lost. Effective with 17.2, however, Anzio will detect these situations, and will now capture the lines in most cases. Anzio's new default behavior is to do this; you don't need to turn it on. If you find you need to turn it off, edit the settings file using Notepad; find 'virtual-scroll' and set it to zero; same for 'virtual-clear'. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 3) Email Setup Testing (AnzioWin only) In the Edit menu's Email Setup item, there is now a button labeled "Test email". When you have entered the various items to configure how AnzioWin should to its emailing, you can click the "Test Email" button to initiate an email (to yourself). If the email fails to send, you will see error messages in popups that may help you diagnose the problem. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 4) Miscellaneous Debug Window A new debug window shows miscellaneous messages related to screen size, ink (screen markup), Smart Paste, Review, etc. There is not a menu item for this feature. Use the Anzio command (such as from Macros:Enter Function): DEBUGMISC [ON]|OFF|TOGGLE You can also turn this on at startup by using the command line parameter: /DEBUGMISC * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Changes in 17.1 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 1) Windows 10 Support and Per-monitor DPI Windows 10 brought only one known incompatibility to Anzio 17.0. This was trivial and cosmetic, and was fixed in Anzio 17.1. But Windows 10 did bring a new feature of interest: the ability to track and process a different pixel density (dots per inch, DPI) on each monitor, and a different user-preferred magnification factor on each monitor. This is especially important with the availability of high density displays, even ultra-high density (4K) displays both as desktops and laptops. The old behavior would give very different sizes to graphical elements and text on different monitors. But Anzio 17.1, running on Windows 10, is smarter. When you start up Anzio Lite or AnzioWin, it should react to the DPI and magnification factor of the monitor it opens on. When you drag the window to a different monitor that has a different DPI and/or a different magnification factor, some sizes will be adjusted. The same is true of most dialog boxes, such as the FTP/SFTP window in AnzioWin. You do not need to configure anything in Anzio in regards to this feature. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 2. SSH Key Sharing (AnzioWin only) When you have an AnzioWin session running, having an SSH connection to the host, and you start another AnzioWin session to the same host system, the second session will ask the first session to share its username and password. If the first session has retained those, it will share this information. So the user will get logged in automatically in the second session. There is currently no configurability for this feature. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 3) Installation and Deployment options Administrators of large networks have asked for explanation of their options for automating the deployment of Anzio Lite or AnzioWin to multiple client PCs. Some tools are available that can assist with this process, such as SCCM and Group Policies. However, we are not able to investigate these tools, much less stay current as they change. Following is our current knowledge of the situation. There are generally three parts to deployment: a) program installation; b) settings file distribution; and c) license distribution. See below for b) and c). Automated installation usually revolves around an installation file with a ".msi" extension. So we now make available a .msi installer for each program, each version. If an appropriate .msi does not appear to be available at anzio.com, please contact us. With a .msi installer, and appropriate tools and knowledge, you should be able to automate installation so as to not require the user to answer any questions. You may be able to alter the installation, such as adding or removing desktop shortcuts, or changing shortcuts' command line parameters. You may be able to push installation onto client machines from a server. You may be able to ADD files, such as a custom settings file (typically "anziowin.def") that you develop to meet your organization's requirements. See item 4) below on this subject. You may be able to EXECUTE on the client machine a certain command string, after doing the installation. See item 5) below on this subject. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 4) Distribution of Settings File Anzio's operating parameters are contained in one "settings file" per host connection. Most installations use only one host connection, and so have one settings file, with the default name "anziowin.def". An admin may want to develop a standard (or starting) settings file, containing for instance the host name or IP address, the terminal type to be emulated, etc. The challenge is distribute that to each client at the time of installation. (We're assuming here that the user will personalize that settings file, with such changes as printer name, window size, and screen colors.) One way to deploy a settings file is as part of an automated installation process - see item 3) above. The second way to deploy a settings file is to "import" it. When Anzio is first executed on a client PC, if it does NOT find a settings file, it will ask the user if they want to import a settings file. If they say yes, they will be presented with these options: a) "Local or network disk" - the user can specify or browse to a file path that contains the anziowin.def file. This might be on a thumb drive or a network drive, for instance. b) "Web address" - the user can enter a URL, starting with HTTP://, HTTPS://, or FTP://, where the standard settings file is stored. c) "Configuration key" - the user can enter a key, assigned by Rasmussen Software. Anzio will convert this key to a URL (on http://anzio.com) where we will have stored your standard settings file. If a download requires a password, the user will be prompted. In any case, once the file is found, it will be read, and the user will be prompted to save the file locally. Then Anzio will continue with an attempt to connect to the host. At any later point, the user can go through the import process by going to the File menu and selecting the "Import settings..." menu item. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 5) Distribution of License Every client (PC or thin client) that will run Anzio needs to have a license which is delivered as a serial number and an activation code. That license must be activated in each client, a process that requires online access to our license server (the mechanism is a SOAP call). One customer (company) having multiple PCs licensed might have one or many serial numbers/activation codes. When a client has its license activated online, the relevant data is stored in the Windows Registry. When that storing is done, if the Anzio session has "write" access to the ALL USERS level (that is, HKLM), the data is stored there, and will be usable by all users on that machine; if not the data will be stored at the USER level (that is HKCU) and will apply only to that one user. Note that this refers to what users are technically able to run Anzio, not what users are entitled to run Anzio legally. Write permission to the ALL USERS level is determined by many things. Typically an administrator will have such rights, as will a user who starts Anzio by right-clicking on the desktop shortcut and selecting "Run as Administrator" (which is not the same thing). In a Terminal Services (or similar) environment, a license entered into the ALL USERS level will be usable by all client devices. When Anzio is running, you can check its license status by going to Help:About. So how does an admin automatically activate multiple client machines? There are two methods: a) If the admin has the ability to execute (one time) a command on the client machine, such as at the end of the automated installation process, they can execute the Anzio program with command line parameters, in the format: anzio32.exe /RegisterLicense That's for AnzioWin; for Anzio Lite change "anzio32" to "anzio32r". b) If all Anzio clients will connect (such as by telnet or SSH) to the same host system, that host system can query the license status of the client and if necessary push the license information to the client. This might be done as part of a connection script (such as bashrc) for instance. It is done using Anzio's command protocol to send commands "GETLICENSE/S" and "REGISTERLICENSE" (with variations "/N" and "/S"). For more info, see the file README.TXT (search for "LICENSE"); see also the Anzio manual regarding sending Anzio commands from the host. Then contact us with questions. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 6) IPv6 improvements (choose type of connection) Where Anzio 17.0 added the ability to communicate over version 6 of the Internet Protocol (IPv6), Anzio 17.1 allows you to control which version should be used. In the Communicate:Setup dialog is a new control labeled "Internet Protocol (IP) version. You can set this to "IPv4" or "IPv6" to restrict Anzio to using a particular version. If you set this to "Auto", Anzio will attempt whatever is available. If a host name is given, and it resolves into both versions, Anzio will use the first one returned from the DNS query. If an IP address is given, it will use the version indicated by the format of the IP address. Most users will work well leaving this item set to "Auto", which is the default. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 7) NetworkList Anzio 17.1 makes new use of fairly new capabilities in Windows to determine whether network access is available, either locally or locally and to the Internet. This information is presented in the Debug Communication dialog, and also in the "Connecting..." dialog. For instance, the latter may indicate "Waiting for network connection" if that's the case. When Anzio has been in an unconnected state, and a network connection gets made, the default behavior is for Anzio to attempt to make a new connection to the host. You can turn off this behavior by manually editing the settings file to set "connect-on-connect" to "0". Or, you can instruct Anzio to execute a macro in this situation by using the command "EVENT ONNETWORKCONNECT". See the Anzio manual for more on "events" in Anzio. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 8) Preview Bitmaps Anzio 17.1 has new support for Windows features involving the thumbnail image that is displayed when a) you do an Alt-Tab to switch applications, and b) when you hover the mouse over the Anzio icon on the taskbar at the bottom of the screen (typically). No configuration of this feature is needed. A key benefit of this support is that the thumbnail images are updated dynamically. That means that if the contents of the screen has changed (by the host application) while you're working on another program in Windows, you can see that change when you "peek" at the Anzio session using either method mentioned. Also, if you have multiple sessions of Anzio running, you can often differentiate between them when hovering or cycling through Alt-Tab. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 9) Screen Magnifier Anzio has a feature by which it can open a magnifier on the screen, that lets you enlarge a portion of the screen so you can see it better. This is especially useful with Windows tablets and other small screens. A button to turn on and off the magnifier has been added to the standard set of buttons for the toolbar. This feature was actually added in Anzio 17.0. However, we discovered that there was an acknowledged bug in Windows 7 64-bit that prevented it from operating properly. That bug appears to be fixed starting in Windows 8. So we're talking about Magnifier again. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Changes in 17.0 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 1. Backchannel Printing Improvements (AnzioWin only) Backchannel printing is a way for host-based programs to print on the client's (AnzioWin's) printer. It is possible only when AnzioWin is connected to a Linux or Unix host via SSH. Compared to passthrough print, the other main way of printing from the host to the client, backchannel printing is more secure, more robust, and less likely to interfere with the terminal session. New in version 17 is an easy, graphical way to enable and configure backchannel printing. Starting from a new session of AnzioWin: a) Establish an SSH connection to host system. b) Choose a login that will leave you at the shell level. Enter login and password. c) Go in the Edit menu to "Setup SSH printing". d) Checkmark the box "SSH print enabled". e) Make sure there's a number from 0 to 99 showing in the ID column of the first row. f) The "Command to run on host" column is typically blank, meaning the default shown above there will be used. g) Make sure the "Destination on PC" column has a valid superfile name. Typically this is "print://". h) Click "OK". You should now have a soft link named "anzprinter" established, in your home directory on the host, that points to a pty device. Now anything that is written to anzprinter will go to a print job. Now: i) Create a shell script on the host, named 'sshprint', that contains: OUTPUT=~/anzprinter printf "\033[5i" > $OUTPUT # make sure it's in print mode cat > $OUTPUT printf "\033[4i" > $OUTPUT printf "eject" > $OUTPUT printf "\033[5i" > $OUTPUT #leave it in print mode j) Make the script executable with: chmod +x sshprint k) To test, do ls | ./sshprint You should get a printout. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 2. Working in IPv6 IPv6 is a newer version of the Internet Protocol, or IP, that allows for more addresses to be assigned. It does this by using a bigger address, with more parts and bigger parts. To work in IPv6, every piece of hardware and software involved in the connection must support IPv6. In the Windows world, this generally means you must be running Vista or later. In some cases, though, it's possible to "tunnel" IPv6 over a standard IP connection, using tunneling programs. A great deal of additional information on IPv6 is available online. Once your IPv6 infrastructure is in place, AnzioWin and Anzio Lite 17 and later will support IPv6. Most people will not need to do anything special. If you specify the host you want to connect to by name, and the name is resolved (by the DNS) to an IPv6 address, Anzio will connect via IPv6. You can get a glimpse of what is happening behind the scenes by going to Anzio's Diagnose menu, and clicking on "Debug communication". If you need to specify an address instead of a name, you will need to use the new format for IPv6 addresses. These consist of up to six parts, separated by colons. Each part is made up of one to four hexadecimal characters (0 to 9, A to F, upper or lower case). There is also a protocol for abbreviating a string of zeros. As an example, here is anzio.com's IPv6 address (subject to change): 2001:4801:7817:72:9f15:57fd:ff10:2c9b IPv6 addresses can optionally be surrounded by square brackets: [2001:4801:7817:72:9f15:57fd:ff10:2c9b] Again, to use an IPv6 address in Anzio, you simply need to enter it in the proper format. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 3. Image Window Operations (AnzioWin only) In version 16, AnzioWin introduced an image viewer window, triggered by the IMAGEBOX command as well as various menu options. In version 17, this feature has been greatly enhanced. Following are some notes: + If you open a floating image window (such as from the File:View menu), and "Track Window Position" (in the View menu) is OFF, the image window will be opened in a new default position, which is to the right side of the main window, reaching to the right edge of the (same) monitor. This "side-by-side" layout should be especially usable on large, wide monitors. + The image window can now display nearly any kind of PDF file. Previously, it could display only image PDF's. + The image window can now display videos. Supported file types are *.mp4, *.m4v, *.m4a, *.mov, *.avi, *.3g2, *.3gp, *.3gp2, and *.3gpp. Requires Vista or later. Videos respond to media keys on the keyboard such as Play, Pause, and Stop. The "P" key will alternate Play and Pause. Note that you may need to click on the image window to set focus. + The image window can also be given a "manifest file", with an extension ".MFT". This is essentially a playlist. This file is plain text, and can be built using Notepad. Each line in the file contains the name of a file to be displayed. + When the image window is showing a still image (not a video), you can pan and zoom the image to adjust the view. On a multitouch screen, you can use pinch and zoom to adjust the zoom level, or drag the image around. On a PC with a mouse wheel, you can drag with the wheel to pan, or control-wheel to zoom. + You can now right-click on the image to get a popup menu with several options. + When you use an Anzio command to open the image window, you can now specify that the window should be on the second monitor if there is one; the color to be used for background; and if a manifest file is used, the timing of image changes and whether they should be random. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 4. File Locations Used By Anzio Anzio has certain default locations to look for files, and to store files. Some of these have changed with version 17. Some are affected by the version of Windows and whether certain security features are turned on. Following are details: a) In many cases, Windows does not want us to store files inside the "Program Files" (or "Program Files (x86)") directory, including where Anzio is normally installed. b) At startup, if the "Start in" directory (as configured in the desktop icon) is not writeable, Anzio will change its current directory to the "My Documents" directory. c) Anzio's configuration files (*.DEF, *.KYS) generally go in the directory with an alias "APPDATA". This might resolve to C:\Users\Bob\AppData\Roaming for instance. Note that "Appdata" in the string above may be hidden. d) When Anzio is started with the "/c" ("chooser") option, b) applies also. This means available .DEF files from the %APPDATA% directory are shown. e) Printfile output, such as generated PDFs, goes to directory configured under Edit:Advanced options:Print Wizard. Default is "My documents". f) Downloads are stored in directory configured in Transfer:Transfer options:Destination directory. Default is CWD (current working directory). g) Uploads default to CWD. In some cases THIS IS A CHANGE from previous versions. An exception follows: h) Interactive FTP and SFTP upload from the Destination directory (and download to there as well). i) Miscellaneous files use the CWD. j) The CWD can be changed with File:Change logged directory, or with the CD Anzio command. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 5. Remembering the Username and Password It is now much easier for the user to have Anzio store and save the username and password, and automatically use them later. Specifically, when the user is connecting via SSH, and is asked for a password, a checkbox is available to "Remember login and password". (This checkbox is synonymous with the menu item Communicate:Login:Login wizard.) If this checkbox is grayed, it means that the "Allow saved password in SSH" box is unchecked, in Edit:Advanced options"Security". * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Changes in 16.0 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 1. Features Added to Lite The following features, formerly in AnzioWin only, are now added to Anzio Lite. a) Change logged directory menu, CD & LOG commands b) PLAYSOUND from host c) PRINTER-SETUP command d) Background bitmap, BMP* commands e) Toolbar setup f) KILL g) MKDIR/S h) COPY (file to file) i) FIND/S, FINDNEXT/S j) TIME/S, DATE/S k) WIDTH l) RENAME m) CALC n) MERGE o) Monitor menu item p) CLONE q) SCREENMODE/S r) Cursor line & position in Gauge * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 2. Settings File Import It is now easier to move your Anzio settings file(s) from one computer to another, such as during updating Anzio or when replacing PCs. The feature that allows this may also help those installing Anzio on many PCs. On an existing Anzio, do File:Save Settings As, and navigate to a thumb drive, for instance. This will save your settings file (normally anziowin.def) onto that drive. Eject that drive and take it to the new PC with Anzio 16. Start up Anzio. If prompted, select a terminal type. If prompted for communication settings, hit Cancel. You should now see the main Anzio window. Go to the File menu and select the new "Import Settings" item. You can navigate to the thumb drive and pull the settings file off of it. Then you'll want to store that data on the local hard disk, which you can do by simply quitting from Anzio, and answering "yes" to "do you want to save...". As with all up-migrations, Anzio uses the settings that you already have, and assigns default values to all newly implemented settings. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 3. Image Viewer (AnzioWin only) The new image viewer window can form the foundation of an image enabled application. You could, for instance, view a scanned invoice in one window while doing data entry in the main Anzio window. You can scan directly into the viewer window. You can page through a multi-page document. You can even display a PCL-5 document in that window, and page through it! Here are some initial points on how to use this feature: + Go to the File menu, and click "View an Image File". + Choose an eligible file. Supported are BMP, GIF, JPG, JPEG, TIF, TIFF, PCX, DCX, image PDF, and PCL. + Initially, the window will open in a default location, to the right of the main Anzio window and down a little. + You can move, resize, and zoom the window. The image will resize automatically. + If you have a multiple monitor setup, you can move the image window to a different monitor, and possibly zoom it there. + If View:Track Window Position is checked, this window placement will be saved and used automatically next time (but you can override that with a command). + If the image file contains multiple pages, use the "Next page" and "Previous page" buttons to move through the pages. + The Anzio command for this is IMAGEBOX FLOAT The full syntax is below. + The can be a URL, so that the file is pulled from an FTP, HTTP, or HTTPS server. + Also in the File menu is Scan:Scan and View. This will scan a page from the scanner (possibly more, if the scanner has a page feeder), and place it in the viewer. The full format of the command is IMAGEBOX [CELL | SCREEN] [FLOAT] [] The parameters define the left, top, right, and bottom of the rectangle in which the image will appear. By default, these are in pixels, relative to the top left corner of the client area of AnzioWin, below the toolbar if displayed. If CELL is stated, they are in units of character cells, where "1" is the top (left) character position. If SCREEN is stated, they are in units of pixels relative to the top left edge of the video screen (desktop). If FLOAT is stated, the image window is made moveable and sizeable, by wrapping it with a suitable Windows frame, while keeping the client area in the same place. It is possible to specify a negative , etc. The available include: REFRESH= Causes AnzioWin to reload the image by rereading every seconds (which can have decimals). This can reread a file written by a web camera, for instance. ASPECT=FIXED | VARIABLE Specifies whether the aspect ratio of the image is maintained (fixed), which is the default. VARIABLE allows the user to distort the image. PAGE= Specifies which page of a multi-page file will be shown in the window. Note that, as with most filenames in Anzio, this one can be a superfile name. You can, for instance, specify a file from an HTTP or FTP source. Or, you can specify "SCAN://" to tell Anzio to scan an image and display it. To close the image window, do just IMAGEBOX One image box at a time can be open in AnzioWin. Opening a new one will close the old one. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 4. Toolbar Improvements Anzio has long had a configurable toolbar. In the View menu, click "Configure Toolbar". You can turn the toolbar on and off, and you can specify up to 20 toolbuttons, each with some text and an action. In the past, these actions could only be macros to run. But macros are stored in the keys file, which can get changed, and it wasn't a good design. Now it's better. Each action can now be an Anzio command. All configuration is maintained in the settings file. We have developed a set of standard toolbuttons, and those are enabled by default. You can also reset all the toolbuttons to the standard by clicking a new "default" button in the toolbar configuration window. (Existing settings files will be brought forward in a compatible manner, with each macro ID converted to a command to do "invoke ".) The standard toolbuttons perform actions that would be most common in everyday operation of Anzio, plus some things that users might not otherwise discover. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 5. Emailing (AnzioWin only) Version 16 introduces an email client into AnzioWin. This client is able to send email by 4 methods: CDO, Outlook, MAPI, and SMTP. Emails can be plain text or HTML, can include various attachments, and can include a "signature" file. Emails can be interactive, semi-interactive, or completely automated. You must configure email one time before using it. To do this, go to the Edit menu, to "Setup Email". Choose your method, and fill in the required parameters. An Anzio command, MAILTO, provides a programmatic way to send an email. This is explained in the manual. Also, generated PDF and TIF "print" files can be emailed automatically, as described below. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 6. PDF Printing Options (AnzioWin only) AnzioWin has a built-in PDF generator, and can route any print job to PDF. New in this version, the user has easy control over many aspects of the PDF file to be generated. To configure PDF output, go to File:Printer Setup. Make sure Print Wizard is checked. Then, under Destination, choose "PDF file named". If the name slot is blank, AnzioWin will use a default file name. Or, put in the name of the file you want to create, including the ".PDF" extension. The PDF filename can contain substitution parameters as described below. Or, this slot can contain the name and options. This is the equivalent of a superfile name without the "PDF://" at the front. For an easy way to build this string, click the Setup button. A PDF Setup dialog will be presented, in which you can configure various aspects of how you want to create your PDF. You can get to the same form programmatically by using the command PDFSETUP (that's all). You can also indicate that you want AnzioWin to email the generated PDF, by checking the "email" box. You can click the "Email information" button to get a dialog box in which you can fill in the recipient address, sunject line, and other parameters to affect an email operation. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 7. TIF Printing Options (AnzioWin only) AnzioWin's printing engine can "print" to a TIF file, which can be multiple pages. You have control over size, density, format (color, gray, black-and-white), etc. The user interface to TIF generation parallels that of PDF generation described above, including the ability to email the generated TIF. Note that the default format of TIFs generated by AnzioWin is so-called "class F", meaning it is easily faxable. In Windows, these files can be sent directly to the fax engine without conversion. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 8. Print-to-Fax Options (AnzioWin only) AnzioWin's printing engine can "print" to a fax, directed to a certain fax number. You have control over subject, "from", cover page, etc. Faxing can use the fax feature on the same PC or on a PC acting as a fax server. This feature works with the fax support built into Windows version 2000 and later. We refer to this fax engine as "Fax32". Some initial setup must be done the first time you send or receive a fax on a particular PC. This is all handled by Windows. Go to File:Printer Setup, make sure Print Wizard is checkmarked, and select "Fax to number:". In the slot, you can enter at least a fax number for the recipient. There must be a fax number provided. The entry can, however, contain additional parameters, in the format ?=[?=...] to set each variable to a certain value. Note that some variables are relevant only if a cover page is used. Variables are: TO The name of the person to receive the fax SUBJECT The subject of the fax NOTE Some text to be included in the body of the cover page. Any pipe symbols ("|") in the note will be replaced by line breaks. FROMNAME The name of the person sending the fax FROMNUMBER The fax number of the person sending the fax COVERPAGE The name of the cover page file. If a file extension is not provided, ".COV" will be appended. If the no directory is specified, Anzio will look in the user's personal cover page directory (as specified by Windows), and if that fails, in the directory for cover pages for all users (as specified by Windows). SHOWDIALOG Causes AnzioWin to prompt the user for this information whenever a fax is generated. You can click the "Setup" box next to the fax number slot to prompt for all of these fields and build your destination string for you. If you wish to use a fax server, such as that available on Windows 2003, you must tell Anzio the name of the server. Manually edit your settings file, and set the variable fax-server (in the [Printwiz] section), to the name of the server. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 9. Filenames with Substitutions (AnzioWin only) Now when you "print" to a PDF or TIF file, the name does not need to be static. After all, that would lead to repeatedly wiping out the previous file. The file name can now contain replacement variables, that AnzioWin will "expand" into a final filename. In addition, filenames can be serialized; that is, they can include a decimal number that will be incremented until the overall filename is not already present. Replacements parameters are coded as ${} such as ${ANZ_WINNAME} This entire string will be replaced by the Windows user name. Most of the available variables are as listed in section 9.3 of the Anzio manual. The following have been added: Variable Replaced by ================ =================================== + ANZ_DOCNAME The name (without path or extension) of the document being printed. + ANZ_DOCPATH The path part of the document name. + ANZ_DOCEXT The extension only of the document name. + ANZ_DATE The current date, in YYMMDD format. + ANZ_DATE_ The current date, with elements as in . + ANZ_TIME The current time, in HHMMSSZZZ format. + ANZ_TIME_ The current time, with elements as in . + ANZ_UNIQ_999 A 3-digit decimal number, incremented until the resulting name is not an existing file. More or fewer 9's determine the size of the number. So an output PDF could be named: ${ANZ_DOCNAME}-${ANZ_UNIQ_9999}.PDF Then if you printed a file named TEST.PCL, Anzio would try these names: TEST-0001.PDF TEST-0002.PDF TEST-0003.PDF etc. until the name did not match an existing file. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 10. Scanning (AnzioWin only) AnzioWin's longstanding scanner support has been enhanced in many ways, and has also been made visible. The File menu now has a Scan submenu, with the following submenu items: + Scan and Print Brings up the Printer Setup screen to let you choose your printer or other output, prompts for a scan operation, then prints it as configured. + Scan and Save Presents a "Save As" dialog for you to select your output filename, prompts for a scan, and saves the scan to the file. The extension of the filename determines the format the file will be saved in. + Scan and Send Prompts for a scan, then uploads it to the server using the "default protocol" selected in Transfer Options. The filename used for the file on the server is as configured manually in the settings file under "scanfile-name". The extension determines the file format that will be created. + Scan and View Prompts for a scan, then opens it in the imagebox window. Note: Scan and Send currently works only with FTP and SFTP. The scanner can also be addressed with a superfile name starting with "SCAN://", and optionally containing parameters to control the scan. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 11. Gesture Recognition AnzioWin can take advantage of the gesture recognition capability of the Tablet PC, which has now been extended into some versions of Vista. When enabled on the main Anzio window, certain penstrokes will be recognized and translated into keystrokes to be sent to the server. This can work with in conjunction with other pen functions or alone. Gesture recognition can be turned on and off by right-clicking in the main window to bring up the popup menu, and selecting "Recognize gestures". If this item is grayed, your system does not support gesture recognition. The following gestures are recognized: Gesture Action ---------------- ------------------------------- ChevronUp key ChevronDown key ChevronLeft key ChevronRight key ArrowUp key ArrowDown key DownRightLong key Right key Left key UpRightLong key DownLeftLong key RightLeft CLIP function (copy to clipboard) DoubleCurlicue CLIP function (copy to clipboard) DoubleCirlce PASTE function (paste from clipboard) LeftRight key UpLeft key For pictures of these gestures, see http://msdn2.microsoft.com/en-us/library/ms697513.aspx To debug what is happening with gesture recognition, go to Diagnose:Debug Keys. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 12. Shape Recognition Anzio has had the ability to mark up (draw with a mouse or stylus) both the Print Preview window and the main screen. On the main screen, this could be used to add some notes, circles, arrows, etc. Then you can print the screen. Or you can copy this screen into the clipboard, and paste it into an email for tech support, or into your own user manual for the application Anzio is talking to. On the main screen, we have now added the ability to do shape recognition. When this is turned on, and you draw something that looks like a circle, Anzio will convert it to a perfect circle. To turn this on, right-click on the main window, and select "Allow ink markup". Then right-click again and select "Recognize shapes". Shapes that are recognized include: + square + circle or ellipse + rectangle + corner + chevron + horizontal or vertical line + diagonal line + straight segments of a multi-segment figure (If Anzio is not running on TabletPC, or Vista with TabletPC features installed, some shapes will not be recognized.) In general, if a segment is not straight enough, or otherwise not recognized, it will remain on the screen as a freehand segment. Recognized shapes will in many cases auto-connect to nearby ends, corners, and cusps. Shape recognition has not yet been applied to the Print Preview window. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 13. Control-Backspace = Word Delete Left We introduce a smart keystroke: ctrl-Backspace. It is "smart" in that its behavior is dependent on the data on the screen which has come from the host. This key will do a delete-word-left, or backspace-to-start-of-word. That is, it will count characters to the left of the cursor, to the start of a word (or attribute field), and send that many backspace (or ) characters. This provides a quick way of editing many common data entry errors. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 14. ClearType Font Smoothing Anzio now works with Windows' Cleartype font smoothing mechanism, which makes text appear smoother especially on LCD screens. This feature is ON by default. To disable, go to Edit:Advanced options:Screen, and uncheck "ClearType font smoothing". Microsofts's web site explains how Cleartype works, and has a setup wizard you can use to tune your Cleartype display. Note that Cleartype's operation is dependent on the order of color dots on your screen, in a horizontal direction. However, this changes (for the worse) if you rotate the screen to a portrait orientation. Anzio is smart enough to turn Cleartype OFF when the screen is rotated to portrait, and back ON when rotated to landscape. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 15. Local Port Forwarding (AnzioWin only) This version of AnzioWin introduces local port forwarding under SSH. This means that, once an SSH session is opened to the server, a local (on the PC) TCP/IP port can be forwarded to a TCP/IP port on the server, or on another machine reachable from the server. There is no user interface for this yet. To turn on forwarding overall, edit the settings file to change ssh-forward to "1". To add a forward, use the command SSHPORT-ADD You can add multiple forwards. Forwarding configuration is, of course, stored in the settings file. To remove forwards (for now), edit the settings file. Note that AnzioWin creates a "static" forward. AnzioWin does NOT act as a SOCKS proxy server, as some other SSH clients do. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 16. Backchannel AUX Serial Port (AnzioWin only) It is now possible, in an SSH connection, to open multiple serial device sessions. Each one can control one serial port on the PC, which can be connected to various devices such as PIN pads, pole displays, truck scales, mag-stripe readers, etc. (More to come) * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 17. Backchannel Printing Enhancements (AnzioWin only) It is now possible, in an SSH connection, to open multiple serial device sessions. Each one can control one serial port on the PC, which can be connected to various devices such as PIN pads, pole displays, truck scales, mag-stripe readers, etc. (More to come) * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 18. New "Print a File..." in File Menu This new menu item will prompt the user for a file to print, and print it according to how Anzio is configured. That is, it could generate a PDF (and email it), generate a fax, etc. While this sounds simple, the beauty is in how many file types Anzio can handle, notably: + Image files (.TIF, .JPG, .GIF, .BMP, .PNG, .PCX, .DCX) + Image PDF files + Windows spool files (.SPL) + Windows meta files (.EMF, .WMF) + PCL files (does not require a PCL printer) + Plain text files, including .BAT strings, scripts, program source files, log files + Tab-separated-values files + Some .htm, .html files + Print Wizard Markup Language (PWML) files * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 19. PDF as Input File AnzioWin can now read certain PDFs as input for display and printing. PDFs must be of images only, such as from some scanner software. Also, the file must not be password protected. You can print a PDF with PRINTFILE, use it as a form overlay, display it with IMAGEBOX, or use it as a screen background with BMP. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 20. Reading PC File Info, from a Host Script or Program The ability of a program on the server to control the PC environment through Anzio had a serious shortcoming: the host program could not find out if certain files existed on the PC, or anything about them. Now a new command helps with that. The command FILEINFO/S will return to the host a string containing information about the file, if it exists. You would issue this command as explained in section 12 of the current manual, then read an input string from the terminal. Anzio will respond with a string. For details, see the Change History section below. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 21. Cleaning Up Old Files A new command in Anzio allows you to clean up old files: FILE-CLEANUP This will search through the files meeting the pattern in . Any that it finds, that are at least old, it will delete. You could use this to clean up an image download directory, for instance. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 22. Transferring Files Only If Needed Suppose you want a client PC to use a certain overlay file for printing, but you don't know if it exists on the client PC. And you don't want to transfer it every time. Now you can do SFTPREGET [] This will function like SFTPGET, but it will "re-get" the file. That is, it will do the transfer only if the host has a newer version or the PC doesn't have the file at all. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Changes in 15.2, updated * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 1. Printer Setup Allows Overlay Selection (AnzioWin only) In the Printer Setup window, the user can now choose an overlay to be combined with print data coming from the server (passthrough print). * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 2. Interactive Print If you checkmark the box labelled "Interactive Print" in the Printer Setup dialog, then the Printer Setup box will be presented each time a passthrough print job is received from the host. This allows you to choose your printer, choose to generate a PDF, etc., on a job by job basis. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 3. Ink Markup of Main Screen On most Windows XP systems, and all TabletPC and V ista systems, you can now mark up the main screen of Anzio. Simply right-click, and select "Allow ink markup". You can then draw on the screen with your mouse or stylus. If you right-click, you can control the drawing parameters, print the screen, or copy to the clipboard. To do user documentation in Word, use Paste Special to paste in bitmap format. This will include the markup. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 4. TIF Files as Input (AnzioWin only) Multipage TIF or TIFF files can be read and printed, or used as overlays in Print Wizard printing. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 5. TIF Files as Output (AnzioWin only) Output from the Print Wizard engine can be sent to a TIF file (although this is not available in Printer Setup until 16.0). Use the command PRINTER TIF://.TIF Options on the end can specify density, size, format (color, gray, b&w), etc. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 6. Event Triggers (AnzioWin only) Various events that happen in an Anzio session can trigger macros to start running. These are put in place by the EVENT command. New events include: Event Triggered when -------------------------------------------------------- ONBEEP Bell character received from host ONQUIT User tries to quit ONHOSTPRINT Passthrough print job is received ONCONNECT Connection to host is completed ONLOGIN User successfully logs in ONWAKEUP PC comes out of sleep mode * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 7. Prompting on Disabled Host Command If an Anzio command is received from the host, in the form and these commands are disabled (in Edit:Advanced Options:Security), you will now be told of that, and prompted to allow host commands to be processed. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Changes in 15.1, updated * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 1. Toolbar (Restricted in Anzio Lite) It is now possible to have a toolbar along the top of the Anzio window. The View:Configure Toolbar menu item brings up a dialog that controls this. There can be up to 20 toolbuttons in the toolbar. Each button contains a text string that describes what it does (we stayed away from icons; too many icons do not have an obvious meaning). Each button is also associated with a macro, either system-defined or user-defined. When the user clicks the button, the corresponding macro is triggered. Here are the details. The information about the buttons (the text strings and what macro will be executed) is stored in the settings file. The CONTENTS of the macros, like all macros, are stored in the KEYS file. Thus if a toolbutton is set to execute the F1 macro, and you change terminal types and keys files, the new content of F1 will be sent. Sizing of the toolbar and the text in the main menu is all automatic. The toolbar can be turned on and off with the TOOLBAR command. The individual buttons can be set with the TOOLBUTTON command. See the README.TXT file. UPDATE: see version 16 above. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 2. Window Styles We have now made it much easier to configure Anzio for various full-screen display modes. For fine-grain control, as before, you can go to Edit:Advanced options:Screen. However, these changes now take effect immediately, instead of on the next startup of Anzio. Also, the View:Zoom menu has been expanded into a submenu, that now adds "Full screen, no menu" mode. This mode takes over the entire screen, and turns off the menu, so Anzio resembles a DOS screen. How do you turn this mode off, if the menu is gone? Use the right-click popup menu, which now has the zoom submenu on it. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 3. Printer Setup Version 15.0 added some significant support for printing-related tasks, such as faxing and generating PDF files. However, it did not make it easy to turn on or even find these features. In 15.1, there is a new Printer Setup dialog, accessed from the File menu, that clearly lays out the options for printing, faxing, PDF generation, etc. It also brings into one place many of the options that affect printing, which were previously scattered. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 4. Sizeable Windows (AnzioWin only) Anzio can now remember and reuse the size, location, and zoom state of the Print Preview and the FTP/SFTP windows. If the PC has multiple monitors, this includes tracking which monitor the window is on. If "View:Track Window Position" is turned on, this information is saved between sessions, and reused, if you save your settings. Note that the Print Preview window, on a suitably large monitor, can be enlarged to where the print image is the same size as the paper. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 5. Background Bitmaps AnzioWin has long had the ability to show a bitmap in the background, behind the screen text. We have now made this easier to use and configure, with a dialog box that lets you specify what file is to be used, set the brightness and contrast of the bitmap, and specify whether it should be "tiled" (also a new feature). Brightness and contrast adjustments work better, allowing you to have a watermark style background graphic. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 6. DDE Server (AnzioWin only) AnzioWin can now act as a DDE server. Although this is an old technique in the Windows world, it is still quite a useful way to have an outside application control Anzio. If you are programming in Visual Basic, for instance (or even in a macro in Word), you can control the Anzio session, sending keystrokes, executing commands, checking status, etc. Applications include automating login procedures, screen-scraping for imaging applications, feeding data to an interactive program on the host, etc. For details, see the README.TXT file. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 7. Lockdown Options Many of our customers administer large numbers of Anzio users in an environment that requires the admins to limit the feature set in Anzio. While we have had methods available in the past, notably "kiosk mode", we now have some enhancements: a) Kiosk mode can be specified in the settings file, in addition to the command line parameter. The more restrictive setting takes precedence. The change must be made with an editor such as Notepad, outside of Anzio. b) An entry in the settings file can specify that certain menu items should be deleted from the main (not the kiosk) menu at runtime. c) Modifications to the resources of the .EXE file, which can be done with Visual Studio, can contain settings, analogous to the settings file. One set specifies defaults, which may be overridden by the user's settings file. Another set specifies requirements -- items that can NOT be overridden by the user. d) Settings files and/or keys files can be fetched from an HTTP, HTTPS, or FTP server. e) Enhancements have been made for the "download-execute" feature, in which an Anzio session is started from a web link that points to the actual Anzio executable. These features can be combined in many different ways to lock down the Anzio session. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 8. Copy to Clipboard in RTF When you copy some or all of Anzio's screen to the clipboard, it goes in in several formats (as it's supposed to). These include text in ISO, OEM, and Unicode, and bitmap (if it's rectangular). In 15.1, we have added Rich Text Format (RTF). This is text with fonts and colors. This is especially useful for working with Microsoft Word. You should get screen shots in the correct font, with all their foreground and background colors. NOTE: When pasting into many programs, such as Word, you have options of "Paste" and "Paste Special". The first pastes in that programs preferred format (of those available). The second lets you choose which format you want. If you have trouble with your Paste operations, experiment with the different formats available under "Paste Special". You can disable this feature in Edit:Advanced Options:Mouse. Effective 15.2, this feature is off by default. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 9. Session Switching If you have multiple sessions of Anzio open, the Ctrl-Tab key combination will cycle between them. This uses the new command variation SWITCHTO/N /next * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 10. Passing Environment Variables in SSH It can be a very useful thing for a terminal emulation client (Anzio) to pass Unix/Linux environment variables to the server at login. This can tell the server session some things, such as which printer to use, where the PC is located, and that Anzio is running. In the past, this was possible with telnet. However, due to security problems, the capability was removed or greatly restricted in telnet daemons. With version 3.9 of OpenSSH's SSH daemon (sshd), however, it has been added, in a tightly controlled way. You can configure the sshd to allow certain environment variables, by editing the sshd_config file. Add a line that starts with "AcceptEnv", followed by space-delimited variable names. Wildcards are allowed. This tells sshd which environment variables to allow. Mine, for instance, says AcceptEnv ANZ* LPDEST ICE* LANG DISPLAY Then in Anzio, set the "variable=value" pairs in Communicate:Environment. See the manual for more. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 11. Linux UTF-8 Support In Red Hat (and possible other flavors) Linux, there is support for Unicode characters in a mode that supersedes all other character set settings. Anzio can now work with this. On the Linux end, if the LANG environment variable has a suffix that says "UTF-8", then many programs such as "setup" will expect that the terminal session is in UTF-8 mode, and output in this character set. In Anzio, you can enable this with Communicate:Character Set, where a new checkbox indicates "Linux UTF-8 Mode". You can also switch in and out of this mode with an escape code from the server, or with an Anzio command, as detailed in the README.TXT file. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 12. Support for Ctrl-C and Ctrl-V In many environments, the user must be able to send a ctrl-C character or a ctrl-V character to the server program. However, Windows has adopted these as standard keystrokes for Copy and Paste. This has led to some confusion. In Anzio, we have long used an older Windows convention of Ctrl-Insert and Shift-Insert. In this version, we make the use of ctrl-C and ctrl-V switchable. They can either send a code to the host or do Copy or Paste. See Edit:Advanced Options:Keys. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 13. Track Caps Lock Often a user needs a different setting for the Caps Lock in Anzio than they need in other Windows programs. For some time we have had "Upper Case" (in the Communicate menu), which forces all keystrokes going to the host into uppercase. But this is problematic in some situations, such as entering password. So we have added a new feature. In Edit:Advanced Options:Keys, you can set "Track CAPS Lock". Here is how it works, if turned on. Anzio will keep track of your Caps preference INSIDE Anzio's main window, and your Caps preference OUTSIDE Anzio's main window. Anzio's dialog boxes count as outside. The Inside setting is saved in the settings file. Whenever you transition from inside to outside, Anzio will reset the Caps if necessary. This includes when you a) start up Anzio, b) quit Anzio, c) enter a dialog box, d) return from a dialog box, or e) switch between applications, by any means. Most commonly, you'll want Caps ON when inside Anzio's main window, talking to a host application, and OFF otherwise. So, once Anzio is running and you're in the main window, turn Caps on. Now you should be able to alt-Tab to Word, and Caps will be off; then alt-tab back to Anzio, and Caps will be on. It's harder to explain than to experience. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 14. Handling of "Special" Keys Keyboard makers, including Microsoft, are getting creative. Their keyboards come with all sorts of additional keys, for media control and other common functions such as "Print". In some cases, some of these actions are assigned to the row of function keys, which is switched between two states using an "F lock" key. And unfortunately, on some keyboards (especially wireless ones) there is no indicator light to tell users what state the F lock is in. The result commonly is that users hit an , expecting it to send the corresponding sequence to the host, and instead they get a Ctrl-Z, which is the code for "Undo". Anzio now recognizes these special keys, and it gives you options for how to deal with them. This is configured in Edit:Advanced options:Keys, under "Action on special keys". Options are: * Ignore: Anzio will ignore the fact that this is a special key, and process its input normally if possible. * Warn: Anzio will warn the user that they may need to turn on their F Lock key. * Ignore if unknown: Same as Ignore, except Anzio will process "Help", "Print", "Copy", and "Paste". * Warn if unknown: Same as Warn, except Anzio will process "Help", "Print", "Copy", and "Paste". * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Changes in 15.0, updated 1. Superfiles (AnzioWin only) This is a concept that underlies many new features. Many operations that used to deal with files can now optionally use a "superfile", sort of like a URI. We already had this to a degree. For instance, you could issue the Anzio command: COPY ftp://somefile@somehost.com mylocalfile to fetch the file from an FTP location and store it on disk. Or you could do COPY mylocalfile WPRN where "WPRN" is a special name that corresponds to Anzio's built-in print handler. Now we have added many new kinds, to handle faxing, scanning, speech, and many of the other features described below. Some can be input files and some can be output files. With the exception of "WPRN", which is in that form for compatibility with earlier usage, all superfile designations have a type identifier followed by "://", as in the first example above. The identifier is not case sensitive. Following are the file name formats, whether they are usable for input or output, and general notes: Name format In Out Notes ----------------------------------------------------------------------- WPRN no yes Anzio's builtin print handler anything else without "://" in it is a standard local file FTP://filename yes no Fetched from an FTP server HTTP://filename@sitename.com HTTPS://filename@sitename.com yes no Fetched from a web server SCAN:// yes no A bitmap pulled from a scanner (or other TWAIN source) PDF:// no yes A printfile created as a PDF, named Printwiz_output.PDF PDF://filename.pdf no yes A printfile created as a PDF, with the given name FAX32://555-1234 no yes A fax generated with the Fax32 system, sent to the indicated phone number EMF:// no yes An enhanced Windows metafile containing a print job, named Printwiz_output.emf EMF://filename.emf no yes An enhanced Windows metafile containing a print job, with the indicated name SCREENBMP:// yes no A bitmap image of Anzio's window SPEAK:// no yes Text-to-speech For instance, you could use the Anzio command ZSEND scan:// to scan and upload (via Zmodem) a file. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 2. The master printer device SUPERSEDED BY 15.1 One string in Anzio's setup contains the name of the output device that will be used by Anzio's printing, including passthrough printing, print-screen, etc. This string defaults to "WPRN", which means that printing goes to the print handler. If this string is changed to a superfile name as above, however, the printing will go there. To change this string, do File:Printer Setup. In the first prompt, enter the superfile name you want. For instance, if you enter Fax32://1-503-624-0760 then passthrough-print a file from the host, your print job will be faxed to me (please don't flood me with faxes). To revert to normal behavior, change this item back to "WPRN". You can issue a command to change this item by doing, for instance PRINTER WPRN * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 3. Temporary print redirection (AnzioWin only) An often-forgotten capbility in Anzio is the ability to temporarily redirect printing to a file. If you open a file with File:Open new file to recieve, or with an OPENO command, passthrough print jobs go there instead of to the normal print handler (WPRN). The print job will remain open until you close the output file, either in the same area or with CLOSEO. Now you can use superfiles in this way, although not from the menu. So if you do the command OPENO Fax32://555-1234 then do a passthrough print job, then do a CLOSEO, you will send a fax without making any permanent changes to your setup. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 4. FTP options (AnzioWin only) A new "FTP" section in Transfer:Transfer Options allows you to configure how AnzioWin's interactive FTP behaves, particularly when you do just Transfer:Ftp. You can, for example, configure Anzio so that menu option will go to a different server, different port, start in a certain directory on the server, etc. Certain fields in this dialog also apply to SFTP. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 5. FTP enhancements (AnzioWin only) The interactive FTP dialog (Transfer:FTP) is greatly enhanced. You can drag-and-drop, navigate around, delete files, rename files, download-and-print files, and more. Some of this behavior can be restricted by settings in the FTP options dialog described above. This dialog can be sized and zoomed. FTP pays attention to the flag in Transfer:Transfer Options regarding "Action to take if file exists". * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 6. SFTP (AnzioWin only) When you are working over an SSH connection, you can now do SFTP, which is a secure (encrypted) alternative to FTP. It works through the same port (and firewall opening) as the terminal session. It looks and behaves just like the FTP dialog described above. You can not do SFTP to a different host from where you are connected in your terminal session. We have also added the following SFTP commands, for command-driven operations: SFTPGET[/S] SFTPPUT[/S] SFTPDELETE[/S] * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 7. Macro recording (AnzioWin only) A macro is a sequence of keystrokes to be sent to the host, and/or Anzio commands. A macro is attached to a key, usually a special key such as a function key combination. You can create and edit macros in Macros:Edit. You can also create a macro by recording your keystrokes and menu operations. Improvements in the area of macro recording allow you to get more use out of this function. Specifically, special keys are now inserted properly into the recorded macro. Also, nearly any menu operation that you do in Anzio will now properly add on to the recorded macro. To record a macro, simply do Macros:Record. Then do the series of actions that you want to record. When you are finished, do Macros:Record again to turn it off. You will then be prompted for the keystroke you want to attach that macro to. You can at any point edit that macro by going to Macros:Edit. There are two situations in which this is especially common. First, you may find that the macro sends keystrokes to the host too fast, before the host is ready for certain input. In that case, you may want to insert a WAITFOR command in the macro. This tells the macro playback mechanism to wait for certain text to come from the host. Second, you may want to vary the operation of the macro, by pausing so for the operator to input certain text. This is represented in the macro operation by '#'. See the manual for more information. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 8. Scanner support (AnzioWin only) With TWAIN support included, AnzioWin can now incorporate scanned documents and pictures in a variety of ways. The scanner is treated as an input file with the name "SCAN://". We expect that the most common uses of scanned input will be in printing. This is possible when using the Print Wizard feature in Anzio, as follows: a) When you specify an OVERLAY, in a tag, just use OVERLAY=scan:// The scanner will be activated at the time the first page is printed. As with other OVERLAY operations, Print Wizard assumes the image is scanned as a full page, edge to edge, and will stretch the image to the edged of the paper, including outside the printable region of the printer. b) To embed a scanned image, such as a photograph or a signature, into a document being printed, use a tag of the form The scanner will be activated each time the tag is encountered. Print Wizard will apply its standard rules for sizing and placing images. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 9. Backchannel encrypted printing (AnzioWin only) One of the weaknesses evident in securing your network is the lack of options for encrypted printing. This is particularly an issue with HIPAA. With this version of AnzioWin, when you are connected using SSH, you have the option of opening a backchannel for printing. Print jobs from the host can travel over the authenticated, encrypted SSH link, in a channel that is separate from your terminal session, to go to your printer. At this point, there is no user interface for configuring backchannel printing. To enable it, use Notepad (or similar) to edit your settings file (such as "anziowin.def"). Look for the line labeled "ssh-print". Change its value from "0" to "1". Note also the line "ssh-print-command". This is the command the gets executed on the backchannel, as described below. You may want to change this. Here is the process that Anzio goes through: a) On initial startup, if an SSH connection is successfully established with the host, and ssh-print is "1", and ssh-print-command is not empty, then AnzioWin will create a second SSH channel, and on it execute the command specified in ssh-print-command. b) Any data that Anzio receives on the SSH print channel will go to a special ssh-printing routine, which will send it to the main print processor (that is, WPRN). Its handling there will vary depending on whether Print Wizard is turned on, and (if Print Wizard is turned off) the Print Level setting. c) The ssh-printing routine in Anzio will also respond to a simple protocol for forcing an end-of-job. To force an end-of-job, and then go back into printing mode, send the backchannel the following: [ 4 i E J E C T [ 5 i (where is the escape character). Although this looks like the passthrough print sequence for VT-style terminals, it will work regardless of the terminal type Anzio is emulating. Note that even if this is not done, the normal flush timer logic in Anzio will occur. d) The default ssh-print-command is rm anzprinter 2> /dev/null;ln -s `tty` anzprinter;cat This removes traces of a previous execution. Then it makes a soft link of the tty name assigned to this channel to the name "anzprinter". Then it executes a "cat" command. This continues to run. Now, to print anything on the backchannel, you can write something to anzprinter in the user's home directory; for instance: cat somefilename > /home/ras/anzprinter Note that this approach would not work if multiple logins were occurring using the same username. e) Data sent to the backchannel is currently assumed to be in the ISO (ANSI) file set. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 10. Speech (AnzioWin only) AnzioWin can now make use of Windows' text-to-speech capabilities. These capabilities are referred to as "SAPI" (Speech Applications Programming Interface). SAPI is included in some versions of Windows, and downloadable for others. Check your Windows Control Panel for "Speech". You can output speech by using the superfile name "SPEAK://" as an output filename. For instance, the command COPY readme.txt SPEAK:// will read and speak that file. You could also CAPTURE to "speak://" or redirect printing to "speak://". There is also a new SPEAK command, with these variations: SPEAK Reads the entire screen SPEAK "Some text" Speaks what is in quotes SPEAK Speaks what is on the screen between column and , between rows and . * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 11. Fax32 (AnzioWin only) This fax capability is included in Windows 2000 and later. We provide a way to print to the fax driver with a pre-specified phone number, so no operator intervention is required. To use this fax service, use the superfile name "FAX32://", where is the destination fax number. See examples elsewhere in this document. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 12. Diagnostics New menu items allow printing or faxing a diagnostic package, consisting of a screen image and the last 8K of bytes received from the host. It is also easy to take a snapshot of the screen image and write it to a disk file. THIS FEATURE IS NOT COMPLETED. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 13. Annotation on Tablet PC (AnzioWin only) Anzio already worked quite well on the new Tablet PCs. Now we have added an annotation capability. When AnzioWin prints a job, and Print Preview is enabled, you can use the Tablet PC's stylus (or a mouse) to mark up the previewed image, which is the first page of the print job. Then when you print the job, that first page will be printed with your markup. You could concievably generate a PO, combine it with a form image, preview it on your tablet, sign the PO, and fax it out, without it ever hitting paper. Also, the Print Preview window is now sizable and zoomable. On the Tablet PC, it responds well to rotation of the screen. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 14. Print Wizard improvements (AnzioWin only) I've already indicated that many new features involve printing. These and more are provided by the enhanced version of the Print Wizard printing engine (PW) included in AnzioWin. Additional enhancements include: * Changing page specs: different pages of a report can have different numbers of copies, come from different paper bins on the printer, and have different overlays. * Storage and use of PCL macros: on a PCL-5 printer, PW can load PCL macros into the printer's memory and leave them there. It can also use any stored macros as overlays. This can be much more efficient than loading macros for each print job. * 2D barcodes: PW now supports Maxicode (used by UPS) and PDF417 barcodes. These can contain more information than earlier barcode formats. * Global replacement: you can now specify one or more regular expression replacement operations, to be applied to every line that is printed. * Text alignment options: for a paragraph (

) or a division (

), you can now set temporary margins, and also set text alignment to left, center, right, or fill. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 15. PCL translation (AnzioWin only) This is also part of Print Wizard, but deserves special mention. In the past, AnzioWin had certain features to deal with PCL files; that is, printfiles containing Hewlett Packard's Printer Control Language. This could be used as a form overlay, but only on a PCL printer (such as a Laserjet). It could also pass the file transparently to a PCL printer. Those features still exist. Now, however, Print Wizard can read, understand, and translate PCL files. This creates some new opportunities. You can a) Print a PCL file on a non-PCL printer b) Use a PCL overlay on a non-PCL printer c) See PCL overlays in Print Preview d) Send PCL to fax e) Translate a PCL file to a PDF file Some of this is handled automatically. For other situations, you will need to turn on "PCL Translation" in Edit:Advanced Options:Print Wizard. Note that when this is on, PW assumes that print jobs containing ANY escape sequences are PCL files, and will try to translate them. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 16. PDF generation (AnzioWin only) This one's actually part of Print Wizard also, but it's a MAJOR feature and I wanted to give it some extra attention. We have created our own PDF output generator. Anything you could previously print with the embedded Print Wizard you can now render to a PDF file with NO additional software. This includes * Plain text (auto-fit to the page) * 132-column reports * Form overlays (bitmap, PCL, scanned) * Embedded pictures, signatures * Font changes, etc. * Screen images You have control over the filename and location produced. You could then email the produced PDF file as an attachment, so the recipient would get a fancy but precise print image that they could preview and then print. To create a PDF, just name your output either PDF:// or PDF:// In the former case, the created file will be named "Printwiz_output.pdf", and placed in the current logged directory (see File:Change Logged Directory). In the latter case, you provide the filename. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 17. SSH private/public key generation A separate program, AnzKeygen.exe, can be used to generate public/private key pairs for use with SSH. The SSH daemon running on your server can be configured to allow authentications in several ways, separately or in combination. Anzio supports two of these methods: password authentication and public/private key authentication. Password authentication simply requires the user to enter the password that corresponds to his or her username. Public/private key authentication is more involved. A program must generate a private key, based on random, very large prime numbers. The private key is stored in a file, which is placed on the client machine (in this case, on the PC). The program will then generate a public key based on the private key; the public key goes on the host machine (the server). At the time of establishing a connection, the client uses the private key to prove (authenticate) who it is. The server can verify this using the public key, without ever knowing the private key. The private key file may require a passphrase (a long password), which the user must enter. This proves that both the user and the PC are legitimate. A private key file that does NOT require a passphrase means anyone using that PC will have access. Note that Anzio will not automatically supply a private key's passphrase, although it can be made to supply the password for simple password-only authentication. It is important to note that the internal format of the private key is NOT standardized. You can not assume that the private key created by one key generation program will work with a different SSH client program. For the format of a public key, there is a standard proposed but not yet adopted. Anzio is able to use a private key file that is created by AnzKeygen.exe, or one created by PuTTY. To create a key pair, run the AnzKeygen.exe program. Fill in the blanks as follows: a) Under "Type of Key", chose "SSH1" to create a key for version 1 of the SSH protocol, or chose an RSA or DSA SSH2 key. b) The "Number of bits" field (default 1024) indicates the security level of the key. More bits is more secure, but takes longer to work with. c) If you want the private key file to be passphrase-protected, enter a passphrase in that field, and again in the confirmation field. d) You may enter a comment to embed in the key file. e) Click the "Generate" button. It may take a few minutes for the program to generate a key. f) The program will display a box containing the public key in semi-readable form. If you are running OpenSSH on your server, you will need to insert this data into a file on the server. To make this easy, you can click on "Copy to Clipboard", which will cause the program to store the public key data in the Windows clipboard as one long string. Later, you could paste it into an editor running on the server. Click "OK". g) The program will present a dialog titled "Save public key as". If you wish to create a public key file, enter a file name and click "Save". This is useful for SSH daemons that require a separate key file. Otherwise, click "Cancel". h) The program will present a dialog titled "Save private key file as". Tell it the name and location of the private key file to be created, and click "Save". This completes the key generation process. To tell Anzio to use a private key, go to Communicate:Setup. Click the "Setup" button next to "SSH". Under "Private key file", enter the full path name of the private key file. To tell your SSH daemon to allow use of one or more public keys, you will need to follow instructions provided with your particular sshd. For more information, try doing man sshd at the Unix or Linux shell prompt. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 18. AnzioWin as a drag-and-drop target (AnzioWin only) AnzioWin can now accept files that are dragged and dropped onto it, such as from a Windows Explorer window. What does it do with these? That is up to you. We introduce a concept of an "event", which we hope to expand in the future. You can create a macro (by the usual means), and associate that macro with certain defined events. When the event occurs, if there is a macro associated with it, that macro will be CALLed (at the end of the macro, any running macro will resume). Dropping a filename onto the Anzio window constitutes an ONDROP event. Anzio will save the pathname of the file dropped, and the mouse's X and Y coordinates, in variables for later use. Then it will execute the ondrop macro. Step-by step: 1. You can specify the macro to run on an "ondrop" event, using the command EVENT ONDROP where is, for instance, "D" (without the quotes). 2. When a drop occurs, Anzio stores the X and Y coordinates of the drop (in cells, based on 1) and the full pathname of the file that was dropped. Then if an ONDROP macro is in play, it is called. 3. The macro can do any of Anzio's 300+ commands, including sending text to the host. 4. The macro can fetch the name of the dropped file by using $~{ANZ_DROP_NAME} 5. Similarly: $~{ANZ_DROP_X} $~{ANZ_DROP_Y} 6. I also added a command BASENAME that will get the basename (excluding the directory) of a filename. This command can be embedded in another commant, e.g., the macro that is running from ONDROP. Therefore, your D macro could send any aribtrary text, send the X and Y coordinates of the drop, sent the full pathname of the drop, send the basename of the file, or any combination. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 19. Automated login in SSH When connecting via SSH, many people want to automate the login, using the username and password defined in Communicate:Login Wizard. This is now possible. Because this subverts to a degree the security purposes of SSH, we have separated the control of this feature. Go to Edit:Advanced Options:Security, and click "Allow saved password in SSH". Note that this applies to password-type authentication only. If you are using a private key that has a passphrase, you will still have to enter that passphrase manually. It is an option, however, to create an SSH key without a passphrase. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 20. SSH added to Anzio Lite Support for SSH connections has been added to Anzio Lite, giving users the option of a low cost but thorough SSH client. Several advanced SSH features, such as SFTP and backchannel printing (described above) ore NOT included in Anzio Lite. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Notes on 12.6, updated: 1. Colors, Attributes, and Palettes We have added functionality and made configuration easier in this area. First, there is a new "Edit Colors" dialog, under View:Colors. (Note that if Anzio is emulating SCOANSI or certain other terminals, color management is usually done from the host, so settings you might make in Anzio could easily be overridden.) In Edit Colors, you can configure the colors of the text and background that Anzio will use when it is told by the host to display in "blink reverse", for instance. In the top right of this dialog is "Attribute type". In older versions of Anzio, we used only 8-bit attributes. This meant, for instance, that you could have blinking available, or have underlining available, but not both at once. That is all still possible, if you select "8-bit attributes"; you can choose your "palette" using "Blink / Underline" and "Bright backgrounds". However, if you choose "Full attributes", you have available blink, underline, 16 foreground, and 16 background colors. That is what we recommend. (Certain terminals inherently use 8-bit attributes.) As mentioned, you have 16 colors to work with. Now, however, we let you fine-tune those 16 colors. Click on the "Change color map" button. The "Color Map" dialog will show you the 16 named colors, and their current settings. If you click any button, you can adjust the color, using a Windows standard color picker. So you could make "green" a little lighter, for instance. You could even make "green" show as purple, although that would be confusing. All these settings should save into your settings file, and be used on the next startup. In fact, if you run a multi-session environment, such as mscreen or Verssys, you can have separate color settings for each session. In terminal types VTxxx and ANZIO, you can now make use of the full range of attributes & colors, by sending the appropriate escape sequences from the host. That is, Anzio will respond to escape sequences to set blink, underline, reverse, etc., and also 16 foreground and 15 background colors (for compatibility). When using Pine on Unix/Linux for instance, with Anzio, you can tell Pine to "force-ansi-16color". See README.TXT for more information. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 2. Print Wizard Options Print Wizard's job is to automatically figure out how it ought to print each job. But even a wizard needs to know what the customer wants sometime. In this version of AnzioWin we have given you the ability to control some of Print Wizard's behavior. These items are controlled in Edit:Advanced Options, in the new Print Wizard tab: 2.1 Print Preview This feature has been a long time coming. When Preview is turned on, Print Wizard will present a print preview screen (for most print operations), showing only the first page (for now). Various parameters deduced or calculated by Print Wizard will be shown. Many of these you can change before printing. Note that the new Gutter setting is an additional margin on the left side of odd-numbered pages, and on the right side of even-numbered pages, to make binding easier. The Column offset and Column gutter are used to create multi-column labels. Note that any changes made here will affect only this one print job. 2.2 Auto Orientation If this is checked, Print Wizard will decide for you which orientation to use. It starts off assuming portrait orientation. However, if the line width is more that a certain threshhold (100 characters, by default), or the calculated character per inch is more than a certain threshhold (16 by default), it will switch automatically to landscape. You can control those defaults precisely using Print Wizard Markup Language. If this item is NOT checked, then orientation is as indicated in Printer Setup. 2.3 Create Mini-pages Print Wizard has had "mini-page" logic for some time; now we let you turn it off and on. If on, then if Print Wizard detects a report with a very small number of lines, it will attempt to create a custom page size that is just long enough to print the report at 6 lines per inch. This makes sense only on continuous-feed paper. 2.4 Guess Linage "Linage" refers to the number of lines per page. When a job being printed does not contain hard page breaks (formfeed characters), Anzio tries to determine the linage. In the past, as when "Guess Linage" is NOT checked, Print Wizard assumed 66 lines per page. With this new feature on, however, Print Wizard will do some pattern analysis, trying to figure out the linage by patterns of similar or blank lines, the word "Page", etc. If it finds a pattern, it will use that linage figure. If not, it will revert to 66. Note that you can override this conclusion in the Print Preview window. 2.5 Nice Margins If ON, Print Wizard will establish "nice" margins, balancing left and right, top and bottom, while allowing the text to fit, with a maximum margin of 1/2 inch. If OFF, it will begin printing as high and as far to the left as the printer can print, which should be in the same position as if you were printing with a Print Level of Spooler or Raw; this is often appropriate for preprinted (or overlaid) forms. 2.6 Translate PCL (added in 15.0) Tells Print Wizard to translate PCL control sequences, to print them on a non-PCL printer. See above. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 3. Controlling Alternate Fonts Anzio has had automatic font usage since 12.5. If a character to be displayed or printed is not in the font requested, Anzio will search among the fonts installed in Windows for some font with the necessary character(s). We now make it possible, with an Anzio command, to specify what fonts Anzio should and should not use, and in what order of preference. (There is not yet a GUI way to do this). Use the command FONT-ALT "" for the screen, or PRINTFONT-ALT "" for the printer. For , use a sequence of font names, separated by commas. If you DON'T want to use a particular font, place a minus in front of it. The last entry in the sequence should generally be "auto", which tells Anzio to search through all remaining fonts if necessary. Note that this is NOT case sensitive. Example: FONT-ALT "MingLiu,ms song,-ocr a extended,auto" Assume Anzio's primary Screen Font is set to Courier New. This example tells Anzio, if it needs to display a character not in Courier New, to try MingLiu, then MS Song, then every other font EXCEPT ocr a extended. Note that if you are working with Far East characters, changing the sequence of fonts can affect whether certain characters are displayed in the style of Traditional Chinese, Simplified Chinese, Japanese, or Korean. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 4. Macro Recording and Editing It is now much easier to create and manipulate Anzio's macro commands. First, in the Macros menu, you can click on "Record" to begin recording a macro. Keystrokes as well as most functions initiated via menu items will be recorded. Then go back to the Macros menu and click on "Record" again to turn it off. Anzio will prompt you for the key to assign the macro to. For other macro manipulation, go to Macros:Edit. This presents a dialog box that lets you manipulate your macros. You can view existing macros, edit them, add new ones, delete them, etc. And you can "Play" a macro; that is, execute it. In order to make macro operation more intuitive, we are updating the syntax of our macro commands. (The old syntax, and the old way of entering macros, both remain viable.) If you display an old macro, the program will convert it automatically to the new syntax. If you alter it, the new form of it will be saved. Its operation should remain the same, however. For details on the operation of this dialog, see the included file "macroedit.doc". * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 5. Multimedia With new commands in Anzio, you can cause Windows to play and even record various multimedia files. Anzio previously had the ability to play .WAV files. Now it can play MIDI (electronic music), MP3 audio, and video. For a video file, the command can position the video window anywhere in the Anzio window. See the file README.TXT for specifics. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 6. WINPRINT Printto This is a small thing, unless you need it! Suppose that you want to download a .DOC file from a server, and then print it, using Word. You want to automate this process, either in an Anzio macro or by issuing Anzio commands from the host system. In the past, this has been easy to do, using Anzio's WINPRINT command, as long as you wanted to print on the Windows default printer. Now, you can print on any named printer. Just use the command: WINPRINT "" Note that the printer name is in quotes, because it will often contain spaces. Windows will look up the file's extension, and see if it has a "printto" action associated with it. If so, it will use that action to print the file to the indicated printer. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 7. Alternate ways to start Anzio We have provided some new ways that administrators can configure Anzio to run in different situations. Briefly, for now: a) New internal environment variables in Anzio refer to a particular user's "My Documents" folder, desktop, etc. b) Environment variables included in the command line are expanded. c) Locations of the settings file and the keys file will have environment variables expanded. Together, these factors mean that one desktop icon can be used to launch Anzio, but with different users having their own operating environments. In addition, there is a new way in which the executable's name can contain parameters. See HOWTO.TXT for details, email us for more help. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 8. OLE The new OLE command in Anzio opens up many dynamic possibilities for Anzio to command and control object oriented programs, notably the Microsoft Office applications. We are just getting started in this area. See the README.TXT file for specifics, and contact us for help. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 9. New File Transfer Protocols See the included Word document "ftprot.doc". * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 10. Variable-spaced Columnar Printing When printing with Print Wizard, it is now possible to print columnar reports (where the "address" fields all line up, for instance), even while using a variable-pitch font. Print Wizard determines a theoretical column width implicitly, based on the number of characters in the widest line. Then as it prints, across each line, it counts characters, tracking a theoretical "column number". Because the width of each character is different, the printing position quickly gets misaligned from its theoretical position. Whenever an FS character (Field Separator, hex 1C) is encountered, Print Wizard will re-synch its position. That is, it will reset the printing position to column number times column width. So all you have to do to create this style report is a) specify the font, and b) include an FS character before each field. If the field following an FS is numeric, it will likely start with some leading spaces. Print Wizard handles these situations carefully, by using the correct space width. If the data between one FS and the next, or between an FS and either end of the line, is bidirectional (Hebrew, Arabic, Farsi), it will be printed in one segment, and the appropriate reordering/reshaping should take place, if the Windows system supports these languages. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 11. Secondary Passthrough Printing Anzio now supports a second channel of passthrough print, when Terminal Type is set to SCOANSI, Linux, AT386, Anzio, or VTxxx. This mode is controlled by the sequences: ESC [ 7 i Turns on secondary print ESC [ 6 i Turns it off Secondary print is intended to support very low level devices, such as receipt printers, cash drawers, and pole displays. As such, it follows these rules: a) Data to be printed is not translated in any way. b) Output is to the device configured for Raw level printing (see RAW-SETUP). c) Data is printed and flushed immediately; there is no Flush Timer. d) Secondary passthrough print will not have any effect on primary passthrough print. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 12. Device Support for Point-Of-Sale (POS) Applications Terminals and emulators used in POS applications frequently need to support multiple devices, such as printers, scanners, mag stripe readers, pole displays, scales, and cash drawer triggers. This section will summarize Anzio's capabilities in this area, including some new features. a) See "Secondary Passthrough Printing", above. b) You can have up to three printers defined: a high-level printer, a spooler-level printer, and a raw-level printer (which can be just a COM or LPT port). c) You can send textual Anzio commands from the host with commandstring Commands are described in the manual, which is on-web. See also notes in the README.TXT file. d) The PRINTLEVEL command changes the print level, and so it can implicitly change which printer is written to. e) The SPOOLER-SETUP command can change which printer is addressed when Print Level = Spooler. Printers are referenced by their Windows name. f) The RAW-SETUP command can change which file or PORT is written to when Print Level = Raw. g) Printing is for output-only devices; this could include pole displays. h) The AUX device, always serial, can be input-only, such as for a barcode scanner. Input can happen at any time, just like keystrokes. i) The AUX device is configured through Edit:Advanced Options:General, or with the AUX-SETUP command. j) The AUX device can also work in 2-way mode, during which keystroke input is NOT accepted. k) AUX input/output can be controlled by the following sequences: ESC [ 1 { AUX input/output mode on ESC [ 2 { AUX off ESC [ 3 { AUX input-only mode on (keystrokes also allowed) l) The AUX serial port can be controlled by the following sequence: ESC [ 4 ; ; { Sets AUX to COM If is 0 (or omitted), port configuration is as set in Windows If is 1, port configuration remains as specified in Anzio Any other value of is taken to be a new baud rate; other parameters are as configured in Anzio. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Notes on 12.5, updated: 1. SSH Support (AnzioWin only) (Added to Anzio Lite in 15.0) Anzio 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 Anzio, 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. Other particulars about Anzio'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 * Stored password can be used, if this feature is turned on in Advanced Options * 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, XP * Authentication can be by password and/or by public/private key * Key generation program added in 15.0 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 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 When the LAST entry specifies "auto", the logic will search for other appropriate fonts if necessary. Effective 12.6, you can specify the list of fonts to use. See above. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 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 identifier 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, 2000, and XP) 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 any character Ctrl-' acute accent any character Ctrl-6 circumflex any character Ctrl-: umlaut any character Ctrl-, cedilla any character Ctrl-~ tilde any character Ctrl-. dot below any character Ctrl-? hook above any character Ctrl-( breve any character Ctrl-& ligature a A s (for ae ligatures, sharp S) Ctrl-/ slash o O (for slashed 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 and XP, 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 or XP 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. Effective with version 15.0, a license is good for the entire duration of the major release number, i.e., 15.0 to 15.9999. 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 ), 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 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 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: 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: 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. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 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' * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 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).