contents / Chapter 4Chapter 6

CHAPTER 5 5250 CONFIGURATION FILE OPTIONS

This chapter describes 5250 Configuration File Options, while Chapter 6 describes the configuration file options which are common for VT and 5250. 

5.I Features and syntax

WTn configuration file is a text file containing the configuration values for WTn options and several keyboard sequences generated by the terminal. Some of these values can be dynamically modified by the Host system. The name of this file is always "_WTn52.Cfg". It's recommended to modify it only with IniEditor, an application included in the installation procedure.

WTn configuration file is a "Windows dot-ini-Like" text file which includes:

The lines in the configuration file must be: Printer Header, Comments, Sections, Keys + Values or empty lines.

5.I.1 Sections

Sections group the option keys and values. Section names are in capital letters and between square brackets. e.g.: [TELNET], denotes the Telnet section.
The order of the sections in the file is not relevant.

5.I.2 Keys

Keys are keywords that make sense only inside their own section, so they can't be moved from one section to another. Using lowercase or uppercase is not relevant for keywords, but it may be useful to make them more readable. Keys must be followed by "=" sign and the value of the parameter, e.g. LocalBeeps=Yes.

5.I.3 Values

Values follow the keys and the "=" sign. Each parameter expects the value in a fixed format (indicated with the parameter definition in the form "<format>"). Values may be empty in some cases.

Formats are:

<Yes/No>
Needs a Yes or No value.

<string / xxxx>
Text ASCII characters, delimited or not by the " (inverted commas) character. If the string is delimited by ", the spaces (20h) are preserved, otherwise they are ignored. xxxx indicates the units or the meaning of the value.

<hex-string>
On this format, three characters represent one final character.
There are three ways to supply "hex-strings" (each target character takes always 3 source characters):

Mnemonic Format Description
"Escaped" "/HH" A slash ("/" or "\") and a two-digits hexadecimal value, e.g. \1B for character 27.
"Numeric" "999" Three decimal digits, e.g. 065 for character "A".
"Alphabetic" "..A" Two dots and one alphabetic character, e.g. ..X for character "X".

Hex-strings may be delimited by " to be more readable.

<num / xxxx>
Decimal numeric value (0 - 9). xxxx indicates the units or the meaning of the value.

<word>
Hexadecimal value, four-digits. E.g.: A50F.

<uppercase letter>
A single uppercase character. E.g.: N.

5.II Sections

[TN52_TELNET]
This section groups the features for the Telnet level negotiation and options, and network features.
[TN52_EMULATION]
This section groups the Terminal emulation level features.
[TN52 LOGIN X]
Automated Login Options (Sign In) for host connection with automatic response of user name and password to the host login and optional Program, Menu and Library entries if necessary.
[TN52_AID_KEYS]
This section groups the functions that send the input data and an AID code  to the host.
Each function is associated to a configurable keyboard scan-code. Functions are not configurable, but the keyboard is.
[TN52_AID_PF1_KEYS]
This section groups the F1-F12 AID+data functions.
[TN52_AID_PF2_KEYS]
This section groups the F13-F24 AID+data functions.
[TN52_SIGNAL_KEYS]
The signal keys send a signal frame w/o data or AID code.
[TN52_CONTROL_KEYS]
These functions perform Local processing, and sometimes send AID codes and input data.
[TN52_CURSOR_KEYS]
Local Cursor Movement Keys.
[TN52_ERROR_MSG]
This section groups the options that control the behavior of the terminal when an error occurs and the way to handle the user message line.
[TN52_BARCODES]
This section groups the emulation options for Barcode reading.
[TN52_PRINT_DATA]
This section groups the options of the display-to-printer system.
[TN52 KEYMAP]
This section allows to map a keystroke scan code into another.

5.III [TN52_TELNET] Section

This section groups the features for the Telnet level negotiation and options, and network features. Telnet protocol has "Options" that can be negotiated between client (WTn) and Host computer.

TelOpEchoHost=<Yes/No>
(Telnet Option) During telnet connection negotiation, the terminal sends (=Yes) or not (=No) a request to ask the host to do "remote echo". Avoid in 5250.

TelOpBinHost=<Yes/No>
(Telnet Option) During telnet connection negotiation, the terminal sends (=Yes) or not (=No) a request to ask the host to perform a "binary" connection. (The host may send characters from 00h to FFh). Needed for 5250.

TelOpBinTerm=<Yes/No>
(Telnet Option) During telnet connection negotiation, the terminal sends (=Yes) or not (=No) a request to the Host indicating that the terminal wants to perform a "binary" connection. (The terminal may send characters from 00h to FFh). Needed for 5250.

TelOpEorHost=<Yes/No>
(Telnet Option) During telnet connection negotiation, the terminal sends (=Yes) or not (=No) a request to the Host asking him to send "End Of Record" tags. Needed for 5250.

TelOpEorTerm=<Yes/No>
(Telnet Option) During telnet connection negotiation, the terminal sends (=Yes) or not (=No) a request to the Host indicating that the terminal wants to send "End Of Record" tags. Needed for 5250.

TelOpSgaHost=<Yes/No>
(Telnet Option) During telnet connection negotiation, the terminal sends (=Yes) or not (=No) a request to the Host to suppress the "Go Ahead" system.

TelOpSgaTerm=<Yes/No>
(Telnet Option) During telnet connection negotiation, the terminal sends (=Yes) or not (=No) a request to the Host indicating that the terminal wants to suppress the "Go Ahead" system. (Terminal never sends "Go Ahead" signal).

TelOpNawsTerm=<Yes/No>
(Telnet Option) During telnet connection negotiation, the terminal sends (=Yes) or not (=No) a request to the Host indicating that the terminal wants to Send NaWS (Window Size). Set this option to =Yes only if the host really needs terminal window size information.

TelOpEnvTerm=<Yes/No>
(Telnet Option) During telnet connection negotiation, the terminal sends (=Yes) or not (=No) a request to the Host indicating that the terminal wants to send environment variables (see Dev Name=).
Set this option to =Yes only if the host really needs terminal environment information.

TelOpTTypeTerm=<Yes/No>
(Telnet Option) During telnet connection negotiation, the terminal sends (=Yes) or not (=No) a request to the Host indicating that the terminal wants to send the Terminal Type (what kind of terminal is connected) information to the host. (If =No, no terminal type information is sent to the host and the emulation performed by WTn is the one indicated on TTypePreferred).

DoTcpAlive=<Yes/No> 
Yes = WTn periodically pings (Telnet Ping - Timing Mark) the Host to test the TCP connection state.

DoPingToHost=<String>
Yes=WTn periodically sends an ICMP to Host (RFC792).

Passive=<Yes/No>
Yes=WTn waits for telnet host commands.
No=WTn sends telnet commands to host.

5.IV [TN52_EMULATION] Section

This section groups the Terminal emulation level features, and the way WTn handles some emulation features.

Bold= <Yes/No>
Yes=Map bold character attribute to reverse  video.
No=Ignore this attribute.

Column=<Yes/No>
Yes=Map Column separator character attribute to reverse video.
No=Ignore this attribute.

Blink=<Yes/No>
Yes=Map blink character attribute to reverse  video.
No=Ignore this attribute.

Caps=<Yes/No>
Yes=Force the keyboard to uppercase.
No=Let the keyboard "as is".

Lower=<Yes/No>
Yes=Force the keyboard to lowercase.
No=Let the keyboard "as is".

HostBeeps=<Yes/No>
Yes=Makes a beep when the order from the host is received.

TermWidth=<num / columns>
Logical width of the emulated screen in columns. 0=uses default (80). 80 max.

TermHeigth=<num / lines>
Logical height of the emulated screen in lines. 0=uses default (24). 25 max.

FreeCursor=<Yes/No>
No=Cursor moves only in input fields.
Yes=Cursor moves on all the display area, following host configuration (by SOH flag, byte 1, bit 3).

SetKbdOnNum=<num / 0-1>
When entering in numeric fields (Num-shift, Numeric-Only, Digits-Only and Signed-Numeric), set the keyboard shift to this position:
0=Do not change into Numeric state.
1=Change keyboard into Numeric state.
Only for SYMBOL/MOTOROLA terminals.

SetKbdOnAlpha=<num / 0-1>
When entering in alphabetic fields (Alpha-shift, Alpha-Only), set the keyboard shift to alpha mode.
0=Do not change into Alpha state.
1=Change keyboard into Alpha state.
Only for SYMBOL/MOTOROLA terminals.

CodePage=<string / name>
Translation table used to translate form/to IBM charmaps and ISO 8859_1 PDA font.
Available charmap tables are:
"37"= IBM037 Charmap, USA, Can, Netherlands, Portugal, Brazil, Austria.
"273"=IBM273 Charmap, Austria, Germany.
"277"=IBM277 Charmap, Denmark, Norway.
"278"=IBM278 Charmap, Finland, Sweden.
"280"=IBM280 Charmap, Italy.
"284"=IBM284 Charmap, Catalan, Spain, Latin America.
"285"=IBM285 Charmap, UK, Ireland.
"297"=IBM297 Charmap, France.
"500"=IBM500 Charmap, Ebcdic 500 V1 (?).
"871"=IBM871 Charmap, Iceland.
"1025"=IBM1025 Charmap, Cyrillic.
"1147"=IBM1147 Charmap, France, multilingual.

DoMandEnter=<Yes/No>
Yes=Check MDT (Modified Data Tag) in the fields having Mandatory Enter attribute before sending.
No=Do not check.

DoMandFill=<Yes/No>
Yes=Perform mandatory field fill check before sending.
No=Do not check.

SaveFmtTable=<Yes/No>
Yes= Save the format table.
No= Do not save the format table. 

DestBksp=<Yes/No>
Yes= Delete the chars while moving backwards.
No= Do not delete the chars while moving backwards.

DoFer=<Yes/No>
Yes= Process the "Field Exit Required" flag in fields.
No= Do not process.

DragDisplay=<Yes/No>
Yes=Allow to drag display by touch screen.
No=Display does not moves by touch screen.

DisplayMono=<Yes/No>
Yes=Monochrome display (black / white).
No=Color display.

DefFrgColor=<Black/Blue/Green/Cyan/Red/Magenta/Brown/White>
Foreground color for the display.

DefBkgColor=<Black/Blue/Green/Cyan/Red/Magenta/Brown/White>
Background color for the display.

CursorByTap=<Yes/No>
Yes=Cursor positioning in field by touch screen.
No=No cursor motion by touch screen.

FunctionByTap=<Yes/No>
Yes=generates the corresponding function key when clicking on any text as "Fx" on the display by touch screen.
No=Do not generate function keys by touch screen.

XSTimeOut=<num / seconds>
Time waiting (in seconds) for Host response in XS (X System) mode before aborting the session.
0 seconds means infinite waiting (end session by control-x).

EndScanCode=<word / scancode>
Scan code of the key that ends the current Telnet session.

CheckFnKeys=<Yes/No>
Yes=Function keys are checked before sent if allowed on this screen.
No=All function keys are sent w/o check.
If not allowed, the message FUNCTION KEY NOT ALLOWED appears.

ClearFieldByFE=<Yes/No>
Yes=When Field-Exit key is pressed, the field is entirely cleared even if not modified by user.
No=The field is cleared (after cursor position) only if modified by user.

CursorKbdState=<Yes/No>
Yes=The shape of the blinking cursor shows the keyboard state (unshift, shift, control, function, alpha).
No=The cursor blinks in reverse colors.

AutosendIfHgLg=
Performs an Autosend (as if the ENTER key was pressed) if any Highlight field is filled (3270 Only).
No=Do not perform this function.

AutosendAtLast=
Performs an Autosend (as if the ENTER key was pressed) if the last field in form is filled (3270 Only).
No=Do not perform this function.

DoubleTap=
Keyboard Scan Code sent if the user clicks twice (double tap) in the touch screen.
Special double tap scan code. This is useful for displaying the SIP Panel (see SipScanCode).

SipScanCode=
Scan Code of the key used to activate the SIP Panel (keyboard)
It is convenient to set the same scan code as in DoubleTap, this way, the SIP Panel will appear/hide at double click.

5.V [TN52_LOGIN_X]

These sections (_0 to _3) group the Telnet specific Automated Login Options (Sign On) for host connection with automatic response of user name and password to the host login, and optional Program, Menu and Library entries if necessary.

Auto
Yes=Perform auto login to host when SESSION_X connects.
No=Do not perform auto login.

User
Username. Mandatory.

Password
Password. Mandatory.

Program
Optional

Menu
Optional

Library

Optional

5.VI [TN52_AID_KEYS] Section

This section groups the functions that send the input data and an AID code to the host.
Each function is associated to a configurable keyboard scan-code.
Keyboard type and size vary from terminal to terminal. Thus, you may need to set these functions to available keys on your keyboard.
Functions are not configurable, but the keyboard is.

Clear=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

Enter=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

Help=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

RollDown=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

RollUp=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

RollLeft=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

RollRight=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

Print=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PA1=<word / scan-code>
Program Access 1 (3270). Set the scan code of the KEY that will perform the FUNCTION.

PA2=<word / scan-code>
Program Access 2 (3270). Set the scan code of the KEY that will perform the FUNCTION.

PA3=<word / scan-code>
Program Access 3 (3270). Set the scan code of the KEY that will perform the FUNCTION.

5.VII [TN52_AID_PF1_KEYS] Section

This section groups the F1-F12 AID+data functions.

PF01=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF02=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF03=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF04=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF05=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF06=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF07=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF08=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF09=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF10=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF11=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF12=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

5.VIII [TN52_AID_PF2_KEYS] Section

This section groups the F13-F24 AID+data functions.

PF13=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF14=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF15=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF16=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF17=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF18=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF19=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF20=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF21=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF22=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF23=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

PF24=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

5.IX [TN52_SIGNAL_KEYS] Section

Signal keys send a signal frame w/o data or AID code.

Attention=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

Help=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

SysReq=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

TestReq=<word / scan-code>
Set the scan code of the KEY that will perform the FUNCTION.

5.X [TN52_CONTROL_KEYS] Section

This functions perform local processing, and sometimes send AID codes and input data.
See Appendix A for a detail of terminal functions.

BkSp=<word / scan-code>
Back Space. Moves cursor one column left.
Set the scan code of the KEY that will perform the FUNCTION.

Dup=<word / scan-code>
Duplicate. Fills the remain of field with "dup" characters.
Set the scan code of the KEY that will perform the FUNCTION.

FieldPlus=<word / scan-code>
Field Plus. On signed numeric fields, puts a positive sign, and performs a field exit function. On other fields, performs a field exit function.
Set the scan code of the KEY that will perform the FUNCTION.

FieldMinus=<word / scan-code>
Field minus. On numeric and signed numeric fields, puts a negative sign, and performs a field exit function.
Not allowed on other fields.
Set the scan code of the KEY that will perform the FUNCTION.

FieldExit=<word / scan-code>
Performs pad and adjust functions and moves to the next field.
Set the scan code of the KEY that will perform the FUNCTION.

Delete=<word / scan-code>
Deletes one character under the cursor. Moves the rest of the field one position left.
Set the scan code of the KEY that will perform the FUNCTION.

EraseInput=<word / scan-code>
Erase input function. Clears all modified fields.
Set the scan code of the KEY that will perform the FUNCTION.

ErrorReset=<word / scan-code>
Resets the" X Input Inhibit" (X II) indicator. Puts the terminal in not-error state.
Set the scan code of the KEY that will perform the FUNCTION.

Home=<word / scan-code>
Moves the cursor to home position (usually the first field).
If already in home position, sends an AID "record-backspace" code.
Set the scan code of the KEY that will perform the FUNCTION.

Insert=<word / scan-code>
Toggles the insert/replace mode.
Insert: When data input, moves the following characters one position further (if possible) and inserts the keyed character.
Replace: When data input, puts the keyed character at cursor position (overwriting the previous character).
Set the scan code of the KEY that will perform the FUNCTION.

ForwTab=<word / scan-code>
Moves the cursor to the next field.
Set the scan code of the KEY that will perform the FUNCTION.

BackTab=<word / scan-code>
Moves the cursor to the previous filed.
Set the scan code of the KEY that will perform the FUNCTION.

End=<word / scan-code>
Moves the cursor to the last data position of the field.
Set the scan code of the KEY that will perform the FUNCTION.

EraseEof=<word / scan-code>
Erase (null) all characters located at right of cursor position.
Set the scan code of the KEY that will perform the FUNCTION.

FieldMark=<word / scan-code>
3270, Same as Dup.
Set the scan code of the KEY that will perform the FUNCTION.

CursorSelect=<word / scan-code>
Not implemented.

5.XI [TN52_CURSOR_KEYS] Section

Local Cursor Movement Keys.

CursorUp=<word / scan-code>
In FreeCursor=Yes, moves cursor one line Up.
In FreeCursor=No, moves cursor to previous field.
Set the scan code of the KEY that will perform the FUNCTION.

CursorDown=<word / scan-code>
In FreeCursor=Yes, moves cursor one line Down.
In FreeCursor=No, moves cursor to next field.
Set the scan code of the KEY that will perform the FUNCTION.

CursorLeft=<word / scan-code>
In FreeCursor=Yes, moves cursor one column left.
In FreeCursor=No, moves cursor one column left; if beginning of field, to previous field.
Set the scan code of the KEY that will perform the FUNCTION.

CursorRight=<word / scan-code>
In FreeCursor=Yes, moves cursor one column right.
In FreeCursor=No, moves cursor one column right; if end of field, to next field.
Set the scan code of the KEY that will perform the FUNCTION.

5.XII [TN52_ERROR_MSG] Section

This section groups the options that control the terminal behavior when an error occurs and the way to handle the user message line.

BeepOnError=<Yes/No>
Yes=Beep when an error occurs.

ResetByEnter=<Yes/No>
Restore the terminal to non-error state (see ErrorReset function).
Yes=Reset by ENTER key.

ResetByAny=<Yes/No>
Restore the terminal to non-error state (see ErrorReset function).
Yes=Reset by any key.

ResetTime=<num / seconds>
Restore the terminal to non-error state (see ErrorReset function).
Auto-Reset error after x seconds.
0=Do not perform auto-reset.

NoMsgLine=<Yes/No>
Yes= Don't show the user error message line on the PDA display on "floating" mode.
No= Show the user error message line on the PDA display on "floating" mode.

5.XIII [TN52_BARCODES] Section

This section groups the emulation options for Barcode reading.

ClearField=<Yes/No>
Yes=Clears the present field (the one under the cursor) in barcode readings.
No=Append the barcode data at the present cursor position.

EmbeddedAid=<Yes/No>
The barcode may contain AID embedded codes.
Yes=Handle embedded AID codes after ESC character.
No=send barcode "as is".

The barcode has this form: <data><esc><aid>
<data>=Normal data.
<esc>=Special separator character (see EscapeForAid).
<aid>=AID function to perform after barcode:
'A'=AID F1
'B'=AID F2
'C'=AID F3
'D'=AID F4
'E'=AID F5
'F'=AID F6
'G'=AID F7
'H'=AID F8
'I'=AID F9
'J'=AID F10
'K'=AID F11
'L'=AID F12
'M'=AID F13
'N'=AID F14
'O'=AID F15
'P'=AID F16
'Q'=AID F17
'R'=AID F18
'S'=AID F19
'T'=AID F20
'U'=AID F21
'V'=AID F22
'W'=AID F23
'X'=AID F24
'0'=AID ENTER
'1'=AID CLEAR
'2'=AID PGDN
'3'=AID PA1
'4'=AID PA2
'5'=AID PA3

EscapeForAid=<hex-string / character>
Character separator for "AID" keystroke.
On this format, three characters represent one final character.
There are three ways to supply "hex-strings" (each target character takes always 3 source characters):
"Escaped", "/HH". A slash ("/" or "\") and a two-digits hexadecimal value. e.g. \1B for character 27.
"Numeric", "999". Three decimal digits. e.g. 065 for character "A".
"Alphabetic", "..A". Two dots and one alphabetic character. e.g. ..X for character "X

BcInField=<char / tag>
T=Oversized barcodes are Truncated.
S=Oversized barcodes are Split in several fields (if possible).
R=Oversized barcodes are Rejected.
E=Allows only barcodes that match Exactly the size of the field.

WarnTrunc=<Yes/No>
Perform a warning (beep) when truncating a barcode.

PostAction=<num / Action>
'A'=F1
'B'=F2
'C'=F3
'D'=F4
'E'=F5
'F'=F6
'G'=F7
'H'=F8
'I'=F9
'J'=F10
'K'=F11
'L'=F12
'M'=F13
'N'=F14
'O'=F15
'P'=F16
'Q'=F17
'R'=F18
'S'=F19
'T'=F20
'U'=F21
'V'=F22
'W'=F23
'X'=F24
'0'=ENTER
'1'=CLEAR
'2'=PGDN
'3'=PA1
'4'=PA2
'5'=PA3
'6'=Field Exit
Empty=No action 

5.XIV [TN52_PRINT_DATA] Section

This section allows to send data to an attached printer, via display screen commands, following the "Print Display Data" process described below:
If On, WTn looks for StartPrintId in the display area at IDRow and IDCol position.
If found, the text between StartPrintId and StopPrintId (or end of screen) is sent to the serial printer attached to the terminal (following printer configuration).
The whole text to print on a label must fit in a single screen.

The following conversions are performed:

On=No
Does not perform "Print Display Data" processing.

StartPrintId=<string / pattern>
Pattern to match when printing data ("PRN:"). Start print tag. The data between start and stop print tags are sent to the printer.

StopPrintId=<string / pattern>
Pattern to match when printing data (":PRN"). Stop print tag. The data between start and stop print tags are sent to the printer.

IDRow=<number / row>
Row where to look for the start print ID.
Start at 1.

IDCol=<number / column>
Column where to look for the start print ID.
Start at 1.

NullToSpace=Yes
Performs null to space conversion before performing the EBCDIC to ASCII conversion.
If Yes, the null characters are sent to the printer as spaces.
If No, the null characters are not sent.

EscapeChar=<hexstring / character>
ASCII character to look for in printer stream to perform character conversions.
For no "escape" conversion, use 000 or /00.
The character following the "EscapeChar" is converted to a control character and sent to the printer, following the syntax detailed below:

<EscapeChar><Char to Convert>
<Char to Convert> should not be equal to <EscapeChar>.
The character following EscapeChar (Char to Convert) is converted into ASCII and then into a "control character" by subtracting 64.
"\@"=0x00,"\A"=0x01, "\B"=0x02, "\C"=0x03, ..., "\Z"=0x1A, "\["=0x1B, "\]"=1D, "\^"=0x1E, "\_"=0x1F, "\`"=0x20, "\a"=0x21, "\b"=0x22, ..., "\z"=0x3A.

<EscapeChar><EscapeChar>
To send an "EscapeChar", print it twice (the escape char is sent 1 time).
"\\"=0x5C.

<EscapeChar><#><99>
If the character following EscapeChar is "#", the two hex-digits (0 - F) are converted into a single hex character of control.
"\#1C"=0x1C, "\#00"=0x00, "\#FF"=0xFF.

For characters over 0x7F, check if the serial link to the printer is configured in 8 bits mode.

5.XV [TN52_KEY_MAP] Section

This section allows to map a keystroke scan code into another. Use this feature to translate data keys.

--- To change a scan code into another:
1) Go to (CONFIGURE)/(Keyboard Test) menu.
2) Press the KEY and get the four digits Scan Code.
3) Set the scan code for the desired FUNCTION on this configuration file.
4) Download the configuration file to the terminal.

MapX=<scancodes / scancodes>
Couple of Scan Codes (separated by /).
To map "." dot as "," comma set Map00=002E/002C.

contents / Chapter 4Chapter 6