Contents / CHAPTER 4 / CHAPTER 6
The WT configuration file is a text file containing the default values for the WT options and several keyboard sequences generated by the terminal. Some of those values could be dynamically modified by the Host system. The name of this file is always "_WTn52.Cfg".
The WT configuration file is a "Windows dot-ini-Like" text file, with sections, keys and values.
Configuration file includes :
Lines in configuration file must be : Printer Header, Comments, Sections, Keys + Values or empty lines.
Comments in WT configuration file are indicated by two "slash"
characters and takes effect to the end of the line. i.e.. :
// This is a comment
This is not a comment (must be a section, a key + value or an empty line)
Section groups the options keys and values. Section names are in capital
letters surrounded by brackets. i.e. : [TELNET], denotes the Telnet section.
The order of the sections into the file is no relevant.
are keywords that have sense into their own section, and can't be moved from one section to another. Case (lowercase or uppercase) is not relevant for keywords, but are more readable... Keys must be followed by "=" sign and the value of the parameter. i.e. : LocalBeeps=Yes.
Values follow the keys and "=". each parameter expects the value in a fixed format (indicated with the parameter definition like "<format>"). Values may be empty in some cases.
Formats are :
<Yes/No>
Needs Yes or No value.
<string / xxxx>
Text ASCII characters, delimited or not by " character. If the
string is delimited by ", the spaces (20h) are preserved, otherwise
are ignored. xxx indicates the units or the meaning of the value.
<hex-string>
In this format, three characters represents one final character.
There is three ways to supply "hex-strings" (each target character takes
always 3 source characters) :
| Mnemonic | Format | Description |
|---|---|---|
| "Escaped" | "/HH" | An slash ("/" or "\") and a two-digits hexadecimal value. i.e.: \1B for character 27. |
| "Numeric" | "999" | Three decimal digits. i.e.: 065 for character "A". |
| "Alphabetic" | "..A" | Two dots and one alphabetic character. i.e. : ..X for character "X" |
Hex-strings may be delimited by " to be more readable.
<num / xxxx>
Decimal numeric value (0 - 9). xxx indicates the units or the meaning of the
value.
<word>
Hexadecimal four-digits value. i.e.: A50F.
<uppercase letter>
One uppercase character. i.e.: N.
[DOWNLOADS]
This section allows to configure the associated files for download.
[TERMINAL]
This section groups the PDT-specific features.
[SESSIONS]
This section allows to configure the host sessions available for the user.
[SESSION_X]
This sections (_0 to _3) groups the Telnet connection options specific for
each session.
[TELNET]
This section groups the features for the Telnet level negotiation and options
and network features.
[EMULATION]
This section groups the Terminal emulation level features.
Keyboard Sections
This section groups the functions that sends to the host the input data and
an AID code.
Each function is associated to a configurable keyboard scan-code.
Functions are not configurable, but keyboard is.
You can see the scan code for each key in the terminal
by "[F4] See Options / [F1] FN KEYS / [F1] SCAN CODES.
[AID_PF1_KEYS]
This section groups the F1-F12 AID+data functions.
[AID_PF2_KEYS]
This section groups the F13-F24 AID+data functions.
[SIGNAL_KEYS]
The signal keys sends a signal frame w/o data or AID code.
[CONTROL_KEYS]
This functions performs Local processing, and sometimes sends AID codes and
input data.
[CURSOR_KEYS]
Local Cursor Movement Keys.
[ERROR_MSG]
This section groups the options that controls the terminal behavior when an
error occurs and the way to handle the user message line.
[BARCODES]
This section groups the emulation options for Barcode reading.
[SCROLL]
This section groups the "Logical scrolling" options to allow to map a
standard 24x80 screen in a 8, or 16 PDT display.
[SCANNER]
This section groups the global scanner operation options.
[UPC_E0]
[UPC_E1]
[UPC_A]
[EAN_8]
[EAN_13]
[MSI]
[CODABAR]
[CODE_39]
[CODE_D25]
[CODE_I25]
[CODE_11]
[CODE_93]
[CODE_128]
[PDF_417]
This sections groups the symbology-specific options.
[BC_EDIT_X]
This sections groups the barcode editing sections.
[PRINT_DATA]
This section groups the options of the display-to-printer system.
[PRINTER]
This section groups the options for the PDT-attached printer.
[DBGOPT]
This section groups the options for debugging files generation.
[COMKBD]
This section groups the options for the communications port as keyboard.
This section allows you to configure the associated files for download.
Number=<num> (2)
Number of associated files for download.
File_X=<string / name> (_MsgVTFr.Cfg)
Name of the associated file for download.
This section groups the PDT-specific features.
MsgFile=<string / name> (empty)
Country Local File messages, you could translate or modify the messages that appears in the PDT Display.
Font=<string / name> (empty)
Name of the PDT font file. the supplied files are : 8859_1.fnt. See also APPENDIX
B.
You may modify or create new files for PDT with FontBld.exe (Included in
Symbol Technologies Series 3000 SDK).
BackLight=<num / seconds> (4)
Timeout of PDT's display backlight timeout (in seconds).
BLAutoOn=<Yes/No> (Yes)
Yes=backlight is on at each time the user strikes a PDT key.
UserTmout=<num / seconds> (120)
Time after if there is no user action, the terminal enter in sleep mode.
Terminal may be wake-up by scanner trigger or [PWR] key at the same point.
KeyClick=<Yes/No> (No)
Yes=Striking a PDT key produces a short click.
LocalBeeps=<Yes/No> (Yes)
Some "Local" functions (internal to PDT) produces a beep.
BeepFreq=<num / Hertz> (1600)
Local beep frequency.
BeepDur=<num / milliseconds> (200)
Beep duration in milliseconds.
DoubleHeight=<Yes/No> (No)
Displays the characters in "Double Height". Each character takes 2
Lines height.
DoubleWidth=<Yes/No> (No)
Displays the characters in "Double Width". Each character takes 2
character width.
PwdWConf=<string / name> (empty)
The password to access to the local WTn configuration menu. 248.
PwdRfConf=<string / name> (empty)
The password to access to the CFG24/CFG11 R.F. configuration program. 307.
PwdExit=<string / name> (empty)
The password to exit to DOS. 307.
This section allows to configure the host sessions available for the user.
Max=<num / sessions> (4)
Maximal number of sessions, range 1-4.
KeyPrev=<word / scancode> (2D00 Fn-Ctl-Y)
Previous session key.
KeyNext=<word / scancode> (2C00 // Fn-Ctl-Z)
Next session key.
This sections (_0 to _3) groups the Telnet connection options specific for each session.
SessName=<string / name> (empty)
Is the name of the session, displayed to the user.
HostIP=<string / address> (0.0.0.0)
Host IP address or 0.0.0.0. This is the default Host IP Address. The user may override this value. This value is recalled in a "Bios Boot Sequence".
Port=<num / port #> (23)
Telnet connection port at host IP address. The user may override this value.
This value is recalled in a "Bios Boot Sequence".
TTypeSelByHost=<Yes/No> (Yes)
In order to set this option to Yes, needs TelOpTTypeTerm=Yes too. If WT
option TelOpTTypeTerm= is No, set this option to No too.
Telnet protocol allows the host to select the most convenient terminal-type choose
among a list (normally following host custom settings) indicating which
types of terminal emulation are available in the client side and which type of
terminal emulation is wished by the user.
* If TTypeSelByHost=Yes :
The final terminal type emulation done by WTn is selected by
the Host.
* If TTypeSelByHost=No :
Emulation terminal type emulation selected by user (TTypePreferred=)
is not modifiable by the Host. (Information is only sent to the host for application
purposes).
TTypePreferred=<number> (0)
0=5251-11
1=5291-1
2=5292-2
3=3179-2
4=3196-A1
5=3270
* If TTypeSelByHost=Yes :
This terminal is indicated to the host as the preferred by
the user in the available terminal-type list.
* If TTypeSelByHost=No :
This terminal is indicated to be the only emulation possible
by the terminal (no list).
TTypeName="<string / Name>" (empty)
Telnet terminal type negotiation uses "normalized" terminal types
names, but some hosts may need other specific forms.
If this string is empty, WTn uses system "normalized" strings.
If not empty, sends the string as the name of the user preferred terminal type (TTypePreferred=).
DevName="<string / Name>" (empty)
The Device Name (Or Workstation ID) negotiated with "environment"
telnet option (see TelOpEnvTerm in TELNET
section).
Using "[IP]", is a generic mask for last digits of IP address,
(xxx[IP]yyy becomes xxx53yyy
for a terminal with 999.999.999.53 IP address.
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 (WT) and Host computer.
This options are global for all the (0-3) sessions.
TelOpEchoHost=<Yes/No> (No)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) to the Host a request for ask the host to do "remote
echo". Avoid in 5250.
TelOpBinHost=<Yes/No> (No)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) to the Host a request for ask the host to performs a
"binary" connection. (the host may send characters from 00h to
FFh). Needed for 5250.
TelOpBinTerm=<Yes/No> (No)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) to the Host a request 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> (No)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) to the Host a request for ask the host to send "End Of
Record" tags. Needed for 5250.
TelOpEorTerm=<Yes/No> (No)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) to the Host a request indicating that the terminal wants to
send "End Of Record" tags. Needed for 5250.
TelOpSgaHost=<Yes/No> (Yes)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) to the Host a request for suppress the "Go Ahead"
system.
TelOpSgaTerm=<Yes/No> (Yes)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) to the Host a request indicating that the terminal wants to
suppress the "Go Ahead" system. (terminal never sends "Go
Ahead" signal).
TelOpNawsTerm=<Yes/No> (No)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) to the Host a request for 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> (No)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) to the Host a request for indicating that the terminal wants
to Send "environment" values, like "Device Name"
(Workstation ID).
Set this option to =Yes only if the host really
needs terminal environment information).
TelOpTTypeTerm=<Yes/No> (Yes)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) to the Host a request indicating that the terminal wants to
send the Terminal Type (what kind of terminal is connected) information to the
host. (If =No, not terminal type information is sent to the host and the
emulation performed by WT is that indicated by TTypePreferred=).
DoTcpAlive=<Yes/No> (Yes)
Yes = WT periodically pings the Host to test the TCP connection state.
Passive=<Yes/No> (Yes)
Yes=WT waits for telnet host commands.
No=WT send telnet commands to host.
This section groups the Terminal emulation level features, ant the way that some emulation features are done by WTn.
Column=<Yes/No> (Yes)
Yes=Map Column separator character attribute to reverse video.
No=Ignore this attribute.
Underline=<Yes/No> (Yes)
Yes=Map underline character attribute to reverse video.
No=Ignore this attribute.
Bold=<Yes/No> (Yes)
Yes=Map bold character attribute to reverse video.
No=Ignore this attribute.
Blink=<Yes/No> (Yes)
Yes=Map blink character attribute to reverse video.
No=Ignore this attribute.
Caps=<Yes/No> (No)
Yes=Force the keyboard to caps lock.
No=Let the keyboard "as is".
Lower=<Yes/No> (Yes)
Yes=Force the keyboard to lowercase.
No=Let the keyboard "as is".
HostBeeps=<Yes/No> (Yes)
Yes=Makes a beep when receives the order from the host.
BeepFreq=<num / Hertz> (2200)
Host Beep frequency.
BeepDur=<num / milliseconds> (300)
Host Beep duration.
BeepTimes=<num / milliseconds> (1)
The times to repeat the beep.
TermWidth=<num / columns> (0)
Logical width of the emulated screen in columns. 0=uses default 80. Top to 80.
TermHeigth=<num / lines> (0)
Logical height of the emulated screen in lines. 0=uses default 24. Top to 25.
EndScanCode=<word / scancode> (0018 / Ctrl-X)
The scan code of the key that ends the current Telnet session. Ctrl-X is the
default key to End session. You can see scan code for each key in the terminal
by "[F4] See Options / [F1] FN KEYS / [F1] SCAN CODES.
UnlkScanCode=<word / scancode> (2200 / Func-Ctrl-G)
Unlocks the keyboard or the scanner if the application miss to send the unlock
escape sequence after the locking sequence.
You can see scan code for each key in the terminal
by "[F4] See Options / [F1] FN KEYS / [F1] SCAN CODES.
FreeCursor=<Yes/No> (No)
No=Cursor moves only in input fields.
Yes=Cursor will move in all the display area, following host configuration (by
SOH flag, byte 1, bit 3).
SetKbdOnNum=<num / KeyboardShift> (0)
When entering in numeric fields (Num-shift, Numeric-Only, Digits-Only and
Signed-Numeric), set the keyboard shift to this position :
0=Normal
1=Right Shift
2=Left Shift
4=Control
8=Alt
16=Scroll
32=Num Lock
64=Caps Lock
128=Function Shift
255="As Is"
SetKbdOnAlpha=<num / KeyboardShift> (0)
When entering in alphabetic fields (Alpha-shift, Alpha-Only), set the keyboard
shift to this position :
0=Normal
1=Right Shift
2=Left Shift
4=Control
8=Alt
16=Scroll
32=Num Lock
64=Caps Lock
128=Function Shift
255="As Is"
CodePage=<string / name> (empty)
The translation table used to translate form/to IBM charmaps and ISO 8859_1 PDT
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.
RcvTmout=<num / seconds> (0)
The seconds between the send action and the "retry message" if no
response.
DoMandEnter=<Yes/No> (Yes)
Yes=Check the MDT (Modified Data Tag) in the fields with Mandatory Enter
attribute before send.
No=Do not check.
SaveFmtTable<Yes/No> (No)
Yes= Save the format table.
No= Do not save the format table.
DestBksp<Yes/No>
(Yes)
Yes= Deletes the chars while moving backwards.
No= Do not delete the chars while moving backwards.
DoFer<Yes/No> (Yes)
Yes= Process the "Field Exit Required" flag in fields.
No= Do not process.
This sections groups the keyboard behavior options.
This section groups the functions that sends to the host the input data and
an AID code.
Each function is associated to a configurable keyboard scan-code.
Functions are not configurable, but keyboard is.
You can see scan code for each key in the terminal
by "[F4] See Options / [F1] FN KEYS / [F1] SCAN CODES.
Clear=<word / scan-code> (0003 / Ctl-C)
Enter=<word / scan-code> (001B / Clear)
Help=<word / scan-code> (2300 / Fn-Ctl-H)
RollDown=<word / scan-code> (5100 / Fn-Dn)
RollUp=<word / scan-code> (4900 / Fn-Up)
RollLeft=<word / scan-code> (0019 / Ctl-Y)
RollRight=<word / scan-code> (001A / Ctl-Z)
Print=<word / scan-code> (0010 / Ctl-P)
PA1=<word / scan-code> (0015 / Ctl-1 (U))
PA2=<word / scan-code> (0016 / Ctl-2 (V))
PA3=<word / scan-code> (0017 / Ctl-3 (W))
This section groups the F1-F12 AID+data functions.
You can see scan code for each key in the terminal
by "[F4] See Options / [F1] FN KEYS / [F1] SCAN CODES.
PF01=<word / scan-code> (3b00 / Fn-1)
PF02=<word / scan-code> (3C00 / Fn-2)
PF03=<word / scan-code> (3D00 / Fn-3)
PF04=<word / scan-code> (3E00 / Fn-4)
PF05=<word / scan-code> (3F00 / Fn-5)
PF06=<word / scan-code> (4000 / Fn-6)
PF07=<word / scan-code> (4100 / Fn-7)
PF08=<word / scan-code> (4200 / Fn-8)
PF09=<word / scan-code> (4300 / Fn-9)
PF10=<word / scan-code> (4400/ Fn-0)
PF11=<word / scan-code> (5400 / Sh-Fn-1)
PF12=<word / scan-code> (5500 / Sh-Fn-2)
This section groups the F13-F24 AID+data functions.
You can see scan code for each key in the terminal
by "[F4] See Options / [F1] FN KEYS / [F1] SCAN CODES.
PF13=<word / scan-code> (5600 / Sh-Fn-3)
PF14=<word / scan-code> (5700 / Sh-Fn-4)
PF15=<word / scan-code> (5800 / Sh-Fn-5)
PF16=<word / scan-code> (5900 / Sh-Fn-6)
PF17=<word / scan-code> (5A00 / Sh-Fn-7)
PF18=<word / scan-code> (5B00 / Sh-Fn-8)
PF19=<word / scan-code> (5C00 / Sh-Fn-9)
PF20=<word / scan-code> (5D00 / Sh-Fn-0)
PF21=<word / scan-code> (0021 / Sh-1 "!")
PF22=<word / scan-code> (0040 / Sh-2 "@")
PF23=<word / scan-code> (0023 / Sh-3 "#")
PF24=<word / scan-code> (0024 / Sh-4 "$")
The signal keys sends a signal frame w/o data or AID code.
You can see scan code for each key in the terminal
by "[F4] See Options / [F1] FN KEYS / [F1] SCAN CODES.
Attention=<word / scan-code> (0001 / Ctl-A)
Help=<word / scan-code> (2300 / Fn-Ctl-H)
SysReq=<word / scan-code> (0013 / Ctl-S)
TestReq=<word / scan-code> (1400 / Fn-Ctl-T)
This functions performs Local processing, and sometimes sends AID codes and
input data.
See APPENDIX A to a detail of
terminal functions.
You can see the scan code for each key in the terminal
by "[F4] See Options / [F1] FN KEYS / [F1] SCAN CODES.
BkSp=<word / scan-code> (0008 / BKSP)
Back Space. Moves cursor one column left.
Dup=<word / scan-code> (2000 / Fn-Ctl-D)
Duplicate. Fills the remain of field with "dup" characters.
FieldPlus=<word / scan-code> (002B / +)
Field Plus. In signed numeric fields, puts a positive sign, and performs a field
exit function.
In other fields, performs a field exit function.
FieldMinus=<word / scan-code> (002D / -)
Field Plus. In numeric and signed numeric fields, puts a negative sign, and
performs a field exit function.
Not allowed In other fields.
FieldExit=<word / scan-code> (000D / Enter)
Performs the pad and adjust functions and moves to the next field.
Delete=<word / scan-code> (0004 / Ctl-D)
deletes one character under the cursor. Scroll une position the right rest of
the filed.
EraseInput=<word / scan-code> (0005 / Ctl-E)
Clear all modified fileds.
ErrorReset=<word / scan-code> (0002 / Ctl-B )
Resets the" X Input Inhibit" (X II) indicator. Puts the terminal in
not-error state.
Home=<word / scan-code> (0007 / Ctl-G )
Moves the cursor to the home position (normally the first field).
If already in home position, sends an AID "record-backspace" code.
Insert=<word / scan-code> (0009 / Ctl-I / Fn-SP )
Toggles the insert/replace mode.
Insert, when data input, moves the right chars of the field (if possible) and
insert the keyed character.
Replace, when data input, puts the keyed character at cursor position (replacing
the previous character).
ForwTab=<word / scan-code> (0014 / Ctl-T )
Moves to the next field.
BackTab=<word / scan-code> (1400 / Fn-Ctl-T)
Moves to the previous filed.
End=<word / scan-code> (1200 / Fn-Ctl-E)
Moves to the last data position in the field.
EraseEof=<word / scan-code> (000F / 3270 Ctl-O)
Erase (null) all the characters in the field at right of cursor position.
FieldMark=<word / scan-code> (0011 / 3270 Ctl-Q)
3270, Same as Dup.
CursorSelect=<word / scan-code> (0000 / 3270)
3270, Not implemented.
Local Cursor Movement Keys.
You can see the scan code for each key in the terminal
by "[F4] See Options / [F1] FN KEYS / [F1] SCAN CODES.
CursorUp=<word / scan-code> (4800 / Up)
In FreeCursor=Yes; Cursor one line Up.
In FreeCursor=No; Cursor in previous field.
CursorDown=<word / scan-code> (5000 / Dn)
In FreeCursor=Yes; Cursor one line Down.
In FreeCursor=No; Cursor in next field.
CursorLeft=<word / scan-code> (4B00 / Le)
In FreeCursor=Yes; Cursor one column left.
In FreeCursor=No; Cursor one column left, if begin of field, cursor in previous
field.
CursorRight=<word / scan-code> (4D00 / Ri)
In FreeCursor=Yes; Cursor one column right.
In FreeCursor=No; Cursor one column right, if end of field, cursor in next
field.
This section groups the options that controls the terminal behavior when an error occurs and the way to handle the user message line.
BeepOnError=<Yes/No> (No)
Yes=Beeps when an error occurs.
BeepFreq=<num / Hertz> (900)
Error message beep frequency.
BeepDur=<num / milliseconds> (0)
Beep Duration.
BeepTimes=<num / times> (1)
The times to perform the beep.
ResetByEnter=<Yes/No> (No)
Restore the terminal in non-error state (see ErrorReset function).
Yes=Reset by ENTER key.
ResetByAny=<Yes/No> (No)
Restore the terminal in non-error state (see ErrorReset function).
Yes=Reset by any key.
ResetTime=<num / seconds> (0)
Restore the terminal in non-error state (see ErrorReset function).
Auto-Reset error after x seconds.
0=Do not perform auto-reset.
NoMsgLine=<Yes/No> (No)
Yes= Don't show the user error message line in the PDT display line in
"floating" mode.
No= Show the user error message line in the PDT display line in
"floating" mode.
This section groups the emulation options for Barcode reading.
ClearField=<Yes/No> (Yes)
Yes=Clears the present (under the cursor) field in barcode reads.
No=Append the barcode data at the present cursor position.
EmbeddedAid=<Yes/No> (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.
BcInField=<char / tag> (T)
T=Oversized barcodes are Truncate
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> (No)
Perform a warning (beep) when truncating a barcode.
DoFieldExit=<Yes/No> (No)
Performs a field-exit function after a barcode read.
DoEnter=<Yes/No> (No)
Performs an ENTER function after a barcode read.
This section groups the "Logical scrolling" options to allow to map a standard 24x80 screen (called "virtual screen") in a 8, or 16x20 PDT physical display.
See also "Screen and Display" figure in Chapter 3.
FixedMode=<Yes/No> (No)
Yes="Fixed Screen Mode". The PDT display shows a part of the terminal
virtual screen, and never moves, even if the cursor is out of the display. The
"Logical Scroll Keys" has no effect.
No="Auto Scroll Mode". The PDT display always shows the screen
area where the cursor is. The displays moves following "edges" (see EdgeXXX=). In this mode, The "Logical Scroll Keys" manually
moves the display into the screen (see KeyXXX=).
StartPosX=<num / row> (0)
When in "Fixed Screen Mode" (see FixedMode=), the
left start position for terminal display in virtual screen. The first left
position is 0.
StartPosY=<num / line> (0)
When in "Fixed Screen Mode" (see FixedMode=), the
top start position for terminal display in virtual screen. The first top
position is 0.
ScrollX=<num / rows> (0)
When in "Auto Scroll Mode" (see FixedMode=), the number
of rows that the display moves (left or right side) when KeyLeft= or KeyRight=
keys are pressed.
If 0 the value is initialized to the display width.
ScrollY=<num / lines> (0)
When in "Auto Scroll Mode" (see FixedMode=), the number
of lines that the display moves (up or down side) when KeyUp= or KeyDown=
keys are pressed.
If 0 the value is initialized to the display heigth.
KeyUp=<word> (3200 / Fn+Ctrl+Up)
When in "Auto Scroll Mode" (see FixedMode=), the scan
code of the key that moves the display up in logical screen. You can see the scan code for each key in the terminal
by "[F4] See Options / [F1] FN KEYS / [F1] SCAN
CODES".
KeyDown=<word / scancode> (3100 / Fn+Ctrl+Up)
When in "Auto Scroll Mode" (see FixedMode=), the scan
code of the key that moves the display down in logical screen.
You can see the scan code for each key in the terminal
by "[F4] See Options / [F1] FN KEYS / [F1] SCAN
CODES".
KeyLeft=<word / scancode> (2500 / Fn+Ctrl+Left)
When in "Auto Scroll Mode" (see FixedMode=), the scan
code of the key that moves the display left in logical screen.
You can see the scan code for each key in the terminal
by "[F4] See Options / [F1] FN KEYS / [F1] SCAN
CODES".
KeyRight=<word / scancode> (2600 / Fn+Ctrl+Right)
When in "Auto Scroll Mode" (see FixedMode=), the scan
code of the key that moves the display right in logical screen.
You can see the scan code for each key in the terminal
by "[F4] See Options / [F1] FN KEYS / [F1] SCAN
CODES".
EdgeLeft=<num / rows> (4)
When in "Auto Scroll Mode" (see FixedMode=), the lesser
number of rows that can remain in the left cursor side before make an "auto
scroll".
EdgeRight=<num / rows> (1)
When in "Auto Scroll Mode" (see FixedMode=), the lesser
number of rows that can remain in the right cursor side before make an
"auto scroll".
EdgeUp=<num / lines> (1)
When in "Auto Scroll Mode" (see FixedMode=), the lesser
number of rows that can remain above the cursor before make an "auto
scroll".
EdgeDown=<num / lines> (1)
When in "Auto Scroll Mode" (see FixedMode=), the lesser
number of rows that can remain under the cursor before make an "auto
scroll".
This section groups the global scanner operation options.
Enable=<Yes/No> (Yes)
Yes=The scanner is enable by default
No=The scanner is disable by default.
TurnOffScan=<Yes/No> (Yes)
Yes=Disable scanner after a successful read.
Prefix=<hex-string> (empty)
This string is sent before the barcode
Suffix=<hex-string> (empty)
This string is sent after the barcode
BeepOnDecode=<Yes/No> (Yes)
Yes=generates a beep after a successful good barcode read.
No=Do not beep.
BeepFreq=<num / Hertz> (888)
Good scan beep frequency. (in hertz).
BeepDur=<num / milliseconds> (200)
Beep duration in milliseconds.
ScanTmout=<num / seconds> (10)
Time after the scanner turns off if continuous holding the trigger.
Redundancy=<num / pass> (1)
Number of good barcode reads needed to successful decode it.
May be required if using poor quality barcodes to prevent misreads.
Warning : redundancy increases the decode time.
1=No redundancy (one pass)
SpottingBeam=<Yes/No> (No)
Activates the "Double Trigger" feature for the Long Range scanners
that allows to have an aiming spot (first position, fixed) and a scanning spot
(second position, sweep).
Do not activate this option in a standard scanner.
Yes=The scanners uses the double trigger.
No=The scanner the scanner don't uses the double trigger.
ReplaceChar[0_4]<hex-string /
hex-string> (1A/00)
Replaces the first char indicated for the second one. If one of the characters
is zero, no replace is done.
The Available symbologies are :
UPC_E0
UPC_E1
UPC_A
EAN_8
EAN_13
MSI
CODABAR
CODE_39
CODE_D25
CODE_I25
CODE_11
CODE_93
CODE_128
PDF_417
Those sections groups the symbology-specific options.
On=<Yes/No> (most popular)
The scanner tries to decode this symbology.
Warning : Enabling too much symbologies should increase decode time and would generate
misreads.
Min=<num / char number> (smart ...)
Minimum characters accepted in this barcode type.
Max=<num / char number> (smart ...)
Maximum characters accepted in this barcode type.
If Min= < Max=, reads barcodes between Min= and Max=
length.
If Min= > Max=, reads barcodes that have Min= OR Max=
length.
If Min=0 and Max=0, reads variable barcode length. (minimum and
maximum allowed depends on the barcode type).
Warning : Some barcode types may generate misreads with variable length.
Opt=<num> (0)
0=Option disabled.
1=Option Enabled.
Option are available in some barcodes (supplemental, check-digit, etc.).
Four sections, [BC_EDIT_0] to [BC_EDIT_3].
This sections groups the options for the "Barcode editing"
processing.
Barcode reads may be modified by performing an editing process before send
them to the input fields.
The editing process has three parts :
1) Evaluates the match conditions to determine if the process applies to this
barcode read. The barcode must match ALL the conditions switched to
"Yes" (LenDo, MatchDo, TypeDo).
2) Filter the barcode to keep or eliminate data by the "Y/N" pattern (Filter).
3) Insert some characters by the "*" mask (Insert).
On=<Yes/No> (No)
Yes=Evaluates this section, and perform Barcode Editing (if match).
No=Do not evaluate this section (all the following options are ignored).
LenDo=<Yes/No> (No)
Yes=Do match barcode length.
Editing is performed if satisfies this condition.
LenMin=<number / length> (0)
The minimum length to match.
LenMax=<number / length> (0)
The maximum length to match.
MatchDo=<Yes/No> (No)
Yes=Do Match string.
Editing is performed if satisfies this condition.
MatchPos=<num / position> (1)
The position in the barcode to perform the match test. (start at 1)
MatchStr="033"
The string to match in the barcode at given position.
TypeDo=<Yes/No> (No)
Yes=Do match Barcode type.
Editing is performed if satisfies this condition.
TypeBc=<num / barcode> (0)
0=UPC_E0, 1=UPC_E1, 2=UPC_A, 3=MSI, 4=EAN_8, 5=EAN_13, 6=CODABAR, 7=CODE_39, 8=CODE_D25, 9=CODE_I25, 10=CODE_11, 11=CODE_93, 12=CODE_128, 13=PDF_417.
Filter=<string / pattern> (empty)
Editing; Filter the source barcode data with this pattern :
Y=Keep the character.
N=ignore the character.
Insert=<string / mask> (empty)
Editing; After filter processing, applies this mask to the result data :
*=Keeps the character from the barcode
NNN=Insert a new char
This section allows to send data to an attached printer, via display screen
commands, following the "Print Display Data" processing 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 terminal attached serial printer (following printer
configuration).
The whole text for a label to print must fit in a single screen.
The following conversions are performed :
On=No
Performs "Print Display Data" processing.
StartPrintId=<string / pattern> ("PRN:")
The pattern to match when printing data ("PRN:").
The start print tag. The data between start and stop print tags are sent to the
printer.
StopPrintId=<string / pattern> (":PRN")
The pattern to match when printing data (":PRN").
The stop print tag. The data between start and stop print tags are sent to the
printer.
IDRow=<number / row> (3)
The row to look for the start print ID.
Start at 1.
IDCol=<number / column> (1)
The column to look for the start print ID.
Start at 1.
NullToSpace=Yes
Performs null to space conversion before perform 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> ("092" or
"/5C" or "..\" / an "\")
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
to ASCII and converted to a "control character" by subtraction of 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 to a single hex control character.
"\#1C"=0x1C, "\#00"=0x00, "\#FF"=0xFF.
For the characters higher than 0x7F, check if the serial link to the printer is configured in 8 bits mode.
This section groups the options for the PDT-attached printer.
Type=<string / Name> (PS1000)
Printer type connected.
Port=<num / Com#> (1)
1=Com1
2=Com2
Communication port. One digit.
Baud=<num> (96)
12=1200 Bauds
24=2400 Bauds
48=4800 Bauds
96=9600 Bauds
19=19200 Bauds
38=38400 Bauds.
Baud rate. Two digits.
Parity=<uppercase letter> (N)
O=Odd
E=Even
N=None
M=Mark
S=Space
Data parity.
DataBits=<num> (8)
7= 7 Data bits.
8= 8 Data bits.
Data bits.
StopBits=<num> (1)
1= 1 stop bit.
2= 2 stop bits.
Stop bits.
FlowControl=<uppercase letter> (N)
N=None (No flow control).
S=Software flow control (XON / XOFF).
H=Hardware flow control (CTS / RTS).
Dsr=<Yes/No> (Yes)
Yes=Data Set Ready (DSR) sensing signal for connection.
No=Ignore DSR.
Cts=<Yes/No> (No)
Yes=Clear To Send (CTS) sensing signal for connection.
Np=Ignore CTS.
Cd=<Yes/No> (No)
Yes=Carrier detect (CD) sensing signal for connection.
No=Ignore CD.
Tmout=<num / seconds> (60)
Maximum time waiting for printer ready signal before fails.
If printer fails, a message alerts the user and allow to retry print operation or
abort.
AskReprint=<Yes/No> (Yes)
Yes=After a successful print, ask to the user to reprint the same label or to
continue.
No=After a successful print, informs the user and continue.
Display=<Yes/No> (Yes)
Yes= A status printing message is shown while printing.
No= No message is shown while printing.
This section groups the options for debugging files generation. This options may be used ONLY for debugging purposes. Full memory condition is not checked, and subsequent printing operations may fail. You MUST manually empty the files.
InLog=<Yes/No> (No)
Logs in a file all data received.
InFile=<string / name> (empty)
File Name.
OutLog=<Yes/No> (No)
Logs in a file all data sent.
OutFile=<string / name> (empty)
File Name.
This section groups the options for the communications port as keyboard.
ComKbdOn=<Yes/No> (No)
Yes=Uses the communication port as a keyboard entry.
No=Do not use.
Port=<num / Com#> (1)
1=Com1
2=Com2
Communication port. One digit.
Baud=<num> (96)
12=1200 Bauds
24=2400 Bauds
48=4800 Bauds
96=9600 Bauds
19=19200 Bauds
38=38400 Bauds.
Baud rate. Two digits.
Parity=<uppercase letter> (N)
O=Odd
E=Even
N=None
M=Mark
S=Space
Data parity.
DataBits=<num> (8)
7= 7 Data bits.
8= 8 Data bits.
Data bits.
StopBits=<num> (1)
1= 1 stop bit.
2= 2 stop bits.
Stop bits.
BlocMode=<Yes/No> (No)
Yes=Data is received as a block delimited by Sob (Start Of Bloc) pattern
(optional) and Eob (End Of Bloc) Pattern (mandatory). Data between Sob and Eob
are used. Data may be processed as a barcode (prefix, etc.) if AsBarcode=Yes.
No=Data is received by one character at a time, and processed as a keyboard
entry (caps, lower and translation routines). For translation routines a 00 is
added to create a scan-code.
AsBarcode=<Yes/No> (No)
Yes=The input data (with BlocMode=Yes) is processed as a barcode,
prefix, suffix, and edit mode are available.
No=The input data is processed as a bloc of keyboard entry.
Sob=<hex-string> (""
empty).
Start of bloc pattern. Used in BlocMode=Yes only. Optional blocs
may not have start pattern.
Eob=<hex-string> (""
empty).
End of bloc pattern. Used in BlocMode=Yes only. Mandatory, blocs
should have end pattern.
DoTmout=<hex-string> (N).
N=no. No time.
P=Process. When the time out is reached, all the data received is processed.
D=Discard. When the time out is reached, all the data received is not processed.
BlocTmout=<num> (100).
Number of milliseconds in the bloc to time out.