User's Guide

Version 2.9.0.0

Updated 6 April 2017


Contents

  1. Overview

  2. JAVA Virtual Machine

  3. Installation of AniTa for the Web

  4. Running AniTa from a Browser using Java Web Start

  5. Running AniTa in a Browser as an Applet

  6. Configuration

  7. Running the Emulator

  8. Programmer's Guide

  9. Implementing JaniTa as a Java Bean


Chapter 1: Overview

AniTa for the Web is a version of April System Design's AniTa terminal emulator that is written in 100% Java and primarily designed for use in an Internet / Intranet environment.

Features and Benefits

AniTa is the terminal emulator that gives new life to your text based applications on platforms such as UNIX, Linux and VAX. AniTa makes your text based application look as if they were written for a windowing environment with a graphical user interface (GUI). It gives you mouse, 3-D box attributes, color support and adds a graphical touch to your character based applications. All this helps extend the life of your text-based solutions.

Terminal Emulation

AniTa supports a wide range of terminal emulations including DEC VT100, VT220, VT320, ANSI, Wyse60, and SCO Console emulations.

The easy to configure, 3-D box and color options, allow you to assign such attributes even when running an existing application written for text based monochrome screens. Alternatively the color can be controlled from the host with ANSI, ASCII or DEC VT525 color commands.

AniTa allows you to add buttons and icons to your text-based applications, and even to send information to the host by clicking the mouse on your application's screen.

Ease of Deployment

AniTa gives you the choice of deploying as an Application, as an Applet or via Java Web Start. This means that you can choose to run AniTa for the Web either in its own window or in a web browser, and you choose whether to load the program from a disk or web server.

In addition to being able to be loaded from your local workstation, AniTa can be run from a network server - either a file server or a web server. The small size of the AniTa for the Web code, means that it can be deployed not just on a Local-Area-Network server, but also on a Internet or Intranet Wide-Area-Network server.

The ability to deploy AniTa for the Web on a centralized server greatly simplifies both installation and maintenance. A single centrally stored version of AniTa means that it can be easily upgraded and maintained. When new features are added to the product, the system administrator needs only to copy it onto the central server, then all users have access to the new version. In the same way, one or more centrally located configurations allow one configuration update to apply to all users.

Platform Independence

AniTa for the Web is written in 100% JAVA. It conforms to the JAVA 2 specification and runs on a JAVA Virtual Machine version 5.0 or later.

This means that AniTa for the Web can run on any platform that supports this specification. Such platforms include Windows, Linux, Mac OS X, Solaris and UNIX well as a range of thin-clients.

By choosing AniTa for the Web as your terminal emulator, you gain independence of workstation platform. You can easily migrate from one platform to another and without problem combine different types of workstation platforms. You are no longer tied to one specific hardware or software supplier.

The pluggable look-and-feel capability implemented in AniTa for the Web means that you can have a "Microsoft Windows GUI" look-and-feel when running on Microsoft Windows and an "Linux windows GUI" look-and-feel when running on Linux or you can choose to have the same look-and-feel across all platforms.

Prerequisites

In order to run the AniTa for the Web terminal emulator or its configuration program you must have a JAVA Virtual Machine (JVM). AniTa for the Web requires version 5.0 or later. Installation of such a JVM is explained in Chapter 2 of this document; if you already have such a JVM installed, you can skip all of chapter 2.

JAVA Runtime Environment (JRE)

When running the terminal emulator as an application and when running the configuration program the JVM is normally provided by installing a JAVA Runtime Environment (JRE).

Running as an Applet

The AniTa for the Web terminal emulator can run as an Applet in a Netscape Navigator, Microsoft Internet Explorer, Mozilla or Mozilla Firefox web browser. When running as an applet, the JVM is normally provided as a plug-in to the web browser. It is not necessary to install the plug-in initially on every computer, instead the plug-in will be loaded the first time it is required (e.g. if not already present, the first time you run AniTa for the Web in a web page).

Documentation

For your convenience, a copy of this documentation is provided on the AniTa for the Web release CD. The JANITA directory on the CD contains a sub-directory called janitadoc containing this document in a file called index.html.

The latest version of the documentations is always available on the Internet at: http://www.april.se/janita.

Contact Us

The following information can be used to contact us for more information about our other products. It can also be used to obtain support help if your local distributor is unable to help you.

The two e-mail addresses below can be used to contact April's marketing and support departments. The web server contains up-to-date information about all our products and how to contact us. The ftp server contains the latest upgrades and support releases for our products.

Web server:

www.april.se

...or:

http://www.aprilsystem.com

Ftp server:

ftp://ftp.april.se

 


Chapter 2: JAVA Virtual Machine

In order to run the AniTa for the Web terminal emulator or its configuration program you must have a JAVA Virtual Machine (JVM). If you already have such a JVM installed, you can skip to the next chapter.

When running the terminal emulator as an application and when running the configuration program the JVM is normally provided by installing a JAVA Runtime Environment (JRE). When running the terminal emulator as an applet, the JVM is normally provided as a plug-in to the web browser.

AniTa for the Web will run with a JVM version 5.0 or higher.

The following information is provided only as a quick guide to installing the JVM. For the latest information see the relevant JVM documentation.

Windows JRE

The JAVA Runtime Environment (JRE) for Windows 32-bit platforms is available from Sun. For convenience, we provide a copy on the same release CD as AniTa for the Web: in a catalog called "\JRE". The latest JRE can also be downloaded from Sun over the Internet at the address: http://java.sun.com/javase/downloads/index.jsp.

For the 5.0 release

The JRE is contained in a file called: jre-1_5_0_06-windows-i586-p.exe. Note that the name of the file will change as the version of JRE changes.

To install the JRE on Windows:

  1. From the Internet

Linux Intel JRE

Some versions of Linux ship with a JRE already installed, so that it is quite likely that you will not need to install the JRE. However the following procedure can be used for those systems without a JRE or with an old version.

Please note, that unlike the Windows JRE, Sun have a different install procedure for the different versions of the Linux JREs.

The JAVA Runtime Environment (JRE) for Intel based Linux platforms is available from Sun. For convenience, we provide a copy on the same release CD as AniTa for the Web: in a catalog called "/JRE". The latest JRE can also be downloaded from Sun over the Internet at the address: http://java.sun.com/javase/downloads/index.jsp.

For the 5.0 release

The JRE is contained in a file called: jre-1_5_0_06-linux-i586.bin or jre-1_5_0_06-linux-i586-rpm.bin. Note that the name of the file will change as the version of JRE changes.

To install the JRE in Linux:

  1. Create a directory under which the software will be installed
    mkdir /usr/java

  2. Change to this directory
    cd /usr/java

  3. From the Internet

  4. Install the JRE:
    chmod a+x ./jre-1_5_0_06-linux-i586.bin
    ./jre-1_5_0_06-linux-i586.bin

To install the JRE in Linux as an RPM:

  1. Create a directory under which the software will be installed
    mkdir /usr/java

  2. Change to this directory
    cd /usr/java

  3. From the Internet

  4. Unpack the JRE:
    chmod a+x ./jre-1_5_0_06-linux-i586-rpm.bin
    ./jre-1_5_0_06-linux-i586-rpm.bin

  5. Install the JRE:
    rpm -iv jre-1_5_0_06-linux-i586-rpm.bin



Solaris Intel JRE

Some versions of Solaris ship with a JRE already installed, so that it is quite likely that you will not need to install the JRE. However the following procedure can be used for those systems without a JRE or with an old version.

The JAVA Runtime Environment (JRE) for Intel based Solaris platforms is available from Sun. For convenience, we provide a copy on the same release CD as AniTa for the Web: in a catalog called "/JRE". The latest JRE can also be downloaded from Sun over the Internet at the address: http://java.sun.com/j2se/downloads.html.

The JRE is contained in a self-extracting binary file called: jre-1_5_0_06-solaris-i586.sh . Note that the name of the file will change as the version of JRE changes (e.g. version 1.2.2 was called Solaris_JDK_1.2.2_06_i386.bin).

To install the JRE in Solaris:

  1. Change to the /export directory: cd /export

  2. From the AniTa for the Web release CD

  3. From the Internet

  4. Make sure that execute permissions are set on the self-extracting binary: chmod +x jre-1_5_0_06-solaris-i586.sh

  5. Run the self-extracting binary: ./jre-1_5_0_06-solaris-i586.sh

Solaris Sparc JRE

Some versions of Solaris ship with a JRE already installed, so that it is quite likely that you will not need to install the JRE. However the following procedure can be used for those systems without a JRE or with an old version.

The JAVA Runtime Environment (JRE) for Sparc based Solaris platforms is available from Sun. For convenience, we provide a copy on the same release CD as AniTa for the Web: in a catalog called "/JRE". The latest JRE can also be downloaded from Sun over the Internet at the address: http://java.sun.com/j2se/downloads.html.

The JRE is contained in a self-extracting binary file called: jre-1_5_0_06-solaris-sparc.sh. Note that the name of the file will change as the version of JRE changes (e.g. version 1.2.2 was called Solaris_JDK_1.2.2_06_sparc.bin).

To install the JRE in Solaris:

  1. Change to the /export directory: cd /export

  2. From the AniTa for the Web release CD

  3. From the Internet

  4. Make sure that execute permissions are set on the self-extracting binary: chmod +x jre-1_5_0_06-solaris-sparc.shn

  5. Run the self-extracting binary: ./jre-1_5_0_06-solaris-sparc.sh

Apple Mac OS X

Mac OS X ships with a highly-optimized, tightly integrated implementation of Java 2 Standard Edition, originally 1.3 and subsequently 1.4.1 and 1.5. It includes the client version of the HotSpot virtual machine. Further information can be found at: http://www.apple.com/java.

IBM AIX JRE

Information about obtaining and installing IBM AIX Java Technology Edition can be found at: http://www-106.ibm.com/developerworks/java/jdk/aix/index.html.

JAVA Plug-In

Currently only Netscape 6 supports a Java 2 Runtime Environment. No other browsers support JAVA 1.2 or later using their JAVA implementation, thus in order to run AniTa for the Web in these browser you need to have a JAVA plug-in.

JAVA Plug-Ins are available for the Netscape Navigator and Microsoft Internet Explorer web browsers from Sun at: http://java.sun.com/products/plugin/. The same site also contains very useful FAQs and Documentation.

It is not necessary to install the plug-in initially on every computer, instead the plug-in will be loaded the first time it is required (e.g. if not already present, the first time you run AniTa for the Web in a web page).

Other JAVA Virtual Machines

For other JAVA Virtual Machines, refer to the documentation provided with the JVM.

 


Chapter 3: Installation

This chapter describes the installation of AniTa for the Web. Different sections of this chapter describe the installation methods on different operating systems.

Install on Windows

AniTa for the Web can be installed on Windows 95, 98, NT, 2000, ME or XP Platforms.

To install the AniTa for the Web on Windows:

  1. From the AniTa for the Web release CD

  2. From the Internet

  3. This install program will automatically install the software and create Windows icons. You will be able to choose whether to perform installation as an Application or for the Web or for both.

  4. For a new installation, you will be prompted will by dialog requesting your host computer information. This will set-up a basic configuration file, which can be changed and further customized later. If performing an upgrade, your existing configuration will be used.

Upgrade

The above procedure can also be followed when performing an upgrade. This will cause the AniTa for the Web software to be upgraded, but the configuration files will remain unchanged.

Run AniTa for the Web

Just click on one of the shortcut icons, to run the terminal emulator or its configuration program.

Uninstall

The installation procedure will automatically create an uninstall program. To run this, go to the "Control Panel" and click on "Add/Remove Programs". Select "AniTa for the Web" and click on the Add/Remove button.

Install on Mac OS/X

JaniTa is packaged as a standard Mac OS/X installable .PKG format file contained on a virtual disk image .DMG.

Connect to April download server:

Use Mac OS/X (Safari) browser (FTP client) to connect to ftp://www.april.se/pub/janita/macosx/
You will find icons: janitaxxxx.dmg, JaniTaxxxx.pkg, JaniTaxxxx.pkg.zip and this readme.txt.
Everything you need is contained on the .dmg disk image.
(The .pkg and .zip files are not needed but are there for historic reasons.)

Download method:

Optionally, Drag the JaniTaxxxx.dmg icon to your desktop (or other folder).
Double Click on the .dmg file to mount it in OS/X.
Use the following .pkg installation method:

Double-click the JaniTaxxxx.pkg icon. The Mac OS/X Installer will install JaniTa as "AniTa Terminal" folder in your "Program" folder.

If the Installer/Gatekeeper rejects because of unidentified developer:

    Open OS/X System Preferences, Security & Privacy. In the "General" tab, click "Open anyway" button to open the last rejected pkg file.

After installation, the .dmg is no longer needed.

Starting AniTa:

Double-click the janita.jar icon. This will start AniTa and the configuration program (janitaconfig) if a configuration file is missing.

Install on Linux

This section described how to install AniTa for the Web on Linux platforms. It also explains how to add AniTa for the Web icons to the desktop - examples are given for the KDE 2.1 desktop. The procedures are similar for other desktops such as Gnome and CDE.

  1. Create a convenient catalog to contain AniTa for the Web: mkdir /usr/local/janita

  2. Change to this directory: cd /usr/local/janita

  3. From the AniTa for the Web release CD

  4. From the Internet

  5. Run the install shell script: sh ./install-janita
    This will perform the following:

Upgrade

The above procedure can also be followed when performing an upgrade. This will cause the AniTa for the Web software to be upgraded, but the configuration files will remain unchanged.

Adding KDE Desktop Icons - on the desktop

It is possible to start AniTa from a desktop icon.

  1. Right click on the Desktop, select "Create New" and "Link To Application"

  2. On the "General" property page enter the name: AniTa for the Web

  3. On the "General" property page click on the icon symbol. Then select "Other Icons" and "Browse". Enter the name of the icon: /usr/local/janita/janita.png

  4. On the "Execute" property page click enter the command: /usr/local/janita/janita

To start the configuration program from a desktop icon.

  1. Right click on the Desktop, select "Create New" and "Link To Application"

  2. On the "General" property page enter the name: AniTa Configuration

  3. On the "General" property page click on the icon symbol. Then select "Other Icons" and "Browse". Enter the name of the icon: /usr/local/janita/janitaconfig.png

  4. On the "Execute" property page click enter the command: /usr/local/janita/janitaconfig

To add the AniTa for the Web documentation a desktop icon.

  1. Right click on the Desktop, select "Create New" and "Link To Location (URL)"

  2. Enter the URL to the documentation: file:/usr/local/janita/index.html

  3. Click OK

  4. Right click on the newly created link

  5. On the "General" property page enter the name: AniTa Documentation

  6. On the "General" property page click on the icon symbol. Then select "Other Icons" and "Browse". Enter the name of the icon: /usr/local/janita/janitahelp.png

Adding KDE Desktop Icons - in the start menu

It is possible to start AniTa from the KDE Start Menu.

  1. From the start menu, select "Configure Panel" and "Menu Editor" to run the menu editor: kmenuedit

  2. Click on the "New Submenu" icon and enter the name of the menu: AniTa for the Web

  3. Click on the newly created submenu

  4. Click on the "New Item" icon and enter the name of the item: AniTa

  5. Click on the newly created item

  6. In the general properties, enter the "Command": /usr/local/janita/janita

  7. Enter the "Work Path": /usr/local/janita

  8. Click on the icon symbol after the "Work Path". Then select "Other Icons" and "Browse". Enter the name of the icon: /usr/local/janita/janita.png

To add the configuration program to the start menu.

  1. Click on the newly created submenu

  2. Click on the "New Item" icon and enter the name of the item: Configuration

  3. Click on the newly created item

  4. In the general properties, enter the "Command": /usr/local/janita/janitaconfig

  5. Enter the "Work Path": /usr/local/janita

  6. Click on the icon symbol after the "Work Path". Then select "Other Icons" and "Browse". Enter the name of the icon: /usr/local/janita/janitaconfig.png

To add the AniTa for the Web documentation to the start menu.

  1. Click on the newly created submenu

  2. Click on the "New Item" icon and enter the name of the item: User's Guide

  3. Click on the newly created item

  4. In the general properties, enter the "Command": konqueror /usr/local/janita/index.html

  5. Enter the "Work Path": /usr/local/janita

  6. Click on the icon symbol after the "Work Path". Then select "Other Icons" and "Browse". Enter the name of the icon: /usr/local/janita/janitahelp.png

Run AniTa for the Web

To Run the AniTa for the Web terminal emulator from the command line: /usr/local/janita/janita

To Run the AniTa for the Web configuration from the command line: /usr/local/janita/janitaconfig

If you configured desktop icons, just click on one of the shortcuts, to run the terminal emulator or its configuration program.

Web Install

To make AniTa for the Web available via the Web server on your Linux machine, you must do the following additional steps:

  1. Determine the location of the directory tree shared by the web server. By default this is /home/httpd/html for Apache.

  2. Copy the AniTa for the Web files to the desired location within the tree:
      cp /usr/local/janita/janita.jar /home/httpd/html
      cp /usr/local/janita/janita.gif /home/httpd/html

  3. Run the AniTa for the Web configuration program: /usr/local/janita/janitaconfig

Install on UNIX

This section described how to install AniTa for the Web on UNIX platforms, including Solaris.

  1. Create a convenient catalog to contain AniTa for the Web: mkdir /usr/local/janita

  2. Change to this directory: cd /usr/local/janita

  3. From the AniTa for the Web release CD

  4. From the Internet

  5. Run the install shell script: sh ./install-janita
    This will perform the following:

Upgrade

The above procedure can also be followed when performing an upgrade. This will cause the AniTa for the Web software to be upgraded, but the configuration files will remain unchanged.

Adding Desktop Icons

If you want to start AniTa for the Web from a desktop icon or start bar, you can do this. See "Install on Linux" as a guide to doing this.

Run AniTa for the Web

To Run the AniTa for the Web terminal emulator from the command line: /usr/local/janita/janita

To Run the AniTa for the Web configuration from the command line: /usr/local/janita/janitaconfig

If you configured desktop icons, just click on one of the shortcuts, to run the terminal emulator or its configuration program.

Web Install

To make AniTa for the Web available via the Web server on your UNIX machine, you must do the following additional steps:

  1. Determine the location of the directory tree shared by the web server. For example /usr/local/apache.

  2. Copy the AniTa for the Web files to the desired location within the tree:
      cp /usr/local/janita/janita.jar /usr/local/apache
      cp /usr/local/janita/janita.gif /usr/local/apache

  3. Run the AniTa for the Web configuration program: /usr/local/janita/janitaconfig

 


Chapter 4: Running AniTa from a Browser using Java Web Start

Why use Java Web Start

Java Web Start combines the features and flexibility of a Java Application with the convenience and ease of use of a Web based program.

With Java Web Start, AniTa for the Web can be installed and configured once on a central web server, and then executed by users anywhere on the web without needing to install AniTa.

With Java Web Start, you launch AniTa for the Web simply by clicking on a Web page link. If AniTa for the Web is not present on your computer, Java Web Start automatically downloads all necessary files. It then caches the files on your computer so that AniTa for the Web is always ready to be relaunched anytime you want -- either from an icon on your desktop or from the browser link. And no matter which method you use to launch the application, the most current version of the application is always presented to you

Java Web Start runs independently of any browser, you can shut down your browser or surf to another Web page and continue using AniTa for the Web. When deployed with Java Web Start, AniTa for the Web does not require a browser interface to operate.

To save time later, the user can relaunch AniTa for the Web from the desktop icon, without powering up their browser again.

AniTa for the Web will only be loaded once across the web. Subsequently it will be executed from the client's local cache. However new versions of the AniTa for the Web program, or changes to its configuration will be automatically detected and updated.

AniTa for the Web is signed to provide security in an Internet environment.

What's needed on the Workstation

On the workstation you need a web browser and a Java Runtime Environment version 1.5 or later.

To install a JRE go to: http://java.sun.com/javase/downloads/index.jsp

Testing the Workstation Installation

You can test the Web Start functionality it by running one of Sun's demo applications.

These are available at: http://java.sun.com/products/javawebstart/demos.html

Setting up your own Web Server

Files

The directory on your web server that is chosen for 'AniTa for the Web' should contain the following files:

Because of janitaconfig's "export to jnlp" function, we suggest that you install the Java Runtime Environment 1.5 and the full AniTa for the Web onto the web server, even if you do not plan to use the application. There is however no requirement to install either Java or AniTa onto the Web server, it is quite possible to run the configuration program on a workstation, and just copy the exported JNLP and AWS file from the workstation to the server.

MIME

Configure the Web server to use the Java Web Start MIME type. All files with the .jnlp file extension should be set to the application/x-java-jnlp-file MIME type.

Most Web browsers uses the MIME type returned with the contents from the Web server to determine how to handle the particular content. The server must return application/x-java-jnlp-file MIME type for JNLP files in order for Java Web Start to be invoked. Each Web server has a specific way in which to add MIME types.

For a full explanation, check the documentation for the specifics of your Web server.

MIME on Apache

For the Apache Web server you must add a line to the MIME Types file. Look in the httpd.conf file for the parameter TypesConfig. This is followed by the name of the MIME Types file used by Apache. This file is usually called /etc/mime.types. Check this file for jnlp, and if it doesn't have an entry then add the following line:

application/x-java-jnlp-file jnlp

It is necessary to restart the Apache web server after adding a new MIME mapping !!!

MIME on Microsoft IIS

For Microsoft's Internet Information Server, this is done using the Internet Service Manager. Right click on the server and select properties. Select Computer MIME map and determine whether the .jnlp extension is mapped.

If the .jnlp extension is not mapped, then click "New Type" to map .jnlp to application/x-java-jnlp-file.

It is necessary to restart the IIS web server after adding a new MIME mapping !!!


5: Running AniTa in a Browser as an Applet

Why use AniTa as an Applet

AniTa for the Web can be run as an applet in a Web Browser. The AniTa applet is contained within the HTML code of a web page. The web page and the applet reside on the web server. The web page is  normally in HTML format, but other formats such as ASP (Active Server Page) or JSP (Java Server Page) can be used to contain AniTa. ASP or JSP pages are especially useful if server side scripting is used in conjunction with AniTa.

AniTa is run in the Web Browser's Window and controlled by the Web Browser. AniTa is dependant on the type and version of Web Browser used. This is different from using Web Start, which only uses the Web Browser to start AniTa, then AniTa has control over its own window.

When running as an applet, AniTa for the Web can be installed and configured once on a central web server, and then executed by users anywhere on the web without needing to install AniTa.

AniTa for the Web is signed to provide security in an Internet environment.

What's needed on the Workstation

On the workstation you need a Web Browser and a Java Plug-In Runtime Environment. AniTa for the Web requires version 5.0 or later of Java to run.

The first time the web browser encounters a web page that specifies the use of the plug-in, the browser must download and install the required files. System administrators can determine where users download Java Plug-in software; either from http://java.sun.com or from an internal server.

Sun provide information about the latest plug-in on their web site. Plug-ins can be downloaded free of charge from Sun: http://java.sun.com/products/plugin/

Setting up your own Web Server

The directory on your web server that is chosen to for AniTa for the Web should contain the following files. They can be copied anywhere into the normal directory tree shared by the web server. the do not need to be placed in any special catalog such as cgi-bin.

You need to create a web page to contain the applet. This page is normally in HTML format. A default HTML page can be created automatically by the AniTa for the Web configuration program janitaconfig The web page will contain HTML tags to hold the applet and the configuration parameters.

Because of janitaconfig's "export to html" function, we suggest that you install the Java Runtime Environment 5.0 and the full AniTa for Java onto the web server, even if you do not plan to use the application. There is however no requirement to install either Java or AniTa onto the Web server, it is quite possible to run the configuration program on a workstation, and just copy the exported HTML file from the workstation to the server.

Once the configuration has been exported, the HTML file can be customized. It is also possible to use this HTML file as the basis for an ASP (Active Server Pages) or JSP (Java Server Pages) file. These allow the page including the AniTa for the WEB configuration to be changed dynamically using Visual Basic and JavaScript (ASP) or Java (JSP) programs.

What is the difference the signed and unsigned versions of the Applet ?

Note This section is only relevant to versions prior to 2.0 since all code is signed starting with version 2.0.

The AniTa for the WEB applet is provided in two versions, the file janita.jar which is unsigned and the file janitas.jar which has been signed.

When an applet that has been signed is loaded into the web browser it is possible to verify who its creator was (in our case April System Design AB with a home site of www.april.se).

The applet is also checked to verify that it has not been changed since it was signed by the creator. A signed applet cannot be infected by a virus and still be successfully verified.

Web browsers contain a security mechanism called the sandbox. This sandbox greatly restricts the capabilities of applets. For example, the sandbox will only allow an applet to establish a terminal session (telnet) with the web server, it is not possible to telnet directly into any other machine.

However because of the built in verification security in a signed applet, it is possible for the user to "trust" a signed applet. The "trusted" applet still runs within the browser's sandbox, but with many of the restrictions removed.

The following functions can be performed by a signed and trusted, but not an unsigned, AniTa for the WEB applet.

We recommend using the signed version of the AniTa for the WEB applet.


Chapter 6: Configuration

Using the Configuration Program

The configuration information for AniTa for the Web is stored in an INI file, usually called janita.ini. The configuration program, janitaconfig, allows you to set most of the available configuration parameters. If you want to use a different configuration file name, this can be specified as the first parameter on the janitaconfig command line.

The configuration program is divided into a number of different cards. Each of the cards is shown and explained later in this chapter.

 

Using Mnemonics

AniTa for the Web supports a wide range of mnemonics. These are compatible with those in the Windows version of AniTa. Mnemonics always start with a < and end with a >, for example <ESC>.

These mnemonics allow different ways to specify the same code. For example all of the following would have the same effect: <cr> <ctrl-M> and <0D>

Letters used in mnemonics are not case dependant.

Standard ASCII Mnemonics

Valid mnemonics for ASCII characters:

<nul> <null> <soh> <stx> <etx> <eot> <enq> <ack> <bel> <bs> <ht> <tab> <lf> <vt> <form> <cr> <so> <si> <dle> <dc1> <dc2> <dc3> <dc4> <nak> <syn> <sync> <etb> <can> <em> <sub> <esc> <fs> <gs> <rs> <us> <del> <csi>

Mnemonics for control values

Control characters can also be specified using a mnemonic containing ctrl- followed a character. For example to send a control C (0x03) use the mnemonic <ctrl-C>.

Mnemonics for hexadecimal values

Characters can be specified using a mnemonic containing their hexadecimal value as a two-digit value. To send the character 'A' which has a hexadecimal code of 0x41 use the mnemonic <41>.

 

Using Macros

AniTa for the Web supports a wide range of macros. With the exception of the keyboard macros, these are compatible with those in the Windows version of AniTa. Macro names always start with a % and end with a %, for example %hangup%. A macro name may optionally be followed by some additional data, for example %connectto%www.april.se

Letters used in macro names are not case dependant.

Standard Macros

%clearselect%
Causes the selected part of the screen that has been marked by dragging the mouse to be cleared.
%connect%
Causes AniTa to connect to the host.
%connectto%hostname
%connectto%hostname:port
Causes AniTa to connect to the specified hostname. An optional port number may also be specified.
%copy%
Causes the selected portion of the screen to be copied to the clipboard.
%copyandpaste%
Causes the selected portion of the screen to be copied and then immediately pasted back into AniTa.
%exit%
Causes the session to be disconnected and the AniTa program to terminate.
%hangup%
Causes the session to be disconnected.
%local%data
Causes the following data to be parsed by AniTa as if it had been received from the host.
%paste%
Causes the contents of the clipboard to be pasted into AniTa.
%printscreen%
Causes the screen to be dumped to the printer.
%run%commandline
Executes the specified command line. If the program name or one of its parameters contains a space then it should be inclosed in quotes. The full path to the program name should be used. The command line can differ depending on the platform on which janita is running. The rundll32 program can be used on Windows to open a file in the program with which it is associated. The %scr% and %txt% macros can be used as part of the command line
%run%"C:\Program Files\Internet Explorer\iexplore.exe" http://www.april.se
%run%open http://www.april.se/%scr1:5:0%
%run%rundll32 SHELL32.DLL,ShellExec_RunDLL "C:\projects\janita\to do.doc"
%runwait%commandline
Executes the specified command line, waiting for the program to terminate before continuing.
%selectall%
Causes the whole screen to be selected. Often used together with copy: %selectall%%copy%
%serial%
Replaced by the serial number for which AniTa is licensed.
%scrCOL:ROW:LEN%
Replaced by the contents of the screen buffer starting at the specified row and column for the specified length. If the length is 0 then until the first space is encountered. To "scrape" the contents of the whole of the second line use %scr1:2:80%.
%terminal%
Replaced by the terminal type for which AniTa is configured. This is the terminal type that is negotiated when the telnet session is established.
%tx%data
Causes the following data to be sent to the host. This is the default behavior and is not normally required. However it can be useful when combined with another macro, in which case it is used to terminate a parameter following a macro. For example %local%<esc>[69y%tx%ls -l<cr>
%txtCOL:ROW:LEN%
Has the same function as %scrCOL:ROW:LEN% except that leading and trailing spaces are ignored.
%users%
Replaced by the number of users for which AniTa is licensed.
%zoom%
Toggles full screen mode.
%url%
Opens a image file in a separate java window.
In case of other file or URL types the default application for the given file, such as the default browser or email client, is launched.
Requires java version 6 minimum.

Examples:
%url%http://www.april.se/english/ftp.asp
%url%ftp://ftp.april.se/pub/DynaPass/manual.pdf
%url%file://C:/files/table.csv
%url%ftp://ftp.april.se/pub/anita/nectar_99.txt
%url%mailto:info@april.se

In case of a local file you need to include the host:
%url%file://localhost/C:/anita/janita.jpg
%url%file://localhost/home/user/anita/janita.jpg

Mouse Macros

%col%
The position (column) on which the mouse was clicked.
%colup%
The position (column) on which the mouse was released. For a click this is the same as %col%. If the mouse is dragged then it will be different.
%row%
The position (row) on which the mouse was clicked.
%rowup%
The position (row) on which the mouse was released. For a click this is the same as %row%. If the mouse is dragged then it will be different.
%shiftstate%
The keyboard shift-state for the mouse event. Values are 1 (shift), 2 (ctrl) and 4 (alt). These are accumulative, thus shift plus alt would give 5.

Keyboard Macros

Keyboard macros cause the value of a terminal specific key to be sent to the host. The keyboard macros available depend on the terminal type.

Keyboard macros available for DEC terminals such as VT220:

%backspace% %enter% %np_enter% %np_period% %np_comma% %np_minus% %np_0% %np_1% %np_2% %np_3% %np_4% %np_5% %np_6% %np_7% %np_8% %np_9% %F6% %F7% %F8% %F9% %F10% %F11% %F12% %F13% %F14% %F15_HELP% %F16_DO% %F17% %F18% %F19% %F20% %FIND% %INSERT% %REMOVE% %SELECT% %PREV_SCREEN% %NEXT_SCREEN% %UP% %DOWN% %RIGHT% %LEFT% %PF1% %PF2% %PF3% %PF4% %PF5% %F6_S% %F7_S% %F8_S% %F9_S% %F10_S% %F11_S% %F12_S% %F13_S% %F14_S% %F15_HELP_S% %F16_DO_S% %F17_S% %F18_S% %F19_S% %F20_S%

Keyboard macros available for ANSI terminals such as SCO Console:

%UP% %DOWN% %RIGHT% %LEFT% %F1% %F1_S% %F1_C% %F1_SC% %F2% %F2_S% %F2_C% %F2_SC% %F3% %F3_S% %F3_C% %F3_SC% %F4% %F4_S% %F4_C% %F4_SC% %F5% %F5_S% %F5_C% %F5_SC% %F6% %F6_S% %F6_C% %F6_SC% %F7% %F7_S% %F7_C% %F7_SC% %F8% %F8_S% %F8_C% %F8_SC% %F9% %F9_S% %F9_C% %F9_SC% %F10% %F10_S% %F10_C% %F10_SC% %F11% %F11_S% %F11_C% %F11_SC% %F12% %F12_S% %F12_C% %PGUP% %PGDN% %INS% %DEL% %HOME% %END% %NP_5% %BTAB%

Keyboard macros available for Wyse terminals such as Wyse60:

%INSCHAR% %INSLINE% %INS% %REPL% %PGDN% %PGUP% %END% %END_S% %DELLINE% %DELCHAR% %PRINT% %DEL% %DEL_S% %END% %END_S% %PGDN_S% %PGUP_S% %F1% %F2% %F3% %F4% %F5% %F6% %F7% %F8% %F9% %F10% %F11% %F12% %F13% %F14% %F15% %F16% %F1_S% %F2_S% %F3_S% %F4_S% %F5_S% %F6_S% %F7_S% %F8_S% %F9_S% %F10_S% %F11_S% %F12_S% %F13_S% %F14_S% %F15_S% %F16_S% %F1_C% %F2_C% %F3_C% %F4_C% %F5_C% %F6_C% %F7_C% %F8_C% %F9_C% %F10_C% %F11_C% %F12_C% %F13_C% %F14_C% %F15_C% %F16_C% %F1_SC% %F2_SC% %F3_SC% %F4_SC% %F5_SC% %F6_SC% %F7_SC% %F8_SC% %F9_SC% %F10_SC% %F11_SC% %F12_SC% %F13_SC% %F14_SC% %F15_SC% %F16_SC% %ESC% %ESC_S% %BTAB% %TAB% %BSPACE% %BSP_S% %RETURN% %RETUR_S% %HOME% %HOME_S% %UP% %UP_S% %DOWN% %DOWN_S% %LEFT% %LEFT_S% %RIGHT% %RIGHT_S% %ENTER% %ENTER_S% %SEND%

 

Exporting to an HTML file

Once a configuration has been completed, it is possible to export it into an HTML file. The file format exported will contain both an <OBJECT> and an <EMBED> tag so that it works with both Internet Explorer and Netscape Navigator browsers. If the "Auto export to HTML on save" box is checked on the Web Information card, then the configuration will automatically be exported to the specified HTML file every time a save is performed.

 

Exporting to an JNLP file

Once a configuration has been completed, it is possible to export it for Java Web Start. This will create a JNLP file for Web Start and an AWS file for AniTa. If the "Auto export to JNLP on save" box is checked on the Web Start Information card, then the configuration will automatically be exported to the specified JNLP and AWS files every time a save is performed.

 

Importing an existing AniTa for Windows configuration

Existing users of AniTa for Windows can import their existing configuration (WCF and MAP) files into the configuration program to create a AniTa for the Web configuration (INI) file.

 

Connection Settings

Protocol
Choose whether to run over Telnet or SSH.
 
SSH Authentication
When using SSH select user authentication method.
 
Connection Timeout
SSH connection timeout in milliseconds
 
Private Key Path
In case of Public Key Authentication type the path to the private key file.
 
Use Passphrase
Check this box if the private key requires a passphrase.
 
Generate Keypair
This will promt the following dialog:

The generated keys will be stored in the janita running directory and the Key Path text field will be updated.
The public key should be appended to the 'authorized_keys' file in the home/user/.ssh directory on the host in case of a RSA key pair.
A DSA public key might be used in either the 'authorized_keys' file or the 'authorized_keys2' file.
 
Host Name
This is the name of the host to which AniTa will connect. An IP address can be used instead of a host name.
 
Host Name
This is the name of the host to which AniTa will connect. An IP address can be used instead of a host name.
 
Host Alias
This alias is shown instead of the name. Often used when the name is just an IP address, but the users should know to what system they are being connected. Shown on the title bar and in tooltips. Ignored if empty or if prompt for host is selected, in which case the host name is always shown.
 
Telnet Port
This is the port number on the host machine to which AniTa will connect. Normally port 23 is used, this being the default port for telnet.
 
Host Platform
This is the platform type of the host to which AniTa is connecting. This is used to help set-up a default keyboard layout which matches the terminfo configuration of that platform.
 
Country
This is the country to use to help determine default settings and to determine which National Replacement Character set to use if 7-bit characters are configured.
 
Language
This determines the language of the menus and prompts used in AniTa.
 
Connect when started
When checked, AniTa will automatically connect to the host when started. If not checked, a action such as the connect button being pressed must be performed in order to initiate a connection. 
 
Prompt for host 
When checked, AniTa will prompt for the host name with which to connect every time a session establishment is attempted. A dialog box will prompt for the server, using the host name specified above as the default value. When not checked, the connection will be immediately performed to the configured host name without any prompting.

 

Terminal Configuration

Terminal
The terminal type emulated.
 
Character Set
The character set used on the host computer. This will be converted to Unicode internally in AniTa. If you select the 7-bit ASCII (DEC National) character set, then the configured country value will be used to determine the country-specific NRC (National Replacement Character-set) to use. 
 
Columns & Rows
The screen size to use. Eighty columns and 24 or 25 rows are the most common.
 
New Line
When checked, the cursor will automatically wrap to the beginning of the next line when it reaches the end of the current line. If not checked, the cursor will remain at the end of the line until moved by the host, any additional character received will overwrite the last.
 
Answerback
This string will be sent to the host in response to an answerback request.
 
Tabs
This string is a comma separated list that sets the default tab positions.
Use NAWS
Check this to send NAWS (Negotiate About Window Size) if the host side initiate the window size change. Note that this option may cause problems (hanging ports) if used when connecting to AIX telnet. The result of the NAWS protocol is that the tty port (/dev/tty??) will set the internal number of columns and wrap text based on that. Another effect is that the environment variables COLUMNS and ROWS are updated.

 

Automatic Login

Enable 
When checked this enable Automatic Login. If not checked, all automatic login parameters are ignored.
 
Prompt & Reply
These are pairs of strings. When automatic login is enabled, AniTa will wait for the first prompt to be received from the host. Upon receipt, it will send the reply back to the host. When one prompt/reply pair has been completed, AniTa will move onto the next pair. This will continue until all prompts have been received and their respective replies sent back to the host.
 
Send <cr> after each reply
When checked, this causes AniTa to send a <cr> as if the enter key were pressed after each of the automatic login replies. If not checked, the replies are sent as-is and must include any enter-key if required.
 
Millisecond delay before each reply
This is the length of the pause between the prompt being received from the host and the reply being sent back to the host. Specified in milliseconds.
 
Blank screen during login
When enabled, no data will be shown on the screen until either the specified string has been received or the specified timeout has expired.
 
Display On
When this string has been received from the host, screen display will be started.
 
Max Sexonds
Screen display will be started after this number of seconds have expired even if the "display on" string has not been received.

 

Keyboard Mapping

To determine which keys are mapped...

To determine how a key is mapped, click in the "Mapped keys" scroll box. Move the select marker up or down to find a specific key. The "Mapped keys" box shows one line for each mapped key. The line contains three parameters, the keycode, the shift code and the string to which the key is mapped. The key and shift codes will be translated and shown in the "Key Code", "Symbolic name" and shift "Combination" fields.

To map a key...

  1. Press the "Map new key" button.

  2. Click on the "Next" button to start the wizard

  3. Press the key or key combination you wish to map. To map shift-F9 press the F9 key and the shift key together. The key combination to be mapped will be shown in the "Key Code", "Symbolic name" and shift "Combination" fields.
     

     

  4. Click on the "Ok" button to confirm which key combination you are mapping

  5. Enter the string to which the key should be mapped. The string may contain mnemonics and macros. You can...

    • Type in the string directly into the "Definition" field.

    • Click on the "View predefined keys" button to select a predefined key macro for your specific terminal type.

    • Click on the "View predefined macros" button to select an AniTa macro.

  6. Click on the "Finish" button to complete the mapping.

Note: Java does not allow the numeric keypad's Enter key to be mapped differently from the main keyboard's Enter key. These both have the same key code in Java.

To remove a key's mapping...

  1. Select the key in the "Mapped keys" scroll box. 

  2. Press the "Delete key mapping" button.

 

Web Information - Web Start

The parameters on this page are used to export the configuration information from the configuration file into a web page that can be used to start AniTa as a Web Start application. If you do not plan to run AniTa via Web Start then you can ignore these parameters.

To run AniTa via the Web, just point the Web Browser at the anita.jnlp page, or set-up link to it and click.

Web Start page name
This specifies the name of the web page which the configuration program will create so allow AniTa to be started as a Web Start application.
 
Web Start config name
This specifies the name of the file created by the configuration program to contain the AniTa parameters. It always has the same name as the Web Start page name but with a .AWS extention instead of .JNLP
 
Web Server directory
This specifies the web path to the directory containing the exported files.
 
Auto export to JNLP on save
When checked, the JNLP and AWS files will be exported to the web every time the configuration is changed. When not checked, the export must be done manually via the "File" menu.

 

Web Information - Applet

The parameters on this page are used to export the configuration information from the configuration file into a web page that contains AniTa as an Applet. If you do not plan to run AniTa as an Applet in a Web Browser then you can ignore these parameters.

To run AniTa via the Web, just point the Web Browser at the anita.html page, or set-up link to it and click.

Web page name
This specifies the name of the web page to which the configuration program will export the applet and the configuration parameters.
 
Minimum Java version
The exported web page will check to make sure that the web browser that loads it has this version (or later) of the Java plug-in available.
 
Auto export to HTML on save
When checked, the Applet and configuration will be exported to the web page every time the configuration is changed. When not checked, the export must be done manually via the "File" menu.
 
Applet Size
The size of the Applet can be set either to a fixed number of pixels or as a percentage of the browser window size.
 
Applet Height
This is the height in pixels or percent of the area in the browser's window that will be reserved to contain the Applet.
 
Applet Width
This is the width in pixels or percent of the area in the browser's window that will be reserved to contain the Applet.
 
Applet Exit
This specifies the page, if any, that the browser will go to when the applet exits. This can be used in conjunction with janita's disconnect behavior in order to make the applet even change web page on disconnect.

 

License Information

License Code 
This is the license code that authorizes you to use AniTa. When you key in a license code, you will be show the number of users that are licensed and the license's serial number. 
 
Some license codes are for evaluation purposes and have an expiry date. Normal licenses do not expire and thus will not have a date shown in this field.
 
When you start AniTa with an evaluation license you will be shown a copyright dialog with license information. You can click accept to immediately continue. 
 
When you start AniTa without a license, or with an expired evaluation license you will be shown a copyright dialog with license information. You can click accept to continue after 15 seconds (use this time to read the license).
 
AniTa with a normal license, will bypass this license dialog and start immediately. 

 

Screen Font

Automatically choose largest possible initial font size
When checked and running as an application, the configured "Font Size" is ignored and AniTa will pick the biggest font size possible, such that the whole terminal emulator will still fit onto the screen.
If Anita for the Web is run as an applet set to dynamical resizing this setting has no effect. The applet always chooses the largest possible font size.
 
Change font size when window resized
When checked and running as an application, the font size will be automatically adjusted to fit into a resized window. The largest font that will fit into the new window will be chosen. The window will then be adjusted to exactly fit this new font size. 
 
Automatically choose best style for platform
When checked the configured "Font Style" is ignored and AniTa will pick the best font style for the system on which it is running. This will normally be bold on a Windows PC and normal on other systems.

There are two font selection areas for when the terminal is in 80 character and 132 character wide mode, respectively. It is often desired to change to a smaller and/or narrower font when the terminal switches from a screen that is 80 to one which is 132 characters in width.

Font Name
This configures the font to be used on AniTa's terminal screen. Any fixed-width font can be configured. The Monospaced font which should be available on all Java platforms is the default.
Pressing the "Browse installed fonts" button will allow you to choose from the fixed width fonts installed on your computer.
 
Font Style
This configures the font style to be used on AniTa's terminal screen. Valid styles are Normal, Bold, Italic or Bold-Italic. This setting is ignored if "Style adjusted to system" is checked.
 
Font Size
This configures the font size to be used on AniTa's terminal screen.  This setting is ignored if "Size adjusted to screen" is checked.
 
Sample
This shows a sample of the font name/style/size selected. 
 

Frame Appearance

Look and feel
This configured the Pluggable Look And Feel (PLAF) to use.
 
Plaf name
This configures the name of the PLAF if a non-standard (Configurable) look and feel has been selected. An example of a PLAF name is: javax.swing.plaf.metal.MetalLookAndFeel
 
Show AniTa's buttons - Text and/or Icons
This is defined how the AniTa button row (containing the Connect, Copy, Print etc. buttons) is shown. If neither Text not Icons is selected, then the button row is disabled. Otherwise the button row is enabled, the buttons containing Text and/or Icons.
 
Show AniTa's buttons - Fixed border
When selected, a border will always be shown permanently around all buttons in the AniTa button row.
 
Show AniTa's buttons - Border when mouse over
When selected, a border will only be shown around a button in the AniTa button row when the mouse is over the button. When the mouse enters a button the border will be drawn. When the mouse exits the button, the border will be removed.
 
Terminal Border Size and Colors - Frame
This configures the color of the frame around the AniTa window and its size (in pixels). 
 
Terminal Border Size and Colors - Overscan
This configures the color of the overscan frame around the AniTa window and its size (in pixels). Two different colors can be configured, one for normal operation and one for when the emulator is disconnected.
 
Terminal Border Size and Colors - App Background
This configures the color of AniTa background outside of the terminal area. This is seen when the terminal area is smaller than the area in which it resides. This can happen when running as an Applet and the Applet size is larger than the terminal area size. It can also happen when running as an application and in full screen mode.
 
Application's Title Bar
The title bar options are ingored when running as an applet - in which case the standard browser title bar will be displayed.
 
Application's Title Bar - Show Title Text
When enabled this specifies the additional text to show in the title bar. 
 
Application's Title Bar - Show Application Name
When enabled this specifies the application name to show in the title bar. 
 
Application's Title Bar - Show Hostname
When enabled this specifies that the current hostname be shown in the title bar. 
 
Application's Title Bar - Show Connected Status
When enabled this specifies that the current connected / disconnected status be shown in the title bar. 
 
Application's Title Bar - Show Config File
When enabled this specifies that the current configuration filename be shown in the title bar. 

Window Position

These parameters are used to control how an AniTa application's window is initially positioned on the screen. They only apply when running as an application. They can be ignored when running as an Applet; positioning is then performed by the HTML code in the Web Browser.

Window Position - Centered on screen
When checked, AniTa will center itself in the middle of the screen.
 
Window Position - Use operating system default
When checked, AniTa will not position itself. Instead it will leave this up to the operating system, taking the default position.
 
Window Position - Absolute
When checked, AniTa will position itself at the specified X and Y coordinates. Note that specifying a position of -1 will cause the window to be centered. So that an X value of -1 and a Y value of 0 will cause the window to be placed at the top of the screen and centered horizontally.
 
Screen Margins - Top, Right, Left & Bottom
The screen margins specify an area at the side of the physical screen that will be ignored by AniTa. These margins will be taken into account when positioning the window in the center of the screen and when calculating the largest possible font size that will fit into the window. A frequent use is to make sure that AniTa leave room on the screen for the Microsoft Windows Taskbar or the KDE Panel.

 

Colors

This dialog box determines how AniTa maps the different terminal screen attributes to colors. Selecting "Use Host Color" will disable AniTa's mapping of attributes to colors, this being especially useful if the host sets its own colors. 

To determine which color is mapped to a given screen attribute...

  1. Click on the attribute in the list box (e.g. Bold).

  2. The foreground and background colors will be shown in the columns to the right. The colors for the specified attribue will be displayed with a white or gray border and will be shown as an in-box.

  3. A sample of how text would be shown on the screen is also shown at the bottom of the dialog box

To map a screen attribute to a color combination...

  1. Click on the attribute in the list box (e.g. Bold).

  2. Click on the desired foreground color the columns to the right, the new color will be displayed with a white or gray border and become an in-box.

  3. Click on the desired background color the columns to the right, the new color will be displayed with a white or gray border and become an in-box.

  4. A sample of how text would be shown on the screen is also shown at the bottom of the dialog box

 

Boxes

This dialog box determines how AniTa maps different colors to boxes. By default there are three types of boxes, an in-box and out-box and an edit-box. It is possible to add new box definitions.

To determine which colors are mapped to boxes...

  1. The foreground and background colors which have been mapped to a box are displayed with a box around their color.

To determine which box is mapped to a given color...

  1. Click on the color. This can be either a foreground or a background color. The current color will be displayed with a white or gray border and become an in-box.

  2. A sample box is drawn for this color containing today's date, and the box type shown.

To map a color to an existing box type...

  1. Click on the color. This can be either a foreground or a background color. The current color will be displayed with a white or gray border and become an in-box.

  2. Choose the required box from the "Box types" drop down menu.

To map a color to a new box type...

  1. Click on the color. This can be either a foreground or a background color. The current color will be displayed with a white or gray border and become an in-box.

  2. Click on the "New.." box types button.

  3. This will show the following dialog.

  4. Enter a symbolic name for the new box.

  5. Specify the foreground color for the new box.

  6. Specify the background color for the new box.

  7. Specify the box state for the new box.

  8. You can see a sample of the new box drawn containing today's date.

  9. Press OK to create a box.

  10. Once created a box type can be edited or deleted. It is not however possible to edit or delete the values of the default boxes. 

Other parameters

Enable 3D Boxes
This must be checked to enable the color to box mapping. If not checked, colors will never be mapped to boxes.
 
Enable 3D Lines
When checked, the emulator will draw the line drawing characters as 3D lines. If not checked, they will be drawn without highlight or shadow.
 
Enable Double Lines
When checked, the emulator will draw double-line line drawing characters. If not checked, the emulator will draw double-line line drawing characters as if they were single-line line drawing characters.

 

Mouse Support

A string can be configured for the different mouse actions. When the user performs a mouse action, the corresponding string will be sent to the host. The string may contain mnemonics and macros. There are special macros that only apply to mouse actions. An empty field will cause the specific action to be disabled. 

 

Disconnect

This screen determines what action is taken when a disconnect occurs. Different actions can be specified depending on if it were the host or the client that caused the disconnect.

 

Screen Dump

This screen controls the action performed by a screen dump. A screen dump action can be caused by the user clicking the Print button, or by executing the %printscreen% macro or by an escape sequence being sent from the host. 

 

Terminal Printing Setup

This screen controls the way that the emulator performs terminal printing. Terminal printing is when the host sends data directly to the clients printer. It is sometimes also referred to as pass-through printing. 

Each of the three supported printers can be configued as Raw or GUI.

Raw printing

When Raw printing is configured, the print output is sent directly to the specified Printer Name. This can be set to the name of a printer device or the name of a spool file. An optional Printer Command can be specified; this will be executed upon completion of the print spooling.

An example of using the lpr command on a Linux PC to print your job:
  Printer Name: spooler0.txt
  Printer Command: lpr -Phplaserjet spooler0.txt

An example of using a device on a Windows PC to print your job:
  Printer Name: \\SERVER1\HPLASERJET
  Printer Command: blank

A special program, anitaprint.exe, is provide to spool print jobs on Windows platforms. Other platforms can use their standard spoolers (such as lp or lpr on Linux and Solaris).

If the Printer Name is preceed by a @ then the first line of that file is used to specify the print output filename.

GUI printing

When GUI printing is configured, the print output is interpreted in order to create a Java GUI page and then this page is sent to the printer. The control codes are a limited subset of HPPCL. A default format for the GUI page can be configured.

 

Terminal Printing GUI

This screen controls the way that the emulator performs terminal GUI printing. It allows the user to configure the default format of the Java GUI page used for printing.

 

Button Panel

This screen controls the button panels above and below the AniTa terminal emulation window. You can configure a top button panel above the AniTa terminal screen and a bottom button panel below it.

Show border - Always
When selected, a border will always be shown permanently around all buttons in the button panels.
 
Show border - When mouse over
When selected, a border will only be shown around a button when the mouse is over the button. When the mouse enters a button the border will be drawn. When the mouse exits the button, the border will be removed.
 
Use Color and Color
When use color is not checked, the text in the button panels will be the default for that look-and-feel. If you check the Use Color box, then the text in the buttons will be displayed in the color specified.
 
Top Rows
Specifies the number of rows of buttons in the top button panel above the AniTa terminal screen. A value of zero will turn off the top button panel.
 
Top Columns
Specifies the number of buttons in each of the rows in the top button panel above the AniTa terminal screen.
 
Bottom Rows
Specifies the number of rows of buttons in the bottom button panel below the AniTa terminal screen. A value of zero will turn off the bottom button panel.
 
Bottom Columns
Specifies the number of buttons in each of the rows in the bottom button panel below the AniTa terminal screen.
 
Button Height
Adjust the height of the panel buttons.

 

Top And Bottom Buttons

There are two screens that configure the contents of the top and bottom button panels. 

To configure the contents of each button...

  1. Select the position of the button from the scroll box.

  2. Enter a symbolic name for the button (if required).

  3. Enter an icon to display in the button (if required).

  4. Enter the text to display in the button (if required). The text can start with <html> and then contain HTML tags to control the text display.

  5. Enter the the string to send when the button is pressed (if required). The string may contain mnemonics and macros. The "View predefined keys" and "View predefined macros" buttons can help with this task.

  6. Enter the tool-tip to display when the mouse is paused over the button (if required).

Note that a button without any icon or text values will create an empty space in the button panel.

 


Chapter 7: Running the Emulator

This chapter describes some of the special functions when running the AniTa for the Web emulator.

Connect / Disconnect

This button is used to connect or disconnect the session to the host. When connected it shows a green telephone and the text "disconnect"; pressing will disconnect the session. When disconnected it shows a red telephone and the text "connect"; pressing will connect to the host. When in the process of connecting, it shows a yellow telephone and the text "connecting"; pressing will have no effect.

Print Screen

This button is used to send the contents of the terminal screen to the printer.

Copy / Paste

These buttons are used to copy data to and from the clipboard. The copy button will copy data from the terminal screen to the clipboard; it is only enabled when an aera of the screen has been marked with the mouse. The paste button will paste data from the clipboard into the emulator as if it had been entered on the keyboard and thus send it to the host; it is only enabled when a session is active.

Config

This button is used to start the AniTa for the Web configuration program in a seperate Window. It is only enabled when running as an application, and cannot be used when running from the web (either using Web Start or as an applet). If the configuration file is changed, the terminal emulator must be restarted for it to take effect.

Record / Play

Sometimes when a problem occurs running an application in AniTa, the resolution can best be determined by creating a trace file. This trace file contains the all communications between the host computer and AniTa.

To record the communications in a trace file, press the record button. Enter the name of the file into which the session will be recorded; the default is janita.trc. The button will change to stop recording.

Connect to the host system and login. Start the application and reproduce the problem so that it appears on the screen.

Press the stop recording button. This trace file will contain all the characters and escape sequences sent by the host to AniTa and all the keyboard input sent by AniTa to the host.

If you are using this file to report a problem to support, please send the AniTa configuration file "janita.ini" as well as the "janita.trc" file. This will enable support staff to play back your recording, using you same configuration and see the problem as it appears on your screen. The Play button is used to play back a trace file.

File Transfer

The toanita application can be used to send files from a UNIX host to the client computer via the AniTa for the Web terminal connection. These can be binary files such as icons or text files.

The toanita file transfer protocol make file transfers easy to implement while still maintaining very high performance.
It has no error recovery. This means that if the transfer is interrupted, the file should be re-transmitted from beginning.
Host side software is free. It is available both in various host-side executales as well as in C-source code that compiles on all platforms.
Toanita can be downloaded from the AniTa Internet sample folder.

See ftp://ftp.aprilsystem.com/pub/anita/Sample/toanita/

To run this program enter the following command line from an AniTa terminal session:
toanita filename

Command line format:
toanita [options] unixfilename [pcfilename]

Options:
-a 1  enable acks, defaults to disabled.
-b size  block size, defaults to 2048. 
-H  when using AniTa in HP emulation mode. 
-h  show help information. 
-t  Text mode (converts lines ending with LF to CR LF). 

Examples:
toanita helpicon.bmp 
toanita payable.hot anita.hot  
toanita -t -b 1024 -a 1 file.txt file.text 


Chapter 8: Programmer's Guide

A programmer's guide for AniTa for the Web which includes programming tips and AniTa specific escape sequences is provided as a seperate document: janitaprog.html.