JAVA TERMINAL EMULATOR CONFIGURATION FILE

The configuration file for our Java-based terminal emulators is an ASCII file which should reside in the same directory as the program itself. Some tags are only applicable to certain emulation types. The contents are as follows:

 

REQUIRED ENTRIES

TAG

DESCRIPTION

FORMAT

 SAMPLE
 CUST  Customer Name  Text.  CUST "XYZ Corp"
 EXPMO  Month license expires  Numeric  EXPMO 12
 EXPYR  Year license expires  Numeric  EXPYR 2003
 USERS  Number of Users Licensed  Numeric  USERS 12
 SERIAL  Serial number (provided by Vendor)  Numeric  SERIAL 12345678

CONNECTION (FIRST 3 ARE REQUIRED IF NOT ON THE COMMAND LINE)

TAG

DESCRIPTION

FORMAT

 SAMPLE

 DEFAULT
 HOSTNAME  Name or IP address of the host computer Text HOSTNAME "hp.xyz.com"  
 PROTOCOL  Communications Protocol  NSVT/TELNET  PROTOCOL NSVT  TELNET
 PORT  TCP/IP Port to Connect To  Numeric  23
 KEEPALIVE  Send a keepalive packet every x seconds (NSVT Only)  Numeric  KEEPALIVE 60  Disabled
 IDSTRING  Name of the terminal emulated, as reported to Telnet and when an HP hosts asks for the terminal ID  Text  IDSTRING vt220  depends on emulation
 LOGINCHAR  Character used by the host to trigger logging in  Text  LOGINCHAR :  depends on emulation
 LOGIN  String to send the first time the loginchar is received  Text  LOGIN HELLO MGR.XXX  
 LOGIN1  String to send the second time the loginchar is received  Text  LOGIN1 SECRET  
 LOGIN2  String to send the third time the loginchar is received  Text  LOGIN2 MORESECRET  
 LOGIN3  String to send the fourth time the loginchar is received  Text  LOGIN3 PROGTORUN  
 ENCRYPT  Turn on encryption (requires encryption server). Not available with class libraries.  ON/OFF  ENCRYPT ON  OFF
  TRIPLEDES   Use Stronger Encryption  ON/OFF   TRIPLEDES ON   OFF
 HOSTCHARS  Use a translation table for characters transmitted  Text  HOSTCHARS GERMAN.TBL  
 PCCHARS  Use a translation table for characters received  Text  PCCHARS GERMAN.TBL  

SCREEN FORMATTING

TAG

DESCRIPTION

FORMAT

 SAMPLE

 DEFAULT
 ROWS  Screen Rows (not including function keys or status)  Numeric  ROWS 24  24
 COLUMNS  Screen Columns  Numeric  COLUMNS 132  80
 SCREEN80  Font to use in 80 column mode   See Separate Description  Calculated
SCREEN132  Font to use in 132 column mode   See Separate Description    Calculated
 VSCROLL80  Display a vertical Scroll Bar in 80 column Mode  ON/OFF  SCREEN80 OFF  ON
 VSCROLL132  Display a vertical Scroll Bar in 132 column Mode  ON/OFF  SCREEN132 OFF  ON
 HIDEFKEYS  Do not display the function key labels  ON/OFF  HIDEFKEYS ON  OFF
USERKEYS  Show the User Defined Function Keys on Startup  ON/OFF  USERKEYS ON  OFF (show MODES keys)
 UNDERLINE  How to show underlined characters  BOLD/ITALIC  UNDERLINE BOLD  BOLD
 BLINK  How to show blinking characters  BOLD/ITALIC  BLINKING BOLD  ITALIC
 FGCOLOR  Foreground color for the specified attribute  See below    
 BGCOLOR  Background color for the specified attribute  See below    
 CENTERING Whether to center the text portion of the screen  ON/OFF  CENTERING OFF  ON
 BUFFERTEXT  Buffer text for writing to screen. Usually improves performance ON/OFF  BUFFERTEXT ON  OFF
 BLOCKCURSOR  Use a block cursor instead of underline curson  ON/OFF  BLOCKCURSOR ON  OFF
 SCRDELAY  Insert a forced delay after changing screen size (needed for some platforms such as Sun Workstations)  Numeric (milliseconds)  SCRDELAY 200  None
 SCREENROWS  Used to indicate to Proxy92 how many screen rows are available on the target VT terminal. The ideal is 27, if the terminal can be configured to display 27  Numeric  SCREENROWS 27  24

KEYBOARD

TAG

DESCRIPTION

FORMAT

 SAMPLE

 DEFAULT
 MAP  Map a Key to a character or String  See Section Below    
 RETENTER  Map the Return key to the Enter Key always  ON/OFF  RETENTER ON  OFF
 BLOCKENTER  (HP only) Map the Return key to the Enter Key when in Block Mode  ON/OFF  BLOCKENTER ON  OFF
 FKEY  Define a Function Key (HP MODE)   See Separate Description
ENTERCLRMSG  (HP Only) Pressing Enter clears any alert message displayed   ON/OFF  ENTERCLRMSG ON  OFF
 TYPEAHEAD  Turn on Typeahead  ON/OFF  TYPEAHEAD ON  OFF
 DESTRBS  Turn on destructive backspace  ON/OFF  DESTRBS ON  OFF

PRINTER

TAG

DESCRIPTION

FORMAT

 SAMPLE

 DEFAULT
PRINTER LANDSCAPE  Landscape Mode  None  PRINTER LANDSCAPE  PORTRAIT
 PRINTER COLUMNS Number of columns the printer can print  Numeric  PRINTER COLUMNS 80 80
 PRINTERFONT  Name of the printer font to use  Text  PRINTERFONT arial  
 PRINTER BOLD  Print in Bold Face   ON/OFF PRINTERBOLD ON OFF
 PRTIME Start printing after this period of inactivity  Numeric  PRTIME 200  

HP SPECIFIC SETTINGS

TAG

DESCRIPTION

FORMAT

 SAMPLE

 DEFAULT
 STRAP  Turn on an HP strap as defined in the terminal manual  STRAP {strap} ON/OFF  STRAP G ON  All Off
 FTPROG  Specify the name of the host file transfer program  Text  FTPROG WS92.PUB.SYS  
 FTASCII  Default to ASCII file transfer  ON/OFF  FTASCII ON OFF
 UPLOADCHARS  Specifies a translation table for characters uploaded by the file transfer component (when available)   Text UPLOADCHARS GERMAN.TBL None
 DOWNLOADCHARS  Specifies a translation table for characters downloaded by the file transfer component (when available)  Text  DOWNLOADCHARS FRENCH.TBL  None
 COMPCODES  Used to turn off sending completion codes in response to certain terminal control commands  ON/OFF  COMPCODES OFF  ONN
 SER9  String to return when host software that is written for a WRQ terminal emulator asks for a 9 digit serial number  Text  SER9 123456789  
 SER14  String to return when host software that is written for a WRQ terminal emulator asks for a 14 digit serial number  Text  SER14 ABCDE123456789  

DEBUGGING

TAG

DESCRIPTION

FORMAT

 SAMPLE

 DEFAULT
 TRACE  Causes extra information to be written to the console  ON/OFF  TRACE ON  OFF
 EVTFILE  Turns on capturing events to a file  Text  EVTFILE "C:\\CAP.EVT"  None
 PACKFILE  Turns on capturing network packets to a file   Text PACKFILE "C:\\CAP.WPK" None
 PLAYFILE  Specifies a previously recorded event trace file to playback  Text  PLAYFILE "C:\\CAP.EVT"  None

TRANSLATION TABLES

 A translation table is a 256 byte binary file that specifies which character each character from 0 to 255 should be mapped to. The primary use is to enable the correct display of non-English characters. HOSTCHARS specifies how characters typed will be transmitted to the host. PCCHARS specifies how characters received from the host will be displayed.

For example, to map A to B, so that when A is typed B is sent, offset 65 in the file (corresponding to ASCII 'A') would contain the number 66 (ASCII 'B'). Translation tables are mainly used to support non-English character sets, and are optional.

In IBM emulations the translation tables provided by us are required, in order to translate between ASCII and EBCDIC.

MAPPING KEYS

 The MAP command enables you to map specified keys to perform specified functions.

The format is MAP{fromkey} TO [operator] {tokey, string, action}

fromkey specifies the key you are remapping. It can have one of the following formats

  • The actual letter preceded by one or more of ALT SHIFT CTRL. For example to map the combination produced by holding down the Alt key and pressing the C key, use "ALT C"
  • A key name. Valid key names are: "UP", "DOWN", "LEFT", "RIGHT",
    "INS", "DEL",
    "PAGEUP", "PAGEDOWN",
    "HOME", "END", "TAB",
    "F1", "F2", "F3", "F4","F5","F6","F7","F8","F9", "F10","F11","F12",
    "NUMLOCK", "MULTIPLY", "DIVIDE", "SUBTRACT", "ADD"};

operator can be one of the following:

  • CHAR - map to the following character
  • KEY - map to the following key name. Valid key names are: "PRINT", "ENTER", "RETURN",
    "SELECT", "TAB", "BACKTAB",
    "HOMEUP", "HOMEDOWN", "UP", "ROLLUP", "DOWN", "ROLLDOWN","RIGHT", "LEFT","PAGEDOWN", "PAGEUP",
    "CLEARLINE", "CLEARSCREEN",
    "INSERTLINE", "INSERTCHAR", "REMOVELINE",
    "DELETECHAR", "STOP", "BREAK",
    "HARDRESET", "SOFTRESET", "SYSTEM",
    "USER", "MENU", "USERMENU",
    "BACKSPACE", "DELETE", "F1", "F2", "F3", "F4",
    "F5", "F6", "F7", "F8", "COMMA", "INSERTWRAP", "DELETEWRAP", "FIND", "INSERT", "REMOVE", "NUM0", "NUM1", "NUM2", "NUM3", "NUM4", "NUM5", "NUM6", "NUM7", "NUM8", "NUM9", "MINUS", "PERIOD", "PF1", "PF2", "PF3", "PF4", "F9", "F10", "F11", "F12", "F13", "F14", "F15", "F16", "F17", "F18", "F19", "F20",
    "SHIFTF6", "SHIFTF7", "SHIFTF8", "SHIFTF9", "SHIFTF10","SHIFTF11", "SHIFTF12","SHIFTF13","SHIFTF14","SHIFTF15","SHIFTF16","SHIFTF17",
    "SHIFTF18","SHIFTF19","SHIFTF20", "WIDTHTOGGLE"};
  • STRING - map the the following String. For example: MAP CTRL A TO STRING "hello mgr.dev"
  • DECIMALS - map to a string consisting of the following characters defined in ASCII. For example MAP SHIFT F10 TO DECIMALS 13 10

 

DEFINING FUNCTION KEYS

You can define a function key for HP terminal emulation by using the FKEY command. The syntax is

FKEY {keynum (1 to 8) {attribute} {label} {string}

The attribute is the attribute character used by HP terminals. N means Normal, T means Transmit Only, and L means Local

Example: FKEY 1 N "STATUS" "SHOWME"

SPECIFYING COLORS

The FGCOLOR and BGCOLOR commands are used to map certain screen attributes or attribute combinations to colors. For example, to display inverse text as red foreground on light gray background use:

FGCOLOR INVERSE "red"

BGCOLOR INVERSE "lightgray"

Valid color names are: black, blue, darkgray, gray, green, lightgray, magenta, orange, pink, red, white, yellow, darkblue, darkgreen, darkcyan, darkred, darkpurple

Valid attribute names are:

NORMAL, BLINK, BLINK_INVERSE, UNDERLINE, BLINK_UNDERLINE, INVERSE_UNDERLINE, BLINK_INVERSE_UNDERLINE, HALFBRITE, HALFBRITE_BLINK, HALFBRITE_BLINK_INVERSE, HALFBRITE_UNDERLINE, HALFBRITE_BLINK_UNDERLINE, HALFBRITE_INVERSE_UNDERLINE, HALFBRITE_BLINK_INVERSE_UNDERLINE, BOLD, BOLD_BLINK, BOLD_BLINK_INVERSE, BOLD_UNDERLINE, BOLD_BLINK_UNDERLINE, BOLD_INVERSE_UNDERLINE, BOLD_BLINK_INVERSE_UNDERLINE

The HP terminal can display normal and halfbright. Other terminals display normal and bold. You don't need to specify colors for bold attributes for HP applications, or colors for half bright for IBM or VT applications.

 

 

BACK TO TOP

HOME