Home

9500 Communications Server User Manual

image

Contents

1. PTX Host Application Emulation Software Hy 3274 HTTP rowser j Base Terminal PTX CommServer Host Computer Terminals connecting through HTTP make use of an HTTP server in the CommServer The web browser on the terminal should be directed to the standard HTTP port port 80 on the CommServer Psion Teklogix 9500 Communications Server User Manual C 51 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 3274 Emulation Alarm Checkbox Alarm Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected terminals will beep when the word ALARM in capital letters appears on the application screen in the location specified by the Command Region parameter see page D 62 The word ALARM should be a display only field A amp L Note The Command Region parameter must be enabled for this parameter to work Clear Checkbox Clear Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer creates an empty entry field for an entry field that is filled with spaces Some host applications rely on the video attributes of displayed characters to highlight fields particularly entry fields For example the application screen may define all entry fields with re
2. Number of Poll Windows 3 Size of Poll Windows 8 characters Maximum Message Segment Size 100 characters Free Window Factor 0 Message Mode Limit 4 Radio Parameters Sync Delay 28 characters Remote Txon 13 characters Baud Rate 9600 gt Modulation 2level z RRM Radios TRX7370 Terminal Radios mixed x Group Parameters Combination 1 Combination 2 Results Errors Ei Warnings i Number of RRMs RRM Combination Cycle Poll Timeout in Terminals average C ticks load 1 605 Poll Timeout in Terminals maximum o ticks load 1 60s x Copyright 2002 Psion Teklogix Inc C 156 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens The CommServer displays this Analyze RRM Group screen after the user has pressed the Analyze button This screen is created by the CommServer after it analyzes the current RRM configuration This screen presents the configured parameters for the RRM groups on this CommServer It is divided into several parts General Parameters This section gives the name of the RRM group and lists the protocol it uses Polling Protocol Parameters This section lists the configured parameters for the polling protocol These parameters include Number of Poll Windows Size of Poll Windows Maximum Message Segment Size Free Window Factor
3. PTX Communications Server Remote Sockets Protocol Options Unnamed Host Psion Teklogix Remote Sockets Protocol Options Remote Sockets has no protocol options Cancel Copyright 2004 Psion Teklogix Inc The CommServer displays a version of the Protocol Options screen with no configurable options after the user has selected the Remote Sockets emulation protocol combination for this host connection E Note The screen shown here gives the emulation options for a host named Unnamed Host C 122 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens 2 2 6 Function Key Mapping This screen differs depending on the type of emulation selected in the General Host Options screen There are five variants of this screen depending on the emulation protocol combination chosen for the host ANSI function key and arrow key mapping for the ANS Telnet emula tion protocol combination See page C 124 3274 function key mapping for the 3274 Telnet and 3274 SNA emulation pro tocol combinations See page C 127 5250 function key mapping for the 5250 Telnet and 5250 SNA emulation pro tocol combinations See page C 129 HTML function key mapping for HTML emulation See page C 130 No function key mapping for the 2392 Telnet 9010 TCP IP RF Modem Tel net and Remote Sockets emula
4. Values 0 127 Default 4 This textbox contains the maximum number of telnet sessions which are allowed to originate from each terminal First Local Terminal Port Textbox First Local Terminal Port Values 1024 32767 Default 0 This textbox contains the port number from which the first terminal will connect on outbound telnet sessions Local IP Address To Bind Textbox Local IP Address to Bind Values lt any valid IP address gt Default 0 0 0 0 This textbox contains the IP address of the network adaptor in the CommServer from which the first terminal will connect on outbound telnet sessions Psion Teklogix 9500 Communications Server User Manual C 101 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 3274 Emulation Telnet Protocol First Terminal Listen Port Textbox First Terminal Listen Port Values 0 32767 Default 10000 This textbox specifies the first port number at which the CommServer will listen for telnet connection requests to the terminals E Note Entering a value of 0 disables this option Actively Negotiate With Host Checkbox Actively Negotiate With Host Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer negotiates with the host during setup of the telnet connection Configure LU Names
5. Psion Teklogix 9500 Communications Server User Manual D 7 Appendix D Developing HTML For The CommServer Text Formatting Tags D 2 3 Text Formatting Tags Tag Specific r Tag Meaning Support Tnfcemation Place text exactly lt PLAINTEXT gt as presented Terminal lt PRE gt including console whitespace Terminal lt XMP gt Example console lt BR gt Line break Terminal console Due to space restric pe Paiaoraph break Terminal tions paragraph console spacing is minimal Terminal lt DIV gt Division console Acts like lt P gt limited support Terminal Draws a line of dash and console characters across the lt HR gt Horizontal rule ae els limited screen no justification support support D 8 Psion Teklogix 9500 Communications Server User Manual Appendix D D 2 4 Table List and Definition Tags Developing HTML For The CommServer Table List and Definition Tags Tag Meaning Support Tag Specific Information lt OL gt Ordered list List entries are indented prop lt UL gt unordered list Limited erly Ordered and unordered lt LI gt list item support lists are rendered with asterisk lt DIR gt directory characters as bullets TELE Tabl Variable width tables are ms ea lew supported The column WIDTH lt TR gt table row Limited attribute may take a value lt TD gt table data support Reger neh table heading expressed in pixels
6. D 22 Psion Teklogix 9500 Communications Server User Manual APPENDIX E SOFTWARE LICENSE AGREEMENTS E 1 For Psion Teklogix Software 04 E 3 E 2 For IBM Personal Communications Software E 8 Psion Teklogix 9500 Communications Server User Manual E 1 Appendix E Software License Agreements For Psion Teklogix Software E l For Psion Teklogix Software SOFTWARE LICENSE AGREEMENT SUMMARY This Agreement governs the use of Psion Teklogix Software by you Your acceptance of this Agreement upon installation or Use of this Software shall signify your agreement to be bound by the terms and conditions specified herein The Software is the property of Psion Teklogix Inc or its licensors and is protected by copyright laws Psion Teklogix Inc provides the Software and licenses its use worldwide You assume responsibility for the selection of the Software to achieve your intended results and for the Use and results obtained from it 1 Definitions Computer means a Psion Teklogix RF Equipment or other computer systems owned leased or otherwise controlled by you Documentation means any on line help files or written instructions manuals regarding the use of or related to the Software Proprietary Information means the Software Documentation and any complete or partial copies thereof and any other Third Party Software licensed with or as part of the Software or any information that is identified as or w
7. Direct TCP Check Duplicate Terminal Number Expiration period in days for Automatic Radio Address and Terminal Number Automatic Radio Address assignment range Vv TEE 0 E Direct TCP Connections for TekTerm O Vv ze A Help Automatic Terminal Number assignment Help Group Range Comment Group 1 Default fi floza Loo me T ooo Jape m C Jipe A E m e 7 OK Cancel Copyright 2002 Psion Teklogix Inc Operate In Cellular Mode Checkbox Operate in Cellular Mode Values lt selected gt lt unselected gt Default lt selected gt C 160 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommsServer Configuration Radio Link Features If this checkbox is selected the base stations connected to this CommServer operate in cellular mode enabling terminals to move seamlessly between base stations switching channels if necessary Poll ID Textbox Poll ID Values 0 15 Default 0 The poll ID is a unique number for this CommServer It is used in the poll header to identify the CommServer when it polls terminals This is useful in systems with more than one CommServer Polling Protocol Terminal Timeout Textbox Polling Protocol Terminal Timeout Values 0 60 Default 60 This parameter specifies the time in minutes that a terminal is allowed to be offline before the CommServer removes it from the system W
8. Emulation Options Protocol Options Function Key Mappings 802 IQ v1 And v2 Features Kg Cancel Radio Link Features Function Key Mapping EI m Rare Eo General Options Connectivity Options SiMe Protocol Options l RRM Groups Menu Emulation Options General Options ejpifeitie Da RRMs Configure General Host Options Analyze eet fox cancel General Options OK Cancel Configure New or Existing RRM ES om RRM Group Options OK Cancel N C 12 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface The CommServer s Web Configuration Screens 9500 Network Controller Main Configuration Screen Peat toes ee cg Cancel Redundancy Configuration Redundancy Options Configure SNA Parameters fox SNA Protocol Configuration System Management Parameters Configure System Configuration Cancel Delete uee ED ton SNMP Options Configure Miscellaneous System Options Configure SNMP Options ES oo System Commands Show Database Show All Reboot Reboot Miscellaneous Options Validate and Save Database rEg fok cancel Cancel Entire Database Contents Really Reboot OK Cancel Database Validation Results piii N C E TIT
9. Listboxes A listbox allows the user to select from among a number of choices ae j9600 E An unselected listbox displays its default choice when the listbox is selected it Psion Teklogix 9500 Communications Server User Manual C 7 Appendix C The 9500 CommServer s Web Interface The CommServer s Web Configuration Screens displays all of its choices and allows the user to choose from them This manual indicates listboxes as rectangles with triangles V A amp L Note Since these elements are rendered by the browser their appearance will vary from one browser to another C 1 3 1 Items Common To Many Screens There are a number of features common to many screens of the CommServer s web interface The most frequent of these are the OK Cancel and Main Menu buttons OK Button When the user presses the OK button after making changes in a screen the CommServer accepts the changes saves them to the temporary configuration cache and displays a confirmation screen PTX Communications Server i Data received successfully Data received successfully ox Copyright 2002 Psion Teklogix Inc When the user presses the OK button on this screen the CommServer displays the Configuration Main Menu A amp L Notes 1 From some screens the OK button causes the CommServer to display the Hosts menu the Base Stations menu or the RRM Groups Menu From any of these menus pressing the Main Menu but
10. Psion Teklogix 9500 Communications Server User Manual C 13 Appendix C The 9500 CommServer s Web Interface The Web Configuration Screens C 2 The Web Configuration Screens In this section all the web configuration screens of the CommServer are presented C 2 1 The Configuration Main Menu Screen PTX Communications Server Configuration Main Menu Psion Teklogix cm ro Controller Configuration Hosts Base Stations RRM Groups Radio Link Features 802 1Q v1 and v2 Features 3274 Configure 1 F Create New Configure acer E Create New gt Configure ie Configure Configure p Redundancy Configuration Redundancy Options Configure SNA Protocol Configuration System Management Parameters Configure System Configuration Users SNMP Options Miscellaneous System Options 1 user E Configure Configure Configure Miscellaneous Commands Display Entire Database Contents Restart Controller Software Validate and Save Current Configuration Show All Restart Validate Copyright 2002 Psion Teklogix Inc The CommServer s Configuration Main Menu screen is the first screen presented when the user connects to the CommServer It is divided into five parts Controller Configuration Redundancy Config
11. RLE Checkbox Enabled Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer uses run length encoding RLE on the data it sends across the radio link RLE compresses repeated characters going from the host to the terminal If repeated characters are found in the data stream the first one is sent followed by a short escape sequence 3 or 4 characters which tells the terminal how many times to repeat this character In this way RLE compresses the data and decreases the total amount of radio link traffic Convert 7 To 8 Bits Checkbox Enabled Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer converts 7 bit control sequences to their 8 bin equivalents in ANSI datastreams going to the terminals This replaces 7 bit two character escape sequences with a single equivalent 8 bit character compressing the data For example the escape sequence ESC is converted to CSI Lower Character Set GL Listbox Lower Character Set GL Values lt see text gt Default ASCII This listbox allows the user to select the character set to be used for the first 128 character codes decimal 0 to 127 hex 00 to 7F Psion Teklogix 9500 Communications Server User Manual C 31 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emula
12. The range of terminals in the Configure Existing Base Station screen 1s specified using the First Terminal parameter The value entered in this parameter is always mapped to RF terminal ID 1 For instance entering a value of 10 sets an offset of 9 and matches host emulation 10 to RF terminal ID 1 host emulation 11 to RF terminal ID 2 etc When the value is set to 1 offset equals zero the RF terminal ID number is identical to the host emulation number When the range starts with a number other than 1 an offset is created equal to the parameter value minus 1 In almost all situations a value of is used for this parameter on the Base Station screens Thus host emulation numbers and terminal ID numbers would be identical Psion Teklogix 9500 Communications Server User Manual B 9 Appendix B Setting Terminal Numbers On The CommServer Setting The Terminal Range Base Stations E Note The terminal number specified in the First Terminal parameter is always mapped to RF terminal 1 This means that by using offsets you cannot create a range of terminals that will start with any other RF terminal ID number Ifyou want to separate the RF terminals into groups each communicating with different Base Stations the correct way to do so would be by enabling disabling the appropriate channels on the terminals them selves Refer to the appropriate terminal user manuals for instructions AN Important Only extrem
13. 43 12x12 Big 5 Chinese 12x13 6x21 16x53 40x53 q4 74x24 Simplified 9x99 5x32 12x80 25x80 Chinese Table C 4 Complete Font Code List Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens Fonts And Font Codes By default the aliases are set to Font re Row x Column Size Code Pixel Size 7035 8255VFD 8255LCD 8260 EL 0 alias NORMAL 18x32 5 10x32 8 25x80 8 30x80 9 1 alias SMALL 18x32 5 10x42 6 25x80 8 30x80 9 2 alias LARGE 10x26 34 10x32 8 11x80 22 26x80 22 3 alias TINY 18x32 5 10x32 8 25x80 8 60x80 8 4 alias HUGE 8x20 22 5x32 9 16x40 19 19x40 21 Table C 5 Default Font Aliases Not included in the international standard build C 48 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 3274 Emulation The Emulation Options Screen 3274 Emulation PTX Communications Server 3274 Emulation Options Fred Psion Teklogix 3274 Options 1 Is Host Fujitsu Oo 1 Use Internation EBCDIC O TE Allow null character in fixed field m e Terminal Protocol TESS BCM 7 L
14. 5 6 7 OOOOO0 A Base Station 1 Terminal ID 1 DOGO A Base Station 2 Terminal ID 1 Figure B 19 Terminal ID 17 20 cannot communicate with any host no host is configured with a range or offset high enough Host Emulations on CommServer 123 4 5 67 8 9 10 11 12 13 14 15 16 17 18 19 20 Host 1 A Base Station 1 Terminal ID 1 Figure B 20 Psion Teklogix 9500 Communications Server User Manual B 21 APPENDIX THE 9500 CommServer s WEB INTERFACE Cl Introduction s sossa pee we ee Seah ale eb eek ate ey ES C 3 C 1 1 About The 9500 CommServer s Web Interface C 3 C 1 2 The CommServer s Host Application Screens C 3 C 1 2 1 The Host Application Screens C 3 C 1 2 2 Limitations Of The Host Application Screens C 5 C 1 3 The CommServer s Web Configuration Screens C 5 C 1 3 1 Items Common To Many Screens C 8 C 1 3 2 Finding Screens 004 C 9 C 1 3 3 Maps Of The CommServer s Web Interface C 12 C 2 The Web Configuration Screens C 14 C 2 1 The Configuration Main Menu Screen C 14 C 2 1 1 Controller Configuration C 15 C 2 1 2 Redundancy Configuration C 16 C 2 1 3 SNA Protocol Configuration C 16 C 2 1 4 System Configuration C 17 C 2 1 5 Miscellaneous Commands C 18 C 2 2 Controller Configuration The Host Screens
15. Appendix C The 9500 CommServer s Web Interface CommServer Configuration 802 1Q v1 And v2 Features 802 IQ v2 Features Protocol Type ID Textbox Protocol Type ID Values 5001 65535 Default 2476 This parameter sets the protocol type ID which which the CommServer will label 802 IQ v1 beacon packets 802 10 v2 Features Enabled Checkbox Enabled Values lt selected gt lt unselected gt Default lt unselected gt When checked this parameter enables 802 IQ v2 An 802 IQ v2 beacon is a broadcast sent out to all 802 IQ v2 enabled terminals It allows the 802 IQ v2 terminals to detect the CommServer and obtain the CommServer s IP address The beacon allows terminals to determine when they have roamed between base stations It also enables a terminal to determine whether the base station or CommServer was rebooted and if so how to recover Beacon UDP Port Textbox Beacon UDP port Values 5001 65535 Default 8888 This parameter sets the port number through which the CommServer will send beacon packets Beacon Gateway Interface Listbox Beacon Gateway Interface Configured 0 Ethernet IP Address V Values lt index gt Ethernet lt IP Address gt Default 0 Ethernet lt IP Address gt Psion Teklogix 9500 Communications Server User Manual C 167 Appendix C The 9500 CommServer s Web Interface Redundancy Options 802 1Q v2 Features This parameter
16. C 19 C 2 2 1 Configure New Host C 19 C 2 2 2 The HostMenu C 22 C 2 2 3 General Host Options C 23 C 2 2 4 Emulation Options C 26 C 2 2 5 Protocol Options 4 C 87 C 2 2 6 Function Key Mapping C 123 C 2 3 CommServer Configuration The Base Station Screens C 132 C 2 3 1 Configure New Base Station C 133 C 2 3 2 The Base Station Menu C 135 C 2 3 3 General Options C 136 Psion Teklogix 9500 Communications Server User Manual C 1 C 2 3 4 Connectivity Options C 139 C 2 4 CommServer Configuration The RRM Groups ScreensC 140 C 2 4 1 Configure New RRM Group C 142 C 2 4 2 The RRM Group Menu C 149 C 2 4 3 Configure Existing RRM Group C 151 C 2 4 4 Configure New RRM C 153 C 2 4 5 Configure Existing RRM C 154 C 2 5 CommServer Configuration Radio Link Features C 160 C 2 7 Redundancy Options 08 C 168 C 2 8 System Configuration SNA Parameters C 172 C 2 9 System Configuration The Users Screens C 173 C 2 9 1 Create New User Entry C 173 C 2 9 2 Edit Existing UserEntry C 174 C 2 11 System Configuration Miscellaneous System Options C 177 C 2 12 Miscellaneous Commands C 179 C 2 12 1 Display Entire Database Contents C 179 C 2 12 2 Restart The CommServer Software
17. C 41 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 2392 Emulation Table C 3 Match Characters Hidden Match Character Textbox Hidden Match Character Values 0 127 Default lt none gt A special character is used to mark Hidden Match fields in a TESS screen This character precedes the field contents of the Hidden Match field In hidden match fields as opposed to visible match fields the preloaded entry is not displayed in the entry field at the operator s terminal This textbox allows the user to enter the decimal representation of the ASCII character code of this special character A value of 0 zero disables this feature Serial 1 0 Textbox Serial I O Values 0 127 Default lt none gt Serial I O fields are special entry and fixed fields that accept input from and output to a serial port The application program distinguishes this field as Serial I O by preceding the field with a special character If this character precedes a fixed field the data will be sent to the terminal s serial port If it precedes an entry field the field accepts data from the terminal s serial port This textbox contains the decimal representation of the ASCII character code of this special character A value of 0 zero disables this feature Print Line Textbox Print Line Values 0 24 Default lt none
18. CD Carrier Detect jami RD Receive Data TD Transmit Data DTR Data Terminal Ready SG Signal Ground DSR Data Set Ready RTS Ready To Send CTS Clear To Send S a AJl ajl A w N RI Ring Indicator A 4 Psion Teklogix 9500 Communications Server User Manual Appendix A Ports Pinouts And Cable Diagrams Cable Descriptions A 3 Cable Descriptions el lente Protocol Cable Type Connector omni cation modem 19680 RS 232 DTE to DCE 9 pin to 25 pin Asynchronous null modem 19687 RS 232 DTE to DTE 9 pin to 9 pin Asynchronous 3002186 RS 232 au modem 9 pin to 9 pin Asynchronous DTE to DTE A amp L Note Cable 3002186 is necessary for a local serial PPP connection to the 9500 Communications Server hardware It passes the DTR and DSR signals which Windows RAS Server requires Psion Teklogix 9500 Communications Server User Manual A 5 Appendix A Ports Pinouts And Cable Diagrams Cable Descriptions DTE DCE Modem Cable for 9400 PN 19680 DTE DCE D RD lt 2 TD f 3 DTR gt 4 SG 5 DSR lt 6 RTS gt 7 CTS lt 8 9 RI lt DE9 S DB25 P DTE DTE Null Modem Cable for 9400 P N 19687 D gt RD 1D lt DTR SG DSR lt RTS TS RI o aU Aa w N 2 3 4 5 6 1 8 9 DE9 DE9 A 6 Psion Teklogix 9500 Commun
19. Message Mode Limit See Polling Protocol Parameters on page C 144 for descriptions and possible ranges for these parameters Radio Parameters This section lists the configured parameters for the RRM groups radios All RRMs in the group use the same radio configuration however the actual radio hardware in the bases and terminals may differ These radio parameters include Sync Delay Remote TxOn Baud Rate This changeable parameter indicates the selected bit rate for the radios used in this RRM group Modulation This changeable parameter indicates the type of narrow band FM modulation used by the radios in this RRM group All radios oin the group must use the Psion Teklogix 9500 Communications Server User Manual C 157 Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens same modulation Available modulations include two level and four level Not all radios support all modulations in particular older radios only support the two level modulation Two level modulation supports bit rates of 4800 and 9600 bits per second Four levelmodulation supports bit rates of 9600 and 19 200 bits per second The analyzer constrains the available bit rates to those supported by the selected modulation e RRM Radios This parameter ndicates the type of radios installed in the RRMs Terminal Radios This changeable parameter indicates the type of radios installed in the ter
20. Psion Teklogix 9500 Communications Server User Manual C 63 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 3274 Emulation This listbox allows the user to select the protocol to be used for the connection between the terminal and the CommServer Terminals may connect through TESS or HTTP TSF O Checkbox TSF O Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer uses Psion Teklogix Screen Formatter Optimizer software C 64 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation The Emulation Options Screen 5250 Emulation PTX Communications Server 5250 Emulation Options Daevid ae ae Psion Teklogix 5250 Options Fo bE 1 Write Error Code Advisory text z Field Underline Remapping None ie Use International EBCDIC Oo Allow null character in fixed fields K Terminal Protocol TESS BCM TESS Options 2 Alarm Clear Passthru Procedures Local TSF O Host Print Remote Print Pages Transmit Line AIAG Visible Match Character Hidden Match Character Serial 1 0 Prin
21. TESS Options Alarm Clear Passthru Procedures Local TSF O Host Print Remote Print Pages Transmit Line AIAG Visible Match Character Hidden Match Character Serial 1 0 Print Line Print Form Length Barcode Entry Line Field Overhead vaaan T i 3 Command Region HTML HTTP Options J o Q Q 4 Foreground Colour Background Colour X User Data Font Size Function Key Font Size a 2 al 2 ic oO s 8 TSF O OK Cancel Copyright 2002 Psion Teklogix Inc Psion Teklogix 9500 Communications Server User Manual C 49 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 3274 Emulation The CommServer displays this version of the Emulation Options screen after the user has selected the 3274 Telnet or the 3274 TESS emulation protocol combination for the host connection E Note The screen shown here gives the emulation options for a host named Fred With IBM 3274 or IBM 5250 emulation the CommServer converts the application datastream from the host to TESS TEklogix Screen Subsystem or HTML HyperText Markup language data Some of the options in this screen govern this conversion of the host screens to TESS or HTML Is Host Fujitsu Checkbox Is Host Fujitsu Values lt selected gt lt unselected gt Default lt unselected gt If this check
22. The CommServer maintains an image of each page stored at the terminal After receiving an application screen the CommServer tries to match the screen with a stored page If the page is already in the terminal the CommServer instructs the terminal to re display its stored copy of the page no data need be sent across the radio link for that page If the CommServer finds no match for the page the complete page is sent to the terminal E Note When page saving is enabled the number of saved pages is that which is set on the terminal Refer to the appropriate terminal user manual for details Page Saving Consider Double Byte Characters Checkbox Page Saving consider Double Byte Characters Values lt selected gt lt unselected gt Default lt unselected gt C 30 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen ANSI Emulation While using double byte character sets for example Chinese or Korean the Page Saving function can cause a double byte character to be partially overwritten This can cause unprintable screen data and unintended characters and may cause the terminal to shift data on the screen Selecting this checkbox causes a double byte character half to be replaced with a space preventing problems with terminal screen displays Select this checkbox only when using double byte character sets
23. Values lt see text gt Default TLXLCPN C 114 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 5250 Emulation SNA Protocol This textbox contains the local host name for this host connection The name must use the SNA Type A character set which includes uppercase letters A Z numbers 0 9 and the special characters and Lower case letters are accepted and translated to uppercase characters An SNA Type A character string must not begin with a number 0 9 User Name Textbox User Name Values lt see text gt Default TEKUSER This textbox contains the user name for this host connection This is for security verification of the host connection only when the connection is made to the host The user must still log in normally The user name must use the SNA Type A character set which includes uppercase letters A Z numbers 0 9 and the special characters and Lower case letters are accepted and translated to uppercase characters An SNA Type A character string must not begin with a number Password Textbox Password Values lt see text gt Default TEKPASS This textbox contains the password for this host connection This is for security verification of the host connection only when the connection is made to the host The user must still log in norma
24. e its size in pixels width x height and for each terminal type e the number of rows displayed on the terminal e the number of characters columns in each row on that terminal If the font code is out of range it will cause a debug warning to be displayed and the command will be ignored If the terminal debug level is level 4 or greater valid font change requests will be detailed E Note See the TESS Manual for more details Psion Teklogix 9500 Communications Server User Manual C 45 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens Fonts And Font Codes Font Pixel Size Row x Column Size Code 7035 8255VFD 8255LCD 8260 EL 0 alias NORMAL loads median available font size a 2 alias LARGE O eweon NORMAL and HUGE 3 alias TINY loads smallest available font size 4 alias HUGE loads largest available font size 5 5x8 18x32 10x51 25x128 60x128 6 6x8 18x26 10x42 25x106 60x106 7 7x8 historic loads closest match 8 8x8 18x20 10x32 25x80 60x80 9 8x16 9x20 5x32 12x80 30x80 10 8x19 historic loads closest match 11 16x32 historic loads closest match 12 8x12 12x20 6x32 16x80 40x80 13 6x12 historic loads closest match 14 10x24 historic loads closest match 15 16x24 historic loads closest match 16 12x20 7x13 4x21 10x53 24x53 17 10x12 12x16 6x25 16x64 40x64 18
25. lt see text gt Default 32 This textbox contains the number of the last terminal which uses this mode and this host connection When the OK button is pressed the CommServer displays a confirnmation screen PTX Communications Server Data z received successfully 5 Data received successfully OK Update LU Session Information Copyright 2002 Psion Teklogix Inc This screen includes the following button Psion Teklogix 9500 Communications Server User Manual C 117 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 5250 Emulation SNA Protocol Update LU Session Information Button Update LU Session Information The Update LU Session Information button allows the user to update the information being passed to the CommServer s SNA software When it is pressed the CommServer displays an Update Confirmation screen PTX Communications Server Confirm Update Psion Teklogix The following information will be used to update the LU session configuration Property Value PCOMM file to be updated C IBMPCOMM private dummy acg LU Prefix for QPCSUPP Terminals 1 32 TLXOO Update Cancel Copyright 2002 Psion Teklogix Inc This screen lists the following information The path and filename of the configuration file that will be updated This is the configuration file that has been selected as the default in the SNA so
26. 2 4 3 Configure Existing RRM Group 0 OOUUO00 PTX Communications Server Configure RRM Group Daphne Psion Teklogix Name Daphne Communication Protocol TCRAP x Enabled Vv Auto Startup Vv Polling Protocol Parameters Number of Poll Windows Size of Poll Windows Maximum Message Segment Size Number of Retries Collision Size Free Window Factor Message Mode Limit Callsign Period ase Callsign String Radio Parameters Sync Delay Remote Txon AE Active Channel Group Parameters Combination 1 T Combination 2 OK Cancel Delete Psion Teklogix 9500 Communications Server User Manual C 151 Appendix C The 9500 CommServer s Web Interface CommsServer Configuration The RRM Groups Screens In this screen the user can select general options for this RRM group The options in this screen are the same as the options in the Create New RRM Group screen see Configure New RRM Group on page C 142 There is also a Delete button Delete Button The Delete button allows the user to delete the currently displayed RRM group When it is pressed the CommServer displays a confirmation screen PTX Communications Server Delete RRM Group Daphne Psion Teklogix Really delete RRM Group Daphne OK Cancel Copyright 1999 2002 Psion Teklogix Inc If the user presses the Cancel button on this screen the CommServer displays the Configure RR
27. 5250 Telnet Protocol Options C 113 Visible Match Character textbox 2392 Emulation Options C 40 3274 Emulation Options C 58 5250 Emulation Options C 75 W warranty II worldwide offices 17 IH Write Error Code listbox 5250 Emulation Options C 66 X X flag for TEKFLAGS attribute D 15 option for emulator debug D 17 lt XMP gt tag D 8 19680 cable diagram 4 6 19687 cable diagram 4 6 2392 commands in command region C 44 2392 Function Key Mapping screen C 132 2392 Telnet Protocol Options screen C 97 Index Boldface indicates a parameter name as it appears in the Configuration Program Italics indicates a screen name as described in the Web Interface Reference Guide 3002186 cable diagram A 7 3274 host application screens via HTTP C 3 3274 Emulation Options screen C 33 C 49 3274 Function Key Mapping screen C 127 E ts Terminal Naming screen C 3274 SNA Protocol Options screen C 106 32 aan Protocol Options screen C 5250 host application screens via HTTP C 3 5250 Emulation Options screen C 65 5250 Function Key Mapping screen C 129 5250 SNA Protocol Options screen C 114 5250 Telnet Protocol Options screen C 110 9 pin D connector A 4 9010 Emulation Options screen C 81 9010 Function Key Mapping screen C 130 C 132 9010 Telnet Protocol Options screen C 119 Psion Teklogix 9500 Communications Server User Manual xi
28. ACCESSKEY D 1 FKEY D II FKEYONENTER D 3 flags for TEKFLAGS D 15 PASSTHRU D 5 TEKFLAGS D 4 Auto Startup checkbox Configure New RRM Group C 144 802 10 v2 Features C 165 Auto login Auto Telnet Login Enable listbox ANSI Telnet Protocol Options C 92 Auto telnet Host listbox 2392 Telnet Protocol Options C 99 3274 SNA Protocol Options C 103 Auto telnet login Enable listbox 2392 Telnet Protocol Options C 99 3274 SNA Protocol Options C 103 Failed Prompt textbox ANSI Telnet Protocol Options C 95 C 96 Password Prompt textbox ANSI Telnet Protocol Options C 95 Password textbox ANSI Telnet Protocol Options C 94 User ID Prompt textbox ANSI Telnet Protocol Options C 94 User ID textbox ANSI Telnet Protocol Options C 94 Automatic Radio Address textbox Radio Link Features C 163 Automatic Terminal Number assignment text boxes Radio Link Features C 163 automatic terminal response D 18 Auto Startup checkbox Configure Existing Base Station C 138 Configure New Base Station C 134 Psion Teklogix 9500 Communications Server User Manual Index ii Boldface indicates a parameter name as it appears in the Configuration Program Italics indicates a screen name as described in the Web Interface Reference Guide AUTOTAB flag for TEKFLAGS attribute D 15 Auto telnet Auto Telnet Login Enable listbox ANSI Telnet Protocol Options C 92 Host textbox ANSI Telnet Protocol Options C 93 Terminal Prompt textbox ANSI Telnet Protocol Options C 93 Aut
29. Default 200 This textbox allows the user to enter a threshold value for the selected ANSI host connection The threshold is the minimum number of bytes of update data for the terminal screen which must be received from the host before the CommServer will store the screen as a new saved page C 28 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen ANSI Emulation Important The Page parameter see page 30 must be enabled in order to change the value in the Threshold parameter Echo Checkbox Echo M Values lt selected gt lt unselected gt Default lt selected gt If this checkbox is selected the CommServer uses smart echo Smart echo reduces the amount of data sent to the terminal by decreasing the number of radio transmissions Ordinarily when a character mode application is being used each keystroke is sent to the host in one transmission and the character is echoed by the host in another transmission When smart echo is enabled the CommServer will not send the host echo to the terminals if it matches the data sent from the terminal Thus the number of radio transmissions is reduced This mode also reduces or eliminates the delay between typing a character on the keyboard and displaying the character echoed by the host The maximum number of characters waiting for echo is 25 Any
30. Default 3 This textbox allows the user to specify the number of times the RRM retransmits a message to a terminal after receiving no acknowledgement from the terminal before it declares the terminal offline Collision Size Textbox Collision Size Values 3 10 Default 6 This textbox allows the user to specify the smallest number of characters of noise received by the RRM that will be interpreted as interfering transmissions from Psion Teklogix equipment When this threshold is exceeded the RRM starts collision resolution Psion Teklogix 9500 Communications Server User Manual C 145 Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens SYSTEM AND SHOULD NOT BE CHANGED without a proper al Warning THIS PARAMETER IS PRE CONFIGURED FOR YOUR understanding of how it affects the radio link Free Window Factor Textbox Free Window Factor Values 0 7 Default 0 This textbox allows the user to specify the probability that the RRM will include a free window in its poll during which any terminal may transmit g Warning THIS PARAMETER IS PRE CONFIGURED FOR YOUR SYSTEM AND SHOULD NOT BE CHANGED without a proper understanding of how it affects the radio link Message Mode Limit Textbox Message Mode Limit Values 0 7 Default 4 This textbox allows the user to specify the probability of including a message mode poll in its poll transmissio
31. group configured in the CommServer An RRM group may contain only one RRM and may contain a maximum of four RRMs Name Textbox Name Values lt any text string gt Default Unnamed RRM Group This textbox allows the user to enter a name for the new RRM group Protocol Listbox Type V Values TCP IP Default TCP IP This listbox allows the user to select the protocol to be used for the connection to this RRM group Currently the TCP IP protocol is available Enabled Checkbox Enabled V Values lt enabled gt lt disabled gt Default lt enabled gt If this parameter is enabled the CommServer uses the RRMs in this group Psion Teklogix 9500 Communications Server User Manual C 143 Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens Auto Startup Checkbox Auto Startup M Values lt enabled gt lt disabled gt Default lt enabled gt If this parameter is enabled the CommServer establishes communication with the RRMs in this RRM group when it boots and starts polling automatically If this parameter is disabled the CommServer establishes communication with the RRMs in this group when it boots but does not start polling in this RRM group until a start polling message 0S is received from the host Polling starts if at least one of the RRMs in the RRM group is operating when the CommServer boots Polling Protocol Para
32. lt unselected gt Default lt selected gt If this checkbox is selected terminals using TekTerm such as the 7035 8255 and 8260 on the TCP IP network may connect directly to the CommServer through access points such as the Psion Teklogix 9150 Direct TCP Check Duplicate Terminal Number Checkbox Direct TCP Check Duplicate Terminal Number J Values lt selected gt lt unselected gt Default lt selected gt If this checkbox is selected the Communication Server will check for duplicate terminal numbers among those terminals connecting by Direct TCP if the auto terminal ID feature is enabled Expiration period Textbox Expiration period in days for Automatic Radio Address and Terminal Number Values 50 90 Default 75 This parameter specifies the amount of time before automatically assigned rado addresses and terminal numbers expire C 162 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommsServer Configuration Radio Link Features Automatic Radio Address Textboxes Automatic Radio Address assignment range Values lower upper 0 3840 0 3840 Default lower upper 1024 2084 The Automatic Radio Address textboxes specify the lower and upper allowed values of radio addresses that will be assigned automatically to terminals when the Remote Sockets feature is used E Note This parameter has a upper value
33. s Web Interface Controller Configuration The Host Screens The Protocol Options Screen ANSI Emulation Telnet Protocol It is strongly advised not to include multi part words separated by space characters since some hosts send out characters other than space characters to present a space on the screen Auto Telnet Without User Action Checkbox Auto telnet without user action Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer will attempt to connect to the host as soon as a terminal initializes and it will attempt to reconnect if the telnet session is closed Auto telnet Without User Action Timing Delay Textbox Auto telnet without user action timing delay e Values 0 15 Default 1 This parameter specifies the number of milliseconds between auto telnet connection requests sent to the host All requests to connect without user action are queued and are processed with this delay between requests This to prevent flooding host with connection and logins when the CommServer starts or is reset Maximum Number Of Auto Telnet Retries Textbox Maximum number of auto telnet retries Values 0 15 Default 1 This parameter specifies the number of times the CommServer will attenpt to connect to a host if the host doesn t respond If this parameter is zero the CommServer attempts to connect forever Allow TCP Sessions Checkbox Allow TCP Sessi
34. salesusa psion com INTERNATIONAL SUBSIDIARIES Psion Teklogix S A La Duranne 135 Rue Rene Descartes BP 421000 13591 Aix En Provence Cedex 3 France Tel 33 4 42 90 88 09 Fax 33 4 42 90 88 88 E mail tekeuro psion com For a complete listing of international offices please refer to www psionteklogix com F 2 Psion Teklogix 9500 Communications Server User Guide INDEX Boldface indicates a parameter name and Italics indicates a screen name as described in the Web Interface Reference Guide A A flag for TEKFLAGS attribute D 5 option for emulator debug D 6 option for scheme debug D 7 lt A gt tag D 6 ACCESSKEY attribute D J Active Channel textbox Configure New RRM Group C 148 Actively Negotiate with Host checkbox 3274 Telnet Protocol Options C 102 5250 Telnet Protocol Options C 112 AIAG textbox 2392 Emulation Options C 39 3274 Emulation Options C 57 5250 Emulation Options C 74 Alarm checkbox 5250 Emulation Options C 68 Allow TCP Sessions checkbox ANSI Telnet Protocol Options C 96 Analyze button RRM Group C 150 Analyze RRM Group screen C 156 ANSI Emulation Options screen C 27 ANSI Function Key Mapping screen C 124 ANSI Telnet Protocol Options screen C 89 Arbiter IP Address textbox Redundancy Parameters C 170 C 171 Arrow Key listbox ANSI Arrow Key Mapping C 125 Arrow Key Remapping checkbox ANSI Emulation Options C 30 Attention Key listbox 3274 SNA Protocol Options C 107 attribute
35. tag D 7 support services ZI Sync Delay textbox Configure New RRM Group C 147 T T option for scheme debug D 18 lt TABLE gt tag D 9 tag lt A gt D 6 lt B gt D 7 lt BLINK gt D 7 lt BODY gt D 5 lt BR gt D 8 lt DIR gt D 9 lt DIV gt D 8 lt DL gt D 9 lt DD gt D 9 lt DT gt D 9 lt HEAD gt D 5 heading D 7 lt HR gt D 8 lt H1 gt lt H6 gt D 7 ignored D 4 lt IMG gt D 6 lt INPUT gt D 6 D 14 lt LI gt D 9 lt OL gt D 9 lt P gt D 8 lt PLAINTEXT gt D 8 lt PRE gt D 8 lt S gt D 7 lt STRIKE gt D 7 lt STRONG gt D 7 lt TABLE gt D 9 lt TD gt D 9 lt TEKLOGIX gt D 5 D 14 lt TH gt D 9 lt TITLE gt D 5 lt TR gt D 9 lt U gt D 7 lt UL gt D 9 unsupported D 4 without support for function keys D 12 lt XMP gt D 8 TCP Session Request textbox ANSI Telnet Protocol Options C 91 lt TD gt tag D 9 TEKFLAGS attribute D 14 flags D 15 lt TEKLOGIX gt tag D 5 D 14 Teklogix extensions to HTML D 14 Terminal Name listbox 3274 Telnet Terminal Naming C 104 Terminal Number listbox 3274 Telnet Terminal Naming C 104 Psion Teklogix 9500 Communications Server User Manual iX Index Boldface indicates a parameter name as it appears in the Configuration Program Italics indicates a screen name as described in the Web Interface Reference Guide Terminal Offline Timeout textbox 802 1Q v2 Features C 166 Terminal Protocol listbox 3274 Emulation Options C 50 5250
36. 10 System Configuration SNMP Parameters po Our 0 0 L E Ti gol PTX Communications Server SNMP Parameters w D a Psion Teklogix Proxy throttling for non IP terminals Disabled OK Cancel Copyright 2002 Psion Teklogix Inc In this screen the user can set an option for the CommServer s SNMP operation Most of the SNMP options in the CommServer are set through the operating system software Proxy Throttling For Non IP Terminals Listbox Proxt throttling for non IP terminals V Values disabled 500b s 1000b s 1500 b s Default disabled C 176 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface System Configuration Miscellaneous System Options 802 1Q v2 Features This textbox allows the user to enable throttling for SNMP queries and responses crossing Psion Teklogix proprietary radio networks Since these networks often use narrowband FM transmissions their maximum data rates may not be as high as those of 802 11 networks Some SNMP queries may result in large amounts of data crossing the RF networks the Proxy Throttling parameter limits the rate at which such data may be sent to prevent saturation of the RF network C 2 11 System Configuration Miscellaneous System Options aE cl Smb C C4 a m Sm a mm 1 2 PTX Communications Server Miscellaneous Options Serial Number 0 Enab
37. 11 match both host emulation ranges and can thus communicate with the host via both Base Stations Host Emulations on CommServer 12 3 4 5 67 8 9 10 11 12 13 14 15 16 17 18 19 20 19 20 Base Station 1 10111 A Terminal ID Numbers Terminal ID 1 Base Station 2 10711 A Terminal ID Numbers Terminal ID 1 Figure B 9 Terminal ID 12 20 match only one host emulation and can thus communicate with the host only via Base Station 1 Host Emulations on CommServer 12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 12 13 14 15 16 17 18 19 20 Base Station 1 OO80o00o0O A Terminal ID Numbers Terminal ID 1 Figure B 10 In this situation it is possible to have two remote base stations and two sets of terminals with the same ID numbers B 14 Psion Teklogix 9500 Communications Server User Manual Appendix B Setting Terminal Numbers On The CommServer Setting The Terminal Range Base Stations For instance if each site has 9 terminals with ID numbers from 1 to 9 the CommServer will be able to distinguish between two identical terminal ID numbers by the base station to which they communicate Terminal 1 in the first site is actually host emulation 1 and terminal 1 in the second site is actually host emulation 10 Now we can combine this effect with division of terminals between hosts as is shown in the next example Two hosts with two base stations a H
38. 12x12 12x13 6x21 16x53 40x53 19 16x12 12x10 6x16 16x40 40x40 20 16x20 7x10 4x16 10x40 24x40 21 16x25 5x10 3x16 8x40 19x40 22 8x18 8x20 4x32 11x80 26x80 23 16x16 historic loads closest match Table C 4 Complete Font Code List C 46 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens Fonts And Font Codes 26x26 Big 5 Chinese gragas 4x32 11x80 25x80 DBCS loads current DBCS font or NORMAL if no DBCS font found 26 11x17 8x14 4x23 11x58 28x58 27 16x30 4x10 2x16 6x40 16x40 28 10x21 Thai 6x16 3x25 9x64 22x64 29 12x32 Thai 4x13 2x21 6x53 15x53 30 24x24 Korean 9x20 5x32 12x80 25x80 31 16x16 Big 5 Chinese 10x10 5x16 12x40 25x40 32 16x16 Korean 10x10 5x16 12x40 25x40 33 20x20 7x8 4x12 10x32 24x32 34 6x14 iae sazaa 1106 734x106 35 16x16 Simplified 19x10 5x16 12x40 25x40 Chinese 36 5x12 wa sexs se E As 37 8x14 10x20 5x32 14x80 34x80 38 20x29 Arabic 39 7x9 16x22 8x36 22x91 53x91 40 12x12 Korean 12x13 6x21 16x53 40x53 41 12x11 Korean 13x13 7x21 18x53 45x53 a2 12x12 Simplified 19413 6x21 16x53 40x53 Chinese
39. 2 1 2 Redundancy Configuration This section of the Configuration Main Menu has only one item Redundancy Options Redundancy Options Configure Pressing the Redundancy Options button displays the Redundancy Parameters screen Here are options for polling and communication between this CommServer the backup CommServer and the network See Redundancy Options on page C 168 for details 2 1 3 SNA Protocol Configuration From this part of the Configuration Main Menu options for SNA networking from the CommServer to IBM hosts can be configured There is one item in this section System Management Parameters C 16 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface The Configuration Main Menu Screen System Management Parameters Configure Pressing the System Management Parameters button displays the SNA Parameters screen From this screen the user can set certain options for SNA including network name local control point name and exchange identifier See System Configuration SNA Parameters on page C 172 for details C 2 1 4 System Configuration From this part of the Configuration Main Menu the user can set system wide options for this CommServer There are two items in this section Users and Miscellaneous System Options Users 1 sue v Configure The Users listbox allows the user to select a user who is allowed to log in to this CommServer
40. 2 3 3 General Options 4 C 136 C 2 3 4 Connectivity Options C 139 C 2 4 CommServer Configuration The RRM Groups Screens C 140 C 2 4 1 Configure New RRM Group C 142 C 2 4 2 TheRRMGroupMenu C 149 C 2 4 3 Configure Existing RRM Group C 151 C 2 4 4 ConfigureNewRRM C 153 C 2 4 5 Configure Existing RRM C 154 C 2 4 6 AnalyzeRRMGroup C 156 C 2 5 CommServer Configuration Radio Link Features C 160 C 2 6 CommServer Configuration 802 1Q v1 And v2 Features C 165 C 2 7 Redundancy Options 0004 C 168 C 2 8 System Configuration SNA Parameters C 172 C 2 9 System Configuration The Users Screens C 173 C 2 9 1 Create New User Entry C 173 C 2 9 2 Edit Existing User Entry C 174 C 2 10 System Configuration SNMP Parameters C 176 C 2 11 System Configuration Miscellaneous System Options C 177 C 2 12 Miscellaneous Commands C 179 C 2 12 1 Display Entire Database Contents C 179 C 2 12 2 Restart The CommServer Software C 180 C 2 12 3 Validate and Save Database Contents C 181 Appendix D Developing HTML For The CommServer D 1 Limitations Of The CommServer s HTML TESS Emulation D 3 ii Psion Teklogix 9500 Communications Server User Manual Contents D 2 Supported HTML Tags 1 2 ee ee D 4 D 2 1 Link Miscellaneous And Input Tags D
41. 20 OOoO 8000800 Base Station 1 Terminal ID Numbers Terminal ID 1 Figure B 14 Psion Teklogix 9500 Communications Server User Manual B 17 Appendix B Setting Terminal Numbers On The CommServer Setting The Terminal Range Base Stations This type of setup could be useful for example when you have two remote base stations and want each set of terminals to start with ID 1 The CommServer will then be able to distinguish between two identical terminal ID numbers by the base station to which they communicate In this last example terminal 1 in the first site is actually host emulation 1 which belongs to Host 1 and terminal 1 in the second site is actually host emulation 10 which belongs to Host 2 Our final example is even more complex than the last Two hosts with two base stations b Host Emulations on CommServer 12 3 4 5 67 8 9 10 11 12 13 14 15 16 17 18 19 20 1 2 3 4 5 8 Host 1 3 4 5 e6 7 OOQOOOCOOOOOOOOOOOOOO Base Station 1 A Terminal ID Numbers Terminal ID 1 BOGOOOOQOOOOOS Bisse station 2 Terminal ID Numbers Terminal ID 1 Figure B 15 AN Important YOU CANNOT OVERLAP AN ANSI HOST WITH EITHER ANOTHER ANSI HOST OR WITH A TESS HOST In this system we will define the ranges In the General Host Options screen for Host 1 Terminals 1 to9 a range of 9 terminals or
42. 5 D 2 2 Text Attribute Tags 000 D 7 D 2 3 Text Formatting Tags 204 D 8 D 2 4 Table List and Definition Tags D 9 D 3 Function Keys 2 D 11 D 3 1 Mapping The Function Keys D 11 D 3 1 1 Mapping A Function Key To A Hyperlink D 11 D 3 1 2 Mapping A Function Key To A Button D 11 D 3 2 Tags Without Function Key Support D 12 D 3 3 Predefined Function Keys D 12 D 3 4 Remapping Function Key Zero F0 D 13 D 4 HTML Extensions For TESS 2 2 02 2 000 4 D 14 D 4 1 TEKFLAGS Within The lt INPUT gt Tag D 14 D 4 2 TEKFLAGS Within The lt TEKLOGIX gt Tag D 14 D 4 3 The Flags For The TEKFLAGS Attribute D 15 D 5 Debugging And Testing With TeKHTML D 16 D 5 1 Emulator Debug 04 D 16 D 5 2 Scheme Debug 0040 D 17 D 5 3 Automatic Terminal Response Feature D 18 D6 COOKICS lt ara oan nae eg ae ee ee OE eee ee D 19 D 6 1 Overview Of Cookie Transfer D 19 D 6 2 Implementation Of Cookies D 20 D 6 2 1 Difference In Cookie Expiration Mechanism D 20 D 6 2 2 Differences In Returned Data D 21 D 6 2 3 Differences In Punctuation D 22 Appendix E Software License Agreements E 1 For Psion Teklogix Software 2 000 00004 E 3 E 2 For IBM Personal Communications Sof
43. Base Station C 133 Configure New RRM Group C 143 Protocol Options screen C 87 Proxy Throttling For Non IP Terminals listbox SNMP Parameters C 176 R R flag for TEKFLAGS attribute D 15 option for emulator debug D 7 option for scheme debug D 18 radiobutton defined C 7 Reconnection Timeout textbox 5250 SNA Protocol Options C 116 Redundancy Options screen C 168 Refrain From Sending Online amp Offline Mes sages listbox 9010 Emulation Options C 81 Remote Print checkbox 2392 Emulation Options C 38 3274 Emulation Options C 56 5250 Emulation Options C 72 Ren Sockets Emulation Options screen Remote Sockets Emulation Protocol Options screen C 122 Remote Sockets Function Key Mapping screen C 32 Remote TxOn textbox Configure New RRM Group C 148 reset key D 2 Reset listbox Psion Teklogix 9500 Communications Server User Manual vii Index viii Boldface indicates a parameter name as it appears in the Configuration Program Italics indicates a screen name as described in the Web Interface Reference Guide HTML Function Key Mapping C 131 Restart Controller Software screen C 180 Restarting Confirmation screen C 180 RF Modem Emulation Options screen C 82 RF Modem Function Key Mapping screen C 130 C 132 RF Modem Telnet Protocol Options screen C 120 RFC 2109 D 20 RIGHT JUSTIFY flag for TEKFLAGS attribute D 15 RJ 45 connector pinouts A 3 RLE checkbox ANSI Emulation Options C 31 RRM Group Menu screen C 149 S S flag f
44. C 104 3274 SNA Protocol Options C 106 3274 Telnet Protocol Options C 100 5250 Emulation Options C 65 5250 Function Key Mapping C 129 5250 SNA Protocol Options C 114 5250 Telnet Protocol Options C 110 9010 Emulation Options C amp 1 oo fe TOE Mapping C 130 9010 Telnet Protocol Options C 119 screen elements button C 6 checkbox C 7 listbox C 7 radiobutton C 7 text link C 6 textbox C 7 Screen Size textboxes Index Boldface indicates a parameter name as it appears in the Configuration Program Italics indicates a screen name as described in the Web Interface Reference Guide HTML Emulation Options C 84 screens host application C 3 Send CR with FKEY checkbox 2392 Emulation Options C 34 Send IAC Break as an Attention Key checkbox 3274 Telnet Protocol Options C 103 Send IAC Interrupt Process as a System Request checkbox 3274 Telnet Protocol Options C 103 SERIAL flag for TEKFLAGS attribute D 5 Serial I O textbox 2392 Emulation Options C 42 3274 Emulation Options C 60 5250 Emulation Options C 77 Serial Number textbox Miscellaneous System Options C 177 service information II Session Cycle Key textbox ANSI Telnet Protocol Options C 92 Show Terminals button D Terminal Numbering C ShowSet button 3274 Telnet Terminal Naming C 105 Size of Poll Windows textbox Configure New RRM Group C 144 SNA Parameters screen C 172 C 176 Start Page textbox HTML Emulation Options C 84 lt STRIKE gt tag D 7 lt STRONG gt
45. Configuration Main Menu is pressed the CommServer checks the configuration database cache for errors then displays the Database Validation Results screen PTX Communications Server Validation Results Section Error Host Host Name Deanna 5250 Telnet does not meet the maximum character limit of 16 Host Name Cecil 9010 Telnet does not meet the maximum character limit of 16 Host Name Greg RFModem Telnet does not meet the maximum character limit of 16 users User Name Sam is less than 4 characters Commit Undo Cancel Any errors in the configuration are displayed in this screen Copyright 2002 Psion Teklogix Inc Commit Button Commit When the user presses the Commit button the CommServer writes the validated contents of its configuration cache to the permanent configuration store Note Once a configuration has been committed the CommServer 5 internal soft ware must be updated before the CommServer will run with the new configu ration To update the software press the Restart button on the Main Screen Undo Button When the user presses the Undo button the CommServer restores the last committed version of its configuration Psion Teklogix 9500 Communications Server User Manual C 181 Appendix C The 9500 CommServer s Web Interface Miscellaneous Commands 802 1Q v2 Features g Warning All changes made to the configuration of the CommServer since the last configuration was committed are
46. Create New User and Edit Existing User screens They are the same ones used to log into the CommServer s web interface C 178 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface C 2 12 Miscellaneous Commands Miscellaneous Commands 802 IQ v2 Features 2 12 1 Display Entire Database Contents PTX Communications Server Database Validation Results Database Key Type cell802 autostartup Boo cell802 beaconperiod Uint cell802 initialrtt Uint cell 92 protocol Uint cell802 timeout Uint httpd enabled Boo radiolinkfeatures cellular Boo radiolinkfeatures firstautotaddr Hint radiolinkfeatis oy wey un ULUS enum protocols tcpip snmp usesnmpd Boo rrmg 1 snmp rowstatus Vlist system rpc snmp port Vint protocols tcpip hosttable timeout length Vint protocols tcpip hosttable timeout type Enum rrmg 1 rrm 1 configured Boo rrmg 1 rrm 1 name ASCII aa a P z ca e ag ES Ea Eo 1 2 1 ma Psion Teklogix Value False 2 1000 2457 5 True True 1024 Disa True it 9555 600 Are Not Cached True Sport Copyright 2002 Psion Teklogix Inc In this screen the CommServer displays the contents of its configuration database This is the permanent database with which the CommServer booted Changes made to the configuration database are stored in a configuration cache which must be s
47. D 20 expiration of D 20 implementation in browsers D 20 punctuation in headers D 22 returned data for D 2 Set Cookie header D 19 transfer D 19 Create New User Entry screen C 173 CURSOR flag for TEKFLAGS attribute D 15 D D option for emulator debug D 7 Database Validation Results screen C 181 debug options for HTML emulator D 16 Delete button Conia Existing Base Station C 138 152 C 155 Edit Existing User Entry C 175 General Host Options C 25 C 108 C 118 a Telnet Terminal Numbering C 5 lt DIR gt tag D 9 Direct TCP Check Duplicate Terminal Number checkbox Radio Link Features C 162 Direct TCP Connections for TekTerm check box Radio Link Features C 162 Display Entire Database screen C 179 lt DIV gt tag D 8 lt DL gt tag D 9 lt DD gt tag D 9 lt DT gt tag D 9 E E option for emulator debug D 17 Echo checkbox ANSI Emulation Options C 29 Edit Existing User Entry screen C 174 Emulation and Protocol listbox Configure New Host C 21 General Host Options C 25 Emulation Options screen C 26 Enable Connect Screen checkbox 5250 SNA Protocol Options C 115 Enable Telnet Authorization checkbox Miscellaneous System Options C 178 Enabled checkbox Configure New Host C 20 Configure New RRM Group C 143 General Host Options C 24 Redundancy Parameters C 169 802 10 vl Features C 166 802 10 v2 Features C 167 Entry Line textbox Psion Teklogix 9500 Communications Server User Manual iii Index iv Bol
48. F14 F15 F16 F17 F18 F19 F20 F21 F22 F23 F24 F25 F26 F27 F28 F29 F30 Default F3 This listbox allows the user to select the function key which requests the next page from the CommServer This key works only if the user has previously pressed the Back function key Reset Listbox Values F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 F13 F14 F15 F16 F17 F18 F19 F20 F21 F22 F23 F24 F25 F26 F27 F28 F29 F30 Default F30 This listbox allows the user to select the function key which resets the connection between the terminal and the CommServer Psion Teklogix 9500 Communications Server User Manual C 131 Appendix C The 9500 CommServer s Web Interface CommServer Configuration The Base Station Screens The Function Key Mapping Screen 2392 9010 RF Modem Remote Sockets The Function Key Mapping Screen 2392 9010 RF Modem Remote Sockets e fe pam o2 o LOCA 1 2 PTX Communications Server ve Host RF Modem Function Keys A Greg 9 These parameters are not applicable to the RFModem emulation Cancel Copyright 2002 Psion Teklogix Inc The CommServer displays this or a similar version of the Function Key Mapping screen after the user selects one of the 2392 Telnet 9010 TCP IP RF Modem or Remote Sockets emulation protocol combinations for this host E Note The screen shown here gives the options for a host named G
49. F34 ENTER x Fa FB 7 F22 F22 7 F s ENTER x F9 Fg 7 F23 F23 z F36 ENTER z F10 F10 gt F24 F24 F37 ENTER x Fil Fil 7 Fes DOWN gt F38 SELECTOR 7 F12 F12 7 F26 F16 7 F39 ENTER x ale F13 Cancel Copyright 2002 Psion Teklogix Inc The CommServer displays this version of the Function Key Mapping screen after the user selects one of the 5250 Telnet or 5250 SNA emulation protocol combinations for this host E Note The screen shown here gives the function key options for a host named Bob Psion Teklogix 9500 Communications Server User Manual C 129 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The HTML Function Key Mapping Screen Function Key n Listbox Values ENTER NONE F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 F13 F14 F15 F16 F17 F18 F19 F20 F21 F22 F23 F24 PA1 PA2 PA3 PA4 ATTN CLEAR RESET SELECTOR SESS SYSREQ Default lt see text gt The function key textboxes allow the user to select a code that will be sent to the host when the user presses a function key on the terminal Each function key may be chosen from the same range of possible codes however each function key has a different default code The HTML Function Key Mapping Screen La E Rie a C co Gom ae O0 ee Co 1 2 PTX Communications Server ve HTML Function Key Mappings A Aline Home F1 z B
50. Passthru Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer allows the host to send data directly to the RF terminal s serial port This is most commonly used for printing Preparing Host Screens for Pass Through On the screen to be sent through the terminal serial port the word PASSTHRU in capital letters has to appear on the first line starting on the second column The actual data to be sent to the terminal may start anywhere below the first line With 5250 or 3274 emulations attributes occupy a position in the screen buffer An attribute placed between column 2 and the end of the word PASSTHRU will push all following characters one position to the right Therefore any required attributes should occupy column 1 of the first line Gust preceding the word PASSTHRU For example column 1 23456789 line 1 PASSTHRUG line 2 PART 12345 where is an attribute Psion Teklogix 9500 Communications Server User Manual C 35 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 2392 Emulation AA AA When the CommServer is finished sending the data to the terminal s printer it will send an ENTER key to the host The host must wait for the ENTER key before sending any more screens including other PASSTHRU screens to this terminal Note Refer to the Te
51. Remapping V Values None Blink Bold Reverse Default None This listbox allows the user to select how the CommServer renders underlined fields sent from the host Use International EBCDIC Checkbox Use International EBCDIC Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer will swap the positions of the and characters in the EBCDIC character table C 66 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation Terminal Protocol Listbox Terminal Protocol V Values TESS BCM HTML HTTP Default TESS BCM This listbox allows the user to select the protocol to be used for the connection between the terminal and the CommServer Terminals may connect through TESS or HTTP Connecting Through TESS Data compression And Caching Software l al i 2 Terminal Software F PTX Er Host Application Emulation Software TESS _ 3274 Base Terminal PTX CommServer Host Computer Terminals connecting through TESS take advantage of the CommServer s data caching and page saving software Psion Teklogix 9500 Communications Server User Manual C 67 Appendix C The 9500 CommSer
52. Remote Print Pages Transmit Line AIAG Visible Match Character Hidden Match Character Serial 1 0 Print Line Print Form Length Barcode Entry Line Field Overhead ANACOOACnessesces Command Region Cancel Copyright 2002 Psion Teklogix Inc Psion Teklogix 9500 Communications Server User Manual C 33 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 2392 Emulation The CommServer displays this version of the Emulation Options screen after the user has selected the 2392 Telnet emulation protocol combination for the host connection E Note The screen shown here gives the emulation options for a host named Elaine With HP 2392 emulation the CommServer converts the application datastream from the host to TESS TEklogix Screen Subsystem commands Some of the options in this screen govern this conversion of the host screens to TESS Send CR With FKEY Checkbox Send CR with FKEY Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer sends a carriage return after a function key Alarm Checkbox Alarm _ Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected terminals will beep when the word ALARM in capital letters appears on the application screen in the location specified by the Command Region
53. SS are hours minutes and seconds respectively This string is not enclosed in double quotes despite the fact that it contains spaces A web developer can generate this data string using the following UNIX command date utc a d Sb y T GMT TekHTML accepts day names in short and long form Wed or Wednesday However all of the Expires attribute is not currently processed due to the large amount of code needed to properly convert dates Instead TekHTML uses a hardcoded expiration period which is set to 1 year If the web developer needs cookies that actually expire he or she should use the new cookie standard with the Max Age nnn attribute D 6 2 4 Differences In Returned Data Netscape and Internet Explorer return only NAME VALUE pairs to the Web server RFC 2109 specifies however that almost all cookie attributes are returned prefixed with the character like this POST acme pickitem HTTP 1 1 Cookie S Version 1 Customer WILE E COYOTE Path acme some form data This long string is shown as being wrapped but it is actually all on one line If several cookies are returned it looks like this Psion Teklogix 9500 Communications Server User Manual D 21 Appendix D Developing HTML For The CommServer Implementation Of Cookies POST acme process HTTP 1 1 Cookie Version 1 Customer WILE E COYOTE Path acme Part_Number Rocket_Launcher_0001 SPath acme Ship
54. Teklogix provides a parameter analysis utility to help the adiminstrator set up the groups This utility is described in Section C 2 4 6 Analyze RRM Group see page C 156 Psion Teklogix 9500 Communications Server User Manual C 141 Appendix C The 9500 CommServer s Web Interface CommsServer Configuration The RRM Groups Screens 2 4 1 Configure New RRM Group PTX Communications Server Configure New RRM Group Psion Teklogix Name Unnamed RRM Group Communication Protocol TCP IP x Enabled Vv Auto Startup v Polling Protocol Parameters Number of Pall Windows 3 Size of Poll Windows 8 Maximum Message Segment Size 100 Number of Retries Collision Size Free Window Factor Message Mode Limit Callsign Period Haaa Callsign String Teklogix Radio Parameters Sync Delay Remote Txon QEP Active Channel Group Parameters Group 1 11 Group 2 OK Cancel Copyright 1999 2000 Teklogix Inc In this screen the user can set options for a new RRM group C 142 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens All of the RRMs in a group operate on the same frequency If there is more than one RRM in the group the CommServer causes them to transmit alternately Each RRM must be a member of an RRM group there may be more than one RRM
55. This textbox allows the user to enter the decimal representation of the ASCH character code of this special character A value of 0 zero disables this feature C 76 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation Serial 1 0 Textbox Serial I O cl Values 0 127 Default lt none gt Serial I O fields are special entry and fixed fields that accept input from and output to a serial port The application program distinguishes this field as Serial I O by preceding the field with a special character If this character precedes a fixed field the data will be sent to the terminal s serial port If it precedes an entry field the field accepts data from the terminal s serial port This textbox contains the decimal representation of the ASCII character code of this special character A value of 0 zero disables this feature Print Line Textbox Print Line O Values 0 24 Default lt none gt This textbox allows the user to enter the starting line number of the print page in the application screen A value of 1 causes the display page to be printed A value of 0 zero disables this feature Print Form Length Textbox Print Line yt Values 0 24 Default lt none gt This textbox allows the user to enter the printer s form length in lines Psion Teklogix 9500 Co
56. aad 256 2 0 is considered as a character with a code value of 0 Auto Login User ID Textbox Auto Login User ID Values any ASCII string acceptable to the host Max 15 characters Default lt none gt This textbox contains the user ID presented by the CommServer to the host for the auto login sessions Auto Login Password Textbox Auto Login Password Values any ASCII string acceptable to the host Max 15 characters Default lt none gt This textbox contains the password presented by the CommServer to the host for the auto login sessions Auto Login User ID Prompt Textbox Auto Login User ID Prompt Values any ASCII string Maximum 15 characters Default gin The CommServer compares the text in this textbox to the text presented to it by the host When they match the CommServer assumes that the host has just sent its request for a user name and it sends the username specified in the Auto Login User ID parameter to the host C 94 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen ANSI Emulation Telnet Protocol Note The match string should be as short as possible yet long enough to uniquely identify the user ID prompt It is strongly advised not to include multi part words separated by space characters since some hosts send out characters other t
57. additional characters will be sent to the host but not displayed Notes Terminals with the proper software version will respond to this query older terminals will ignore it e This parameter also determines whether an ANSI parameter query is sent to the terminal Smart echo also needs to be enabled at the terminal refer to the appro priate terminal user manual Function Key Remapping Checkbox Enabled Values lt selected gt lt unselected gt Default lt unselected gt Psion Teklogix 9500 Communications Server User Manual C 29 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen ANSI Emulation If this checkbox is selected the CommServer remaps the function keys for this host connection as defined in the ANSI Function And Arrow Key Remappings screen See Function Key Mapping on page C 123 Arrow Key Remapping Checkbox Enabled Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer remaps the arrow keys for this host connection as defined in the ANSI Function And Arrow Key Remappings screen See Function Key Mapping on page C 123 Page Checkbox Enabled V Values lt selected gt lt unselected gt Default lt selected gt If this checkbox is selected the CommServer uses page saving reducing data transmitted to the terminals
58. button The syntax of the remapping is lt INPUT TYPE TEXT FKEYONENTER n gt where n is the number of the function key to be invoked when the lt ENTER gt key is pressed in this field Psion Teklogix 9500 Communications Server User Manual D 13 Appendix D Developing HTML For The CommServer HTML Extensions For TESS D 4 HTML Extensions For TESS TekHTML uses TESS to communicate with the terminal and TESS has many useful features that are not accessible using standard HTML These features are accessible through the Psion Teklogix specific attribute TEKFLAGS This attribute is specified within the standard HTML lt INPUT gt tag for input fields or within a Psion Teklogix specific lt TEKLOGIX gt tag for output fields D 4 1 TEKFLAGS Within The lt INPUT gt Tag The syntax of the TEKFLAGS attribute within the lt INPUT gt tag is as follows lt INPUT TYPE TEXT TEKFLAGS xxx gt where xxx is a string of one character flags This tag specifies buttons or text fields which are translated by TekKHTML to TESS input fields Checkboxes and radio buttons are displayed by TekKHTML but do not work There is no closing tag for the lt INPUT gt tag D 4 2 TEKFLAGS Within The lt TEKLOGIX gt Tag The syntax of the TEKFLAGS attribute within the lt TEKLOGIX gt tag is as follows lt TEKLOGIX TEKFLAGS xxx gt text lt TEKLOGIX gt where xxx is a string of one character flags This tag specifies text which will be tr
59. character is entered as an ASCII value The mode character is derived by starting with the decimal value 48 ASCII character 0 and adding the appropriate value from the table below Code Meaning of Code 1 Prevent the AIAG prefix from being displayed 2 Prevent the AIAG prefix from being sent to the host 4 Cause a transmission to the host when all AIAG fields with this mode set are filled The transmission is sent by a Function 0 F0 code 8 Allow overwriting of previously entered data Start the search for a matching ALAG field at the current cursor position re Otherwise the cursor will start at the top of the page Table C 10 Mode values for the AIAG fields For example the symbol is used to apply the cursor matching function since adding 16 to 48 results in decimal value 64 which is the ASCII value for the character A value of 0 zero disables this feature C 74 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation Visible Match Character Textbox Visible Match Character Values 0 127 Default lt none gt With field matching the host computer preloads data into an entry field Now the terminal operator can make an entry that matches this preloaded data For visible match fields the preloaded data will be displayed in
60. character on the terminal screen The emulator uses this width value when formatting web pages to fit the terminal screen C 84 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen HTML Emulation Passthru Checkbox Passthru Values lt enabled gt lt disabled gt Default lt disabled gt If this checkbox is selected the CommServer allows the host to send data directly to the RF terminal s serial port This is most commonly used for printing TSF O Checkbox TSF O Values lt enabled gt lt disabled gt Default lt disabled gt When this parameter is enabled the host can use the Psion Teklogix Screen Formatter and Optimizer software Pages Textbox Pages Values 1 32 Default 8 The number of host screens or pages stored at the terminal The CommServer reduces data transmitted to the terminals by using the terminal s capability to store a page of data for each screen it displays The CommServer maintains an image of each page stored at the terminal After receiving an application screen the CommServer tries to match the screen with a stored page If a similar page is already in the terminal s memory the CommServer simply instructs the terminal to re display its copy of the page only the necessary changes are sent from the CommServer If no mat
61. for PPP console link 4 6 19687 null modem for PPP console link 3002186 null modem for PPP console link A 7 Callsign Period textbox Configure New RRM Group C 146 Callsign Text textbox Configure New RRM Group C 147 Cancel button Database Validation Results C 182 Character Width on the Terminal textbox HTML Emulation Options C 84 checkbox defined C 7 Clear checkbox 2392 Emulation Options C 34 3274 Emulation Options C 52 5250 Emulation Options C 69 Close Host Sessions on Terminal Reset checkbox ANSI Telnet Protocol Options C 90 Collision Size textbox Configure New RRM Group C 145 Index Boldface indicates a parameter name as it appears in the Configuration Program Italics indicates a screen name as described in the Web Interface Reference Guide command region commands for C 44 Command Region textboxes 2392 Emulation Options C 44 3274 Emulation Options C 62 5250 Emulation Options C 79 command line option fb D 12 ff D 12 fh D 12 fr D 12 commands in command region for 2392 C 44 Commit button Database Validation Results C 181 Configuration Main Menu screen C 14 Con ue Existing RRM Group screen C Configure Existing RRM screen C 154 Configure New Base Station screen C 133 Configure New Host screen C 19 Configure New RRM Group screen C 142 Configure New RRM screen C 153 connectors RJ 45 A 3 9 pin D A 4 Convert 7 to 8 Bits checkbox ANSI Emulation Options C 31 cookies Cookie header
62. gt C 42 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 2392 Emulation This textbox allows the user to enter the starting line number of the print page in the application screen A value of 1 one causes the display page to be printed A value of 0 zero disables this feature Print Form Length Textbox Print Line Values 0 24 Default lt none gt This textbox allows the user to enter the printer s form length in lines Barcode Textbox Barcode Values 0 127 Default lt none gt Barcode input only fields are special entry fields that only accept input from a bar code reader The application program distinguishes an entry field as barcode input only by preceding the field with a special character This textbox contains the decimal representation of the ASCII character code of this special character A value of 0 zero disables this feature Entry Line Textbox Entry Line Values 0 24 Default lt none gt This textbox contains the number of the first line displayed if there is no entry field in the upper left portion of the screen and if an entry field is at or below this line The Entry Line parameter allows an automatic offset within the host screen so that the area displayed by the terminal includes an entry field that would normally b
63. host emulations for Host 1 Since this range starts at 1 the offset for this host is zero and the RF terminal ID numbers will be identical to the host emulation numbers In the General Host Options screen for Host 2 Terminals 6 to 16 a range of 11 terminals or host emulations The lower B 18 Psion Teklogix 9500 Communications Server User Manual Appendix B Setting Terminal Numbers On The CommServer Setting The Terminal Range Base Stations number in the range host emulation 6 in this case is mapped to the first terminal on Host 2 and the higher number host emulation 16 in this case is mapped to the J th terminal on Host 2 an offset of 5 In the Configure Existing Base Station screen for Base Station 1 First Terminal 1 since this will map host emulation 1 to RF terminal ID 1 the offset for this Base Station is zero Thus host emulations 1 20 will match terminal ID numbers 1 through 20 In the Configure Existing Base Station screen for Base Station 2 First Terminal 8 creates a range of 13 terminals Host emulation 8 is mapped to RF terminal ID 1 an offset of 7 The upper range of terminals will be host emulation 20 RF terminal ID 13 Thus the result of this setup is Terminal ID 1 2 can communicate to Host 1 only when communicating via Base Station 1 or to both Host 1 and Host 2 when communicating via Base Station 2 Host Emulations on CommServer 12 3 4 5 67
64. in contrast to Host Print where the host makes the initial print request E Note Support for printing must be enabled at the terminal level Refer to the appro priate terminal user manual for more information C 72 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation Pages Textbox Pages Values 0 79 Default 8 The number of host screens or pages stored at the terminal The CommServer reduces data transmitted to the terminals by using the terminal s capability to store a page of data for each screen it displays The CommServer maintains an image of each page stored at the terminal After receiving an application screen the CommServer tries to match the screen with a stored page If a similar page is already in the terminal s memory the CommServer simply instructs the terminal to re display its copy of the page only the necessary changes are sent from the CommServer If no match is found the complete page is sent to the terminal over the radio link E Note There is a corresponding parameter on the terminal itself and the actual number of saved pages will be the smaller of the two values Transmit Line Textbox Transmit Line Values 0 24 Default lt none gt When this feature is enabled all modified data at the terminal will be automatically transmitted
65. not running If more than one host application is configured to present screens through HTML HTTP the CommServer displays a choice screen to browsers connecting at port 80 E Psion Teklogix Host Selection Screen Microsoft Internet Explorer provided by Psion Teklogix File Edit View Favorites Tools Help Back gt gt a address ja http 10 128 5 58 cqi bin host_sel exe Please select the host you wish to log on to 3274 host C 5250 Host Log onto selected host From this screen the user can choose the host to connect to The CommServer then displays the first application screen for that host C 4 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface The CommServer s Web Configuration Screens C 1 2 2 Limitations Of The Host Application Screens Due in part to the nature of the HTTP protocol used by web browsers these host screens suffer some limitations compared host screens transferred through TESS or ANSI protocols In particular the terminal s browser must request new screens and updates there is no way for the host to transfer information to the terminal without a request from the terminal These limitations include e Expedited messages a break message or screens that are sent by the host without prompting from the terminal will not be received by the web browser until the user sends data to the host for example b
66. of 50 on the Model S900L software only version of the CommServer since this version can handle a maximum of 50 terminals The defaults are 1 and 50 respectively in this case AN Important A range of 0 0 signifies that this feature is disabled Do not configure a range starting with zero and ending with a number greater than zero Automatic Terminal Number Assignment Textboxes Terminal numbers may be assigned automatically to up to five groups of terminals These groups are listed in this section starting with Group 1 the default group Each group has the following parameters Range Values lower upper 0 3840 0 3840 Default lower upper 0 0 Comment The Range parameter specifies specify the lower and upper allowed values of terminal numbers that will be assigned automatically to terminals in the group The Comment parameter allows the administrator to add a note about the group E Note This parameter has a upper value of 50 on the Model S900L software only version of the CommServer since this version of the software can handle a maximum of 50 terminals AN Important A range of 0 0 signifies that this feature is disabled Do not configure a range starting with zero and ending with a number greater than zero Psion Teklogix 9500 Communications Server User Manual C 163 Appendix C The 9500 CommServer s Web Interface CommServer Configuration Radio Link Features Help Button
67. or as a j percentage of total table width lt DL gt Definition list isa lt DT gt definition title She No indentation lt DD gt definition data PP Psion Teklogix 9500 Communications Server User Manual D 9 Appendix D Developing HTML For The CommServer Table List and Definition Tags A amp L Notes L Not all visual attributes are rendered on character mode terminals Some attributes are mapped into terminal attributes for instance strong to blink other are not used However all these video attributes are recorded during the page rendering The named anchor tag lt A NAME xxx gt and the corresponding use of the character in the reference tag lt A HREF xxx gt are not sup ported Text marked with the lt PRE gt tag wraps to the next line if it exceeds the width of the page It is possible to specify column widths in the lt TH gt and lt TD gt tags with the WIDTH attribute lt TD WIDTH 25 gt or lt TD WIDTH 200 gt Ifa percentage value is given TekHTML assumes that the value is meant as a percentage of the available space for the table on the screen Ifa numeric value is given TekHTML assumes that the value is a width in pixels It divides the value by the configured number of pixels per character value and uses the result as a column width Values less than zero are ignored Totals of pixels or of percentages greater than the table width are reduced to make the resul
68. parameter see page D 62 The word ALARM should be a display only field E Note The Command Region parameter must be enabled for this parameter to work Clear Checkbox Clear Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer creates an empty entry field for an entry field that is filled with spaces C 34 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 2392 Emulation Some host applications rely on the video attributes of displayed characters to highlight fields particularly entry fields For example the application screen may define all entry fields with reverse video and fill the field with spaces This is effective on terminals that support reverse video but on terminals that do not it can make the field invisible since it is made up entirely of spaces By default all empty entry fields displayed at the Psion Teklogix terminal are highlighted by the entry character chosen in the terminal s configuration not all Psion Teklogix terminals support video attributes The Clear feature creates an empty entry field in place of an entry field filled with spaces E Note This operation is only performed on screens received from the host Data sent to the host remains unaffected Passthru Checkbox
69. screen C 22 Host Name textbox 5250 SNA Protocol Options C 114 Host Port textbox ANSI Telnet Protocol Options C 90 i ne Protocol Options C 98 C 5250 Telnet Protocol Options C 111 Host Print checkbox 2392 Emulation Options C 37 3274 Emulation Options C 54 5250 Emulation Options C 71 Host Timeout textbox ANSI Emulation Options C 28 lt HR gt tag D 8 HTML function key mapping D J tags without function key support D 12 Teklogix extensions to D 14 HTML elements button C 6 checkbox C 7 listbox C 7 radiobutton C 7 text link C 6 textbox C 7 HTML Emulation Options screen C 83 HTML Emulation Protocol Options screen C 121 HTML emulator debug options D 16 HTMLLIB_ C 3 HTTP cookie header D 20 cookie implementation D 20 cookie transfer D 19 expiration of cookies D 20 host application screens via C 3 punctuation in cookie headers D 22 returned data for cookies D 2 Set Cookie header D 19 hyperlink mapping function key to D 11 lt H1 gt lt H6 gt tag D 7 I I flag for TEKFLAGS attribute D 15 ignored tags D 4 lt IMG gt tag D 6 lt INPUT gt tag D 6 D 14 Interface Number listbox Redundancy Parameters C 171 E as flag for TEKFLAGS attribute D IP Address textbox Base Station Connectivity TCP IP Options C 139 Configure Existing RRM C 153 C 154 L L option for emulator debug D 7 Last Active Session Key textbox ANSI Telnet Protocol Options C 92 Last Terminal mode parameter textbox 5250 SNA Protocol Options C 117
70. specifies the physical network interface through which the CommServer will send 802 IQ v2 beacon packets The CommServer may have up to two Ethernet interfaces The interface is identified by its index number and IP address C 2 7 Redundancy Options m L Coq ee Sol S gaz Gacy oo 1 2 PTX Communications Server Redundancy Parameters Ua al Psion Teklogix Enabled m Preferred Primary v Backup IP Address 612802 Alias IP Address pooo Alias Interface 0 Ethernet Change to 0 Ethernet 10 128 75 182 gt Arbiter 1 IP Address E Arbiter 2 IP Address Poll Interval s Poll Timeout 5 Poll Tries OK Cancel 1177 Copyright 2002 Psion Teklogix Inc In this screen the user can set various options for redundant operation of the CommServer This feature enables two similarly configured CommServers to operate in parallel One CommServer is designated as the primary CommServer and manages communication to the rest of the Psion Teklogix system The other CommServer is designated as the secondary CommServer and remains idle Both CommServers communicate with an arbiter another node which serves as a reference on the network C 168 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Redundancy Options 802 1Q v2 Features Both of the CommServers must be connected to the network and each CommServer is aware of
71. the entry field at the operator s terminal The application program distinguishes an entry field as a match field by preceding it with a special character The special character is entered as the decimal character code for one of the first 127 ASCII characters A value of 0 zero disables this match field feature For example assume that the gt character ASCII decimal character code 62 is defined for visible match fields This character must immediately precede the entry field Part gt The field Part gt includes the character gt and is followed by the part number entry field on the screen If any other character was chosen as the last character of the text the entry field would not be a match field The preloaded data sent to a terminal may consist of the exact characters special match characters or a combination of the two The match characters recognized by the Psion Teklogix terminals are shown in the table below For example suppose you wish to preload an entry field with a part number If the exact part number is known you may simply preload the field with that part number If more flexibility is required and part numbers always begin with two alphabetic characters followed by a hyphen character and four digits then the match string for the field could be amp amp H If an entry is different from the preloaded data the entry will be displayed the terminal will beep and the cursor will be in th
72. the other s IP address The secondary CommServer polls the primary CommServer and the primary CommServer responds exchanging information about their status There may not be more than one secondary CommServer If the secondary CommServer cannot communicate with the primary CommServer but can communicate with the arbiter it assumes that the primary CommServer is not working becomes primary and assumes control of the Psion Teklogix network When the first CommServer comes online again it assumes secondary status the second CommServer continues as the primary If the CommServers cannot communicate with the arbiter they assume that the network is not working Note When control of the Psion Teklogix system is passed from one CommServer to the other CommServer sessions between hosts and terminals are closed and terminals and bases are reset Both CommServers must be configured identically with the exception of their own IP addresses and the Backup IP Address parameter the address of the other CommServer Important The TCP Direct Connections To Host parameter must be enabled for Redundancy to work This parameter can be found on the Radio Link Features screen Enabled Checkbox Enabled Values lt selected gt lt unselected gt Default lt unselected gt When this checkbox is selected the CommServer uses the Redundancy feature A second CommServer appropriately configured and an arbiter must be pre
73. 0 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens Delete Button The Delete button allows the user to delete the RRM When it is pressed the CommServer displays a confirmation screen ve PTX Communications Server Delete RRM From Group Daphne Psion Teklogix Really delete RRM OK Cancel Copyright 1999 2002 Psion Teklogix Inc If the user presses the Cancel button on this screen the CommServer displays the Configure Existing RRM screen again If the user presses the OK button the CommServer removes the RRM s data from the configuration cache and displays a confirmation screen PTX Communications Server Data deleted successfully Psion Teklogix Data deleted successfully 0K Copyright 2002 Psion Teklogix Inc When the user presses the OK button in this confirmation screen the CommServer displays the RRM Group Menu The choice for the deleted RRM is no longer present in the RRMs listbox Psion Teklogix 9500 Communications Server User Manual C 155 Appendix C The 9500 CommServer s Web Interface CommsServer Configuration The RRM Groups Screens 2 4 6 Analyze RRM Group PTX Communications Server Analyze RRM Group Daphne Name Daphne Radio Link Protocol EXT cellular Psion Teklogix Polling Protocol Parameters
74. 2002 2004 Psion Teklogix Inc The CommServer displays this version of the Function Key Mapping screen after the user selects the ANS Telnet emulation protocol combination for this host This screen also includes arrow key mappings C 124 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The ANSI Function And Arrow Key Mapping Screen Note The screen shown here gives the function key options for a host named Gary Function Key n Listbox Fn M Values lt see text gt Default lt see text gt The function key textboxes allow the user to select a code that will be sent to the host when the user presses a function key on the terminal Each function key may be chosen from the same range of possible codes however each function key has a different default code A null entry terminates the map to sequence it is not necessary to transmit nulls Arrow Key Listbox lt arrow key name gt V Values lt see text gt Default lt see text gt The arrow key textboxes allow the user to select a code that will be sent to the host when the user presses one of the four arrow keys on the ANSI terminal There are four arrow key listboxes one for each of the Up Down Left and Right arrow keys Each arrow key may be chosen from the same range of possible codes however each arrow key has a different default code Arrow key re
75. 40 seconds If this checkbox is selected the CommServer monitors messages and polls from this connection if it does not receive a message or poll within 40 seconds it closes the connection E Note For older Unix handlers hosts this parameter should be deselected In all other cases this parameter should be selected Psion Teklogix 9500 Communications Server User Manual C 119 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen RF Modem Emulation Telnet Protocol The Protocol Options Screen RF Modem Emulation Telnet Protocol eo l0 1 PTX Communications Server ANSI Telnet Protocol Options Greg First Terminal Listen Port OK Cancel 0 oo000oL 2 E Psion Teklogix Copyright 2002 Psion Teklogix Inc The CommServer displays this version of the Protocol Options screen after the user has selected the RF Modem Telnet emulation protocol combination for this host connection E Note The screen shown here gives the emulation options for a host named Greg The RF Modem protocol is used with the Psion Teklogix Model 6040 RF Modem This device acts as a terminal on the Psion Teklogix network but data sent to it is forwarded through a serial port to another serially connected device Serial devices may thus communicate over the Psion Teklogix radio network See the Psion Teklogix 6040 RF Modem User Manual for detai
76. 500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen HTML Emulation The Emulation Options Screen HTML Emulation S Jl L L gaoU L U DUUOUNI a 7 R PTX Communications Server HTML Emulation Options Aline Psion Teklogix HTML Options Screen Size row x cal 24 x 80 Start Page http Character Width on the terminal in fe Pixels 8 TESS Options Passthru TSF O Pages Transmit Line 10025 Field Overhead OK Cancel Copyright 1998 2002 Teklogix Inc The CommServer displays this version of the Emulation Options screen after the user has selected the HTML emulation protocol combinations for this host connection E Note The screen shown here gives the emulation options for a host named Aline This emulation is intended for a CommServer interpreting HTML pages for terminals running TESS The CommServer transforms TESS requests to from the terminals into standard HTML requests and sends the HTML requests to a server Replies from the web server arrive in the form of HTML pages the CommServer translates these into equivalent TESS pages and sends them on to the terminals Psion Teklogix DOS based terminals communicating by TCP IP to access points do not require this emulation Psion Teklogix 9500 Communications Server User Manual C 83 Appendix C The 9500 CommSer
77. 8 9 10 11 12 13 14 15 16 17 18 19 20 2 2 8 9 Host 1 A Base Station 1 Terminal ID 1 e080 Base Station 2 Terminal ID 1 Figure B 16 Psion Teklogix 9500 Communications Server User Manual B 19 Appendix B Setting Terminal Numbers On The CommServer Setting The Terminal Range Base Stations Terminal ID 3 5 can communicate to Host 1 only when communicating via Base Station 1 or to Host 2 only when communicating via Base Station 2 Host Emulations on CommServer 123 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 34 5 Host 1 5 6 A Base Station 1 Terminal ID 1 OOGO Base Station 2 Terminal ID 1 Figure B I7 Terminal ID 6 9 can communicate to both Host 1 and Host 2 when communicating via Base Station 1 or to Host 2 only when communicating via Base Station 2 Host Emulations on CommServer 1 2 3456 7 8 9 10 11 12 13 14 15 16 17 18 19 20 6 7 8 9 Host 1 RA A AL LAL Ss 43 Base Station 1 Base Station 2 Terminal ID 1 eeo08 Terminal ID 1 Figure B 18 B 20 Psion Teklogix 9500 Communications Server User Manual Appendix B Setting Terminal Numbers On The CommServer Setting The Terminal Range Base Stations Terminal ID 10 16 can communicate to Host 2 only via Base Station 1 Host Emulations on CommServer 123 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 Host 1
78. 9500 Communications Server User Manual Part Two February 2 2005 Part No 8000008 B ISO 9001 Certified Quality Management System PisiifolN TEKLOGIX Copyright 2005 by Psion Teklogix Inc Mississauga Ontario This document and the information it contains is the property of Psion Teklogix Inc is issued in strict confidence and is not to be reproduced or copied in whole or in part except for the sole purpose of promoting the sale of Psion Teklogix manufac tured goods and services Furthermore this document is not to be used as a basis for design manufacture or sub contract or in any manner detrimental to the interests of Psion Teklogix Inc All trademarks are the property of their respective holders Return To Factory Warranty Psion Teklogix warrants a return to factory warranty for a period of 90 days from shipment or 120 days from shipment where Psion Teklogix installs the equipment The warranty on Psion Teklogix manufactured equipment does not extend to any product that has been tampered with altered or repaired by any person other than an employee of an authorized Psion Teklogix service organization See Psion Teklogix terms and conditions of sale for full details Service When requesting service please provide information concerning the nature of the failure and the manner in which the equipment was used when the failure occurred Type model and serial number should also be provided Before returning
79. C 180 C 2 12 3 Validate and Save Database Contents C 181 C 2 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Introduction C I Introduction This guide describes all the screens accessible through the web interface of the Psion Teklogix Communications Server C 1 1 About The 9500 CommServer s Web Interface The 9500 Communications Server presents a number of screens through a web interface These include e Host application screens from 3274 and 5250 hosts See Section C 1 2 on page C 3 e Configuration screens for the Psion Teklogix software See Section C 1 3 on page C 5 These interfaces require that a connection using Internet Protocol IP be made to the CommServer from another machine A web browser can then be used to view screens and make changes C 1 2 The CommServer s Host Application Screens To connect to the web based host application screens for the CommServer direct a browser to http lt IP Address gt 80 where IP Address represents the CommServer s IP address and 80 is TCP Port 80 the standard port for HTTP connections C 1 2 1 The Host Application Screens The 9500 CommServer will only present host application screens as web pages if a 3274 or 5250 host is configured to use the HTML HTTP protocol to send application screens to the terminal This is selected in the Protocol Options screen for that host emulation See the following page
80. Checkbox Configure LU Names Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected individual terminals can be assigned Logical Unit names when communicating with this 3274 host Terminal names can be configured in the Terminal Naming screen this is accessible through the Configure button See The 3274 Telnet Terminal Naming Screen on page C 104 LU Name Prefix Textbox LU Name Prefix Values lt see text gt Default lt none gt This textbox specifies the LU prefix to be prepended to terminal names when the Configure LU Names parameter is enabled The prefix can be up to three alphanumeric characters C 102 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 3274 Emulation Telnet Protocol Send IAC Interrupt Process As A System Request Checkbox Send IAC Interrupt Process as a System Request Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer sends the IAC Interrupt Process request to the host as a 3274 System Request Send IAC Break As An Attention Key Checkbox Send IAC Break as an Attention Key Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer sends the
81. Choices include users who are already granted access to the CommServer there is also a special Create New choice Pressing the Configure button displays the configuration screen for the selected user If Add Entry is selected the user may add a new user to the CommServer An entry for the new user is added to the listbox the new entry can then be configured in the same way as previously existing entries See System Configuration The Users Screens on page C 173 for details Miscellaneous System Options Configure Pressing the Miscellaneous System Options button displays the Miscellaneous System Options screen This screen contains settings for the CommServer s serial number and the maximum number of terminals allowed to connect to it See System Configuration Miscellaneous System Options on page C 177 for details Psion Teklogix 9500 Communications Server User Manual C 17 Appendix C The 9500 CommServer s Web Interface The Configuration Main Menu Screen C 2 1 5 Miscellaneous Commands From this section the user can check and save the CommServer s configuration or reboot the Psion Teklogix software in the CommServer Display Entire Database Contents Show All Pressing the Show All button causes the CommServer to display the entire contents of its configuration database See Display Entire Database Contents on page C 179 for details Restart Controller Software Reboot Pressing the Res
82. CommServer will join two adjacent fixed fields and then send them as one field This reduces the overhead on the radio link For example if two fields were 4 characters apart and this parameter was 5 then these fields would be joined into one This feature affects fields with the Normal display attribute only Command Region Textboxes Command Region 3 Values row values 0 24 column values 0 80 Default lt none gt These two pairs of textboxes define a region of the host screen which the CommServer will examine for the presence of reserved commands The first textbox of each pair contains the row number the second contains the column number These four numbers represent the row and column addresses of the upper left corner and the lower right corner of the command region To define the last two lines of the host screen as the command region for example enter the values 23 7 and 24 80 Currently the only commands supported in the command region are ALARM and FONT e When the word ALARM is placed anywhere within the command region the CommServer will send a TESS beep command to the terminal e When the word FONT is placed anywhere within the command region and followed by a number the font code the CommServer will send the appropriate TESS Change Font command to the terminal Psion Teklogix terminals use the font code to specify what font to use See Fonts And Font Codes on page
83. Delete Button The Delete button allows the user to delete the currently displayed base station connection When it is pressed the CommServer displays a confirmation screen PTX Communications Server Delete Base Station Velma Psion Teklogix Really delete Base Station Velma OK Cancel Copyright 2002 Psion Teklogix Inc If the user presses the Cancel button on this screen the CommServer displays the Configure Existing Base Station screen again If the user presses the OK button the CommServer removes the interface s data from the configuration cache and displays a confirmation screen PTX Communications Server Data deleted successfully Va a Psion Teklogix Data deleted successfully fick Copyright 2002 Psion Teklogix Inc When the user presses the OK button in this confirmation screen the CommServer displays the Configuration Main Menu The choice for the deleted base station connection is no longer present in the Base Stations listbox C 138 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommServer Configuration The Base Station Screens 2 3 4 Connectivity Options i aa Ua goil ii U QOUU000 N PTX Communications Server TCP IP Options for Base Station X Psion Teklogix IP Address 0 0 0 0 fieioo OK Cancel Copyright 2002 Psion Teklogix Inc The CommS
84. E 45 for a listing of fonts and font codes C 62 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 3274 Emulation Foreground Colour Listbox Foreground Colour V Values Aqua Black Blue Fuschia Gray Green Lime Maroon Navy Olive Purple Red Silver Teal White Yellow Default Black This listbox allows the user to select the foreground colour the colour of the text that the CommServer s HTTP server will send to terminals connecting via HTTP The choices are the 16 predefined HTML colour names Background Colour Listbox Background Colour V Values Aqua Black Blue Fuschia Gray Green Lime Maroon Navy Olive Purple Red Silver Teal White Yellow Default Silver This listbox allows the user to select the background colour the colour of the HTML page that the CommServer s HTTP server will send to terminals connecting via HTTP The choices are the 16 predefined HTML colour names User Data Font Size Listbox User Data Font Size V Values 1 2 3 4 5 6 7 Default 3 This listbox allows the user to select the size of the font in which user data will be presented to the terminals web browser Function Key Font Size Listbox Function Key Font Size V Values 4pt 6pt Spt 10pt 12pt 14pt Default 8pt
85. Emulation Options C 67 Terminal Range textboxes Configure New Host C 21 General Host Options C 25 Terminal Type listbox 5250 Telnet Protocol Options C 110 Terminal Typelistbox ANSI Telnet Protocol Options C 90 3274 Telnet Protocol Options C 100 text link defined C 6 textbox defined C 7 lt TH gt tag D 9 Threshold textbox ANSI Emulation Options lt TITLE gt tag D 5 lt TR gt tag D 9 Transmit Line textbox 2392 Emulation Options 3274 Emulation Options 5250 Emulation Options Transmit Lines textbox HTML Emulation Options C 86 TRANSMIT UPON ENTRY flag for TEK FLAGS attribute D 15 TSF O checkbox HTML Emulation Options C 85 2392 Emulation Options C 36 3274 Emulation Options C 54 C 64 a ee Options C 71 C 79 C 28 C 39 C 57 C 73 U U option for emulator debug D 7 lt U gt tag D 7 lt UL gt tag D 9 Undo button Database Validation Results C 181 unsupported tags D 4 Upper Character Set GR listbox Psion Teklogix 9500 Communications Server User Manual U U 3274 Emulation Options C 32 se International EBCDIC checkbox 5250 Emulation Options C 66 se International EBCDIC checkbox 3274 Emulation Options C 50 Jse SSCP Sessions checkbox 3274 SNA Protocol Options C 107 ser Data Font Size listbox 3274 Emulation Options C 63 5250 Emulation Options C 80 Jser Name textbox 5250 SNA Protocol Options C 115 Vv Validate button a Telnet Terminal Numbering C 5 Virtual Device Name Prefix textbox
86. First Local Terminal Port jooo Local IP Address to Bind booo First Terminal Listen Port Actively Negotiate with Host Auto telnet login Enable DISABLE Auto telnet Host Auto telnet Without User Action Negotiate Virtual Device Name with host provide prefix below 7 i Virtual Device Name prefix OK Cancel Copyright 2002 2003 Psion Teklogix Inc The CommServer displays this version of the Protocol Options screen when the user selects the emulation protocol combination of 5250 Telnet for this host EL Note The screen shown here gives the protocol options for a host named Deanna Terminal Type Textbox Terminal Type Values IBM 5251 11 IBM 5555 B01 Default IBM 5251 11 This textbox allows the user to select a terminal type which the CommServer will emulate C 110 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 5250 Emulation Telnet Protocol Host Port Textbox Host Port ss Values 1 32767 Default 23 This textbox allows the user to enter a host port value for the selected 5250 telnet host connection Maximum Sessions Per Terminal Textbox Maximum Sessions per Terminal Values 0 127 Default 4 This textbox contains the maximum number of telnet sessions which are allowed to originate from each terminal First L
87. IAC Break request to the host as a 3274 Attention Key Auto telnet login Enable Listbox Auto telnet login enable VW Values DISABLE AUTO TELNET Default DISABLE This listbox allows the user to choose whether auto telnet sessions are allowed to connect to this host Auto telnet Host Textbox Auto telnet Host Values lt any host ID gt Default lt none gt This parameter specifies a host ID to which auto telnet requests will be directed Auto Telnet Without User Action Checkbox Auto Telnet Without User Action M Values lt selected gt lt unselected gt Default lt selected gt Psion Teklogix 9500 Communications Server User Manual C 103 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The 3274 Telnet Terminal Naming Screen If this checkbox is selected the CommServer will attempt to connect to a configured Auto Telnet host by auto telnet whenever that host is available The 3274 Telnet Terminal Naming Screen Lo n i i m S20 W Cc co 1 E41 1 2 PTX Communications Server j ve 3274 Telnet Terminal Naming t 3274 r e __Psion Teklogix Terminal number 1 Terminal name Show Set Delete OK Validate Show Terminals Copyright 2002 2003 Psion Teklogix Inc The CommServer displays this screen after the user has pressed the Configure button next to the Configure LU Names param
88. M Group screen again If the user presses the OK button the CommServer removes the RRM group s data from the configuration cache and displays a confirmation screen PTX Communications Server Data deleted successfully Psion Teklogix Data deleted successfully ox Copyright 2002 Psion Teklogix Inc When the user presses the OK button in this confirmation screen the CommServer displays the Configuration Main Menu The choice for the deleted RRM connection is no longer present in the Configure RRM Group listbox C 152 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens 2 4 4 Configure New RRM a a Co Sou 5 eoe meg mm o O C4 1 2 PTX Communications Server Configure New RRM of Name Unnamed RRM IP Address 0 0 0 0 116132 OK Cancel Copyright 1999 2000 Teklogix Inc The CommServer displays this Configure RRM screen after the user has selected an existing RRM and pressed the Configure button Name Textbox Values lt see text gt Default Unnamed RRM This textbox allows the user to enter a name for the new RRM IP Address And Port Textboxes IP Address Values lt see text gt Default IP Address lt none gt Port 16132 These textboxes allow the user to enter the IP address and port number of the new RRM The IP address may be any valid IP addres
89. MITED TO THE IMPLIED WARRANTIES OR CONDITIONS OF MERCHANTABLE QUALITY OR FITNESS FOR A PARTICULAR PURPOSE YOU ASSUME THE FULL RESPONSIBILITY FOR THE SELECTION USE AND PERFORMANCE OF THE SOFTWARE 7 Limitation of Liability We are liable for no more than the value of the license fee that you paid for the Software This limitation is cumulative and our responsibility for multiple claims will not exceed in aggregate this limit Under no circumstances are we or our third party suppliers liable for damages of third parties claimed against you or for harm to your records or data or special incidental indirect or consequential damages including but not limited to lost profits lost business revenue or failure to realize expected savings even if you informed us of their possibility or for any delay in delivering or furnishing the Software This limitation applies whether you are entitled to claim damages from us Psion Teklogix 9500 Communications Server User Manual E 5 Appendix E Software License Agreements For Psion Teklogix Software or our third party suppliers as a matter of contract or tort Some countries states do not allow the limitation or exclusion of liability for incidental or consequential damages so the above limitation or exclusion may not apply to you We are not liable to you for any delay or non performance caused by contingencies beyond our reasonable control including without limitation fire embargoes third par
90. On Terminal Reset Checkbox Close Host sessions on Terminal reset Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected all host sessions will be closed when the termiunal resets If the checkbox is unselected the sessions will remain open if the terminal resets C 90 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen ANSI Emulation Telnet Protocol First Local Terminal Port Textbox First Local Terminal Port Values 1 32767 Default 0 This textbox specifies the port number from which the CommServer attempts a telnet connection for the first terminal Additional telnet sessions are assigned higher port numbers This parameter only takes effect if the Local IP Address to Bind parameter is specified A N Important Do not set the first local terminal port to 16100 Port 16100 is used as a listen port by hosts using Psion Teklogix 9010 protocol Local IP Address To Bind Textbox Local IP Address to Bind _ _ lt Values lt any valid IP address gt Default lt none gt This textbox specifies the IP address of the CommServer interface that connects to this host It is used along with the local port numbers to create a unique socket for each terminal session First Terminal Listen Port Textbox First Terminal Listen P
91. S amp q Auto telnet Terminal Prompt Press ENTER to login S Auto login User ID l Auto login Password isd Auto login User ID prompt linn Auto login Password prompt Wod o Auto login failed login fincorect Auto telnet Without User Action T Auto telnet Without User Action Timing Delay 5 Maximum of Auto telnet Retries Do Vv Allow TCP Sessions _OK Cancel Copyright 2002 2003 Psion Teklogix Inc Psion Teklogix 9500 Communications Server User Manual C 89 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen ANSI Emulation Telnet Protocol The CommServer displays this version of the Protocol Options screen when the user selects the emulation protocol combination of ANSI Telnet for this host E Note The screen shown here gives the emulation options for a host named Daevid Terminal Type Listbox Terminal Type V Values VT 100 VT 220 Default VT 100 This listbox specifies the type of terminal to be emulated by the CommServer Host Port Textbox Host Port Values 1 32767 Default 23 This textbox specifies the value for the host port for the selected ANSI host connection Maximum Sessions Per Terminal Textbox Maximum Sessions per Terminal Values 1 127 Default 4 This textbox specifies the maximum number of telnet connections allowed to and from each terminal Close Host Sessions
92. SNA operation E Note Most of the SNA options in the CommServer are set through the IBM Per sonal Communications software Network Name Textbox Network Name Values lt see text gt Default APPN C 172 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface System Configuration The Users Screens 802 1Q v2 Features This textbox contains the name of the SNA network to which the host and the CommServer are connected The network name is a maximum of eight alphanumeric ASCII characters beginning with a letter If less than eight characters it is padded to eight characters with spaces at the right C 2 9 System Configuration The Users Screens Users listbox on Configuration Main Menu Create New 1 sue tm Create New User Entry 21 mick Edit Existing User Entry The user administration screens of the CommServer are accessible from the Users listbox and selection button 2 9 1 Create New User Entry PTX Communications Server New User Name fuser Password 123456 OK Cancel Copyright 2002 Psion Teklogix Inc In this screen the user can set options for a new user Psion Teklogix 9500 Communications Server User Manual C 173 Appendix C The 9500 CommServer s Web Interface System Configuration The Users Screens 802 1Q v2 Features Name Textbox Na
93. T should be defined as display only text The print page is positioned below the terminal s display page see the following figure The size of the print page is always the same as the terminal s display page assuming that in the terminal s configuration the page length is less than 12 lines When Host Print is enabled the CommServer passes the print page to the terminal after receiving the application screen from the host Display Page 8 x 40 WODINHUOPWNEH 14 PRINT Print Page 8 x 40 Figure C 6 Application Screen With Print Page E Notes 1 Unlike with the Passthru option when using Host Print no escape commands can be sent to the printer 2 Support for printing must be enabled at the terminal refer to the appropriate terminal user manual for more information Psion Teklogix 9500 Communications Server User Manual C 55 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 3274 Emulation Remote Print Checkbox Remote Print Values lt selected gt lt unselected gt Default lt unselected gt When this parameter is enabled the CommServer sends the print page to a terminal whenever the terminal requests it by sending the F17 function key from the terminal or the PRINT key on older terminals The CommServer sends the function response back to the host This is in contrast
94. The Help button links to a help screen that clarifies the use of the Automatic Terminal Number Assignment feature ELA Notes 1 The terminal numbers configured through the Terminal Range parameters for each host emulation must be within this range if that host is to use automatically assigned terminal numbers 2 The Total Number of Terminals parameter in the Miscellaneous System Options screen must be larger than the highest upper value in any group of this parameter 3 Terminals not assigned to a group will poll after those in groups C 164 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommServer Configuration 802 1Q v1 And v2 Features C 2 6 CommServer Configuration 802 1Q vl And v2 Features dl za g 0 QUUU000 PTX Communications Server ve 802 IQ version 1 and version 2 Configuration Psion Teklogix 802 IQ vi v2 Common Features Auto Startup Vv Terminal Offline Timeout 5 2 Beacon Period 802 19 vi Features Enabled Vv Beacon Gateway Interface Configured 1 Ethernet 0 Ethernet 00 02 63 91 51 0c Protocol Type ID 2476 802 19 v2 Features Enabled O Beacon UDP port 8888 Beacon Gateway Interface Configured 0 Ethernet 0 Ethernet 10 128 75 182 10 128 75 182 0 Ethernet 10 128 75 182 OK Cancel Copyright 2002 2004 Psion Teklogix Inc 802 10 vI v2 Common Features Au
95. Vv Emulation and Protocol 1 3274 Telnet he Terminal Range 1 tay 32 OK Cancel Copyright 2002 Psion Teklogix Inc When the user chooses the Add Host selection host from the Hosts listbox and then presses the Configure button the CommServer displays the Configure New Host screen In this screen the user can set a name for set an emulation and protocol for and enable a new host Psion Teklogix 9500 Communications Server User Manual C 19 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens Protocols Protocols are the methods by which terminals communicate with host computers The CommServer supports the TCP IP and SNA protocols Protocols can operate over various physical media such as wired Ethernet or radio connections Emulations Working with Psion Teklogix terminals and base stations the CommServer can emulate IBM model 3277 3278 2 5251 11 and 5555 B01 terminals as well as ANSI terminals Only certain combinations of emulation and protocol are supported TCP IP SNA 2392 yes 3274 yes yes 5250 yes yes ANSI yes Name Textbox Name Values lt any text string gt Default Unnamed Host This textbox allows the user to enter a name for the new host E Note The name must not contain space characters Enabled Checkbox Enabled 7 Values lt selected gt lt unselected gt Default lt selected gt If this
96. ack F2 x Forward F3 z Reset F30 OK Cancel Copyright 1998 2000 Teklogix Inc The CommServer displays this version of the Function Key Mapping screen after the user selects HTML emulation for this host E Note The screen shown here gives the function key options for a host named Aline The Forward Back and Home function keys correspond to similar Forward Back and Home buttons in a standard web browser The Reset key resets the connection between the terminal and the CommServer C 130 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The HTML Function Key Mapping Screen Home Listbox Values F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 F13 F14 F15 F16 F17 F18 F19 F20 F21 F22 F23 F24 F25 F26 F27 F28 F29 F30 Default F1 This listbox allows the user to select the function key which requests the default page In TekHTML browser emulation this requests the start page defined in the Emulation Options screen see page C 83 Back Listbox Values F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 F13 F14 F15 F16 F17 F18 F19 F20 F21 F22 F23 F24 F25 F26 F27 F28 F29 F30 Default F2 This listbox allows the user to select the function key which requests the previously viewed page from the CommServer Forward Listbox Values F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 F13
97. ages to be loaded as local TESS procedures in the terminals The local procedures are selected from a menu at the terminal The terminals can perform these procedures when they are offline Later when the terminals are online they send the results of these functions to the host E Note The Procedures parameter also must be enabled for Local to work TSF O Checkbox TSF O L Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer uses Psion Teklogix Screen Formatter Optimizer software Host Print Checkbox Host Print Values lt selected gt lt unselected gt Default lt unselected gt C 54 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 3274 Emulation When this parameter is enabled the host can send extra data to the terminal s screens and instruct the terminal to print it This is in contrast to the Local Print feature where the terminal makes the initial print request The text that is passed to the printer is formatted into the 24 x 80 application screen If the host can initiate the print operation the text is printed The CommServer identifies the additional text as a print page by the presence of the word PRINT in capital letters beginning in the 2nd column of line 13 on the 24 x 80 screen The word PRIN
98. ain Menu button the CommServer displays the Configuration Main Menu Psion Teklogix 9500 Communications Server User Manual C 135 Appendix C The 9500 CommServer s Web Interface CommsServer Configuration The Base Station Screens 2 3 3 General Options sei a co E m C g a oH Se a Cig Co EN 1 2 PTX Communications Server ve Configure Base Station Velma Psion Teklogix Name Mema Protocol 1 TCP IP First Terminal i Message Size ho Auto Startup Vv OK Cancel Delete Copyright 2002 Psion Teklogix Inc In this screen the user can select general options for this base station The base station may also be deleted E Note The screen shown here gives the configuration options for a base station named Velma Name Textbox Name Values lt any text string gt Default Unnamed Base Station This textbox allows the user to enter a name for the base station C 136 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommServer Configuration The Base Station Screens Protocol Listbox Type V Values TCP IP Default TCP IP This listbox allows the user to select the protocol to be used for the connection to this base station Currently only the TCP IP protocol is available First Terminal Textbox First Terminal Values 1 3840 lt see text gt Default 1 This textbox a
99. al Type JIBM 3278 2 z Host Port z3 Maximum Sessions per Terminal j First Local Terminal Port fioooo Local IP Address to Bind 0 0 0 0 First Terminal Listen Port fo Actively Negotiate with Host O Configure LU names oO Configure LU Name Prefix l Send IAC Interrupt Process as a System Request O Send IAC Break as a Attention Key O Auto telnet login Enable DISABLE z Auto telnet Host Auto telnet Without User Action OK Cancel The CommServer displays this version of the Protocol Options screen when the user selects the emulation protocol combination of 3274 Telnet for this host AL Note The screen shown here gives the protocol options for a host named 3274 Terminal Type Listbox Terminal Type V Values IBM 3278 2 Default IBM 3278 2 C 100 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 3274 Emulation Telnet Protocol This textbox allows the user to choose the type of terminal to be emulated by the CommServer for this host At present there is only one choice of terminal for 3274 Telnet the IBM 3278 2 Host Port Textbox Host Port Values 1 32767 Default 23 This textbox allows the user to enter a host port value for the selected 3274 telnet host connection Maximum Sessions Per Terminal Textbox Maximum Sessions per Terminal
100. amount of any other actual direct damages up to the charges for the Program SOME JURISDICTION DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY SO THE ABOVE LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU YOU MAY HAVE OTHER RIGHTS WHICH VARY FROM STATE TO STATE OR JURISDICTION TO JURISDICTION 3 GENERAL You agree to comply with all applicable export and import laws Ifthe Program is acquired in the United States this Agreement is governed by the laws of the State of New York Ifthe Program is acquired in Canada this Agreement is governed by the laws of the Province of Ontario If the Program is acquired outside of the United States or Canada then the law of the country in which you acquired the Program will apply subject to certain exceptions as determined by IBM The United Nations Convention on Contracts for International Sale of Goods shall not apply Psion Teklogix 9500 Communications Server User Manual E 9 APPENDIX F SUPPORT SERVICES AND WORLDWIDE OFFICES Psion Teklogix provides a complete range of product support services to its custom ers worldwide These services include technical support and product repairs F I Technical Support Technical Support for Mobile Computing Products is provided via e mail through the Partner Program website To reach the website go to www psionteklogix com and click on the Partner Program link which takes you to the Partner Program page Then click on the Log in button or
101. any products to the factory call the Customer Services Group for a Return Authorization number Support Services Psion Teklogix provides a complete range of product support services to its customers For contact information and a listing of worldwide offices please refer to Appendix F Support Services And Worldwide Offices Disclaimer Every effort has been made to make this material complete accurate and up to date Psion Teklogix Inc reserves the right to make changes without notice and shall not be responsible for any damages including but not limited to consequential damages caused by reliance on the material presented including but not limited to typographical errors TABLE OF CONTENTS Appendices Appendix A Ports Pinouts And Cable Diagrams A l RJ 45 Connector Pinout 2 2 ee ee ee A 3 A 2 Serial Connector Pinout 9 pin 2 20040 A 4 A 3 Cable Descriptions 2 ee A 5 Appendix B Setting Terminal Numbers On The CommServer Bele Introduction ys reio aa wha ols RR Pee ete Ronee ae ee a B 3 B 1 1 The General Host Options Screen B 3 B 1 2 The Configure Existing Base Station Screen B 4 B 2 Setting The Terminal Range Hosts 04 B 4 B 2 1 Systems With One Host B 5 B 2 2 Systems With Multiple Hosts B 6 B 3 Setting The Terminal Range Base Stations B 9 Appendix C The 9500 CommServer s Web In
102. any text string gt Default Unnamed Host This textbox allows the user to enter a name for the host E Note The name must not contain space characters Enabled Checkbox Enabled M Values lt selected gt lt unselected gt Default lt selected gt If this checkbox is selected the CommServer will enable the connection to this host as it boots C 24 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens Emulation and Protocol Listbox Emulation and Protocol V Values Configure New 3274 Telnet 3274 SNA 5250 Telnet 5250 SNA ANSI Telnet 9010 Telnet 2392 Telnet RF Modem Telnet HTML Remote Sockets Default 3274 Telnet This listbox allows the user to select the emulation and protocol to be used for the connection to this host Only certain combinations of emulation and protocol are available Terminal Range Textboxes Terminal Range Values lt see text gt Default I soc 32 These textboxes allow the user to specify the range of terminals which will communicate with this host The left hand textbox contains the lowest terminal number which is allowed to communicate with the host the right hand textbox contains the highest terminal number Terminal numbers may range from 1 to 3840 E Note The Model S900L software only version of the CommServer can handle a maximum of 50 term
103. ata received successfully OK Update LU Session Information Copyright 2002 Psion Teklogix Inc This screen includes the following button Psion Teklogix 9500 Communications Server User Manual C 107 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 3274 Emulation SNA Protocol Update LU Session Information Button Update LU Session Information The Update LU Session Information button allows the user to update the information being passed to the CommServer s SNA software When the Update LU Session Information button is pressed the CommServer displays an Update Confirmation screen PTX Communications Server Confirm Update The following information will be used to update the LU session configuration Property Value PCOMM file to be updated C IBMPCOMM private dummy acg First Terminal 1 Last Terminal 32 LU Prefix LUB PU Name for LUs leave blank unless multiple PUs have been configured Update Cancel td gt Copyright 2002 Psion Teklogix Inc This screen lists the information that will be changed in the CommServer s SNA configuration e The path and filename of the configuration file that will be updated This is the configuration file that has been selected as the default in the SNA software See page 165 e The terminal number of the first terminal for this host emulation e The terminal number of
104. ation and Protocol 1 3274 Telnet z Terminal Range i a B2 OK Cancel Delete Copyright 2002 Psion Teklogix Inc The General Host Options screen contains the Terminal Range parameter for the host It varies slightly depending on the name of the host To obtain this screen 1 Select the desired host from the Hosts listbox on the CommServer s Configuration Main Menu 2 Press the Configure button next to the Hosts listbox The CommServer displays the Host Menu 3 Press the Configure button next to General Options on the Host Menu The CommServer displays the General Host Options screen See General Host Options on page C 23 for more information about this screen Psion Teklogix 9500 Communications Server User Manual B 3 Appendix B Setting Terminal Numbers On The CommServer The Configure Existing Base Station Screen B 1 2 The Configure Existing Base Station Screen PTX Communications Server ve Configure Base Station A Velma A Name Nema Protocol 1 TCP IP x First Terminal i Message Size ho Auto Startup Iv ok Cancel Delete Copyright 2002 Psion Teklogix Inc The Configure Existing Base Station screen contains the First Terminal parameter for the base station To obtain this screen 1 Select the desired base station from the Base Stations listbox on the CommServer s Configuration Main Menu 2 Press the Configure button next to the Base Stations listbox The CommServer dis
105. ation and protocol selected for the host There is also a Main Menu button When the user presses this button the CommServer displays the Configuration Main Menu 2 2 3 General Host Options o 7 o S go ci e Co Coc a 1 2 PTX Communications Server General Host Options Fred Name Fea tS Enabled Vv Emulation and Protocol 1 3274 Telnet E Terminal Range i a fe OK Cancel Delete Copyright 2002 Psion Teklogix Inc In this screen the user can select general options for this host connection The host connection may also be deleted Protocols Protocols are the methods by which terminals communicate with host computers The CommServer supports the TCP IP and SNA protocols Psion Teklogix 9500 Communications Server User Manual C 23 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens Protocols can operate over various physical media such as Ethernet Token Ring synchronous serial and asynchronous serial connections as well as wireless radio link connections Emulations Working with Psion Teklogix terminals and base stations the CommServer can emulate IBM model 3277 3278 2 5251 11 and 5555 B01 terminals as well as ANSI terminals Only certain combinations of emulation and protocol are supported TCP IP SNA 2392 yes 3274 yes yes 5250 yes yes ANSI yes Name Textbox Name _ Values lt
106. ation screen for Base Station 1 First Terminal 10 creates a range of 11 terminals Host emulation 10 is mapped to RF terminal ID 1 The other terminals follow in sequence finishing with host emulation 20 RF terminal ID 11 Psion Teklogix 9500 Communications Server User Manual B 11 Appendix B Setting Terminal Numbers On The CommServer Setting The Terminal Range Base Stations In our diagram we align the first terminal on Base Station with host emulation 10 Host Emulations on CommServer 10 11 12 13 14 15 16 17 18 19 20 Base Station 1 riy2y3la slel7 8 9 fiofit A Terminal ID 1 Range of Base Station 1 begins at host emulation 10 Figure B 7 Since the range on Base Station 1 is partial to the total number of host emulations there will be terminal numbers for which no matching host emulation is found terminal 12 20 in our example If you set a terminal ID to any of these numbers you will not be able to communicate with the host E Note The situation depicted in this example is not a practical one and is shown here just to demonstrate the effect of an offset on a base station One host with two base stations In this system we will define the ranges In the General Host Options screen for Host 1 Terminals 1 to 20 a range of 20 terminals or host emulations Since this range starts at 1 the offset for this host is zero In the Configure Existing Base Station screen for Base S
107. ault 3 These three parameters Poll Interval Poll Timeout and Poll Tries are closely related Psion Teklogix 9500 Communications Server User Manual C 171 Appendix C The 9500 CommServer s Web Interface System Configuration SNA Parameters 802 1Q v2 Features This CommServer when acting as the secondary CommServer polls the primary CommServer at intervals specified by the Poll Interval parameter After each poll this CommServer waits for a reply It waits for a time specified by the Poll Timeout parameter If there is no reply during this interval the CommServer sends another poll to the other CommServer The total number of polls sent while this CommServer waits for the other CommServer to respond is specified by the Poll Tries parameter If no response is received to any of the polls this CommServer then pings the arbiter If the CommServer receives a ping reply from the arbiter but cannot contact the other CommServer it assumes that the other CommServer is off the network becomes primary and takes control of the Psion Teklogix system If this CommServer cannot reach the other CommServer or the arbiter it assumes that the network is not working and remains in secondary mode 2 8 System Configuration SNA Parameters NOUN PTX Communications Server SNA Parameters Network Name AAPPN OK Cancel Copyright 2002 Psion Teklogix Inc In this screen the user can set an option for the CommServer s
108. aved before the CommServer can use the changes Not all of the screen is shown here Psion Teklogix 9500 Communications Server User Manual C 179 Appendix C The 9500 CommServer s Web Interface Miscellaneous Commands 802 IQ v2 Features C 2 12 2 Restart The CommServer Software When the user presses the Restart button the CommServer displays the Restart Controller Software screen J JL U M0000 PTX Communications Server z Restart Controller Software A Really restart the PTX Communications Server controller software OK Cancel Copyright 2002 Psion Teklogix Inc OK Button When the user presses the OK button the CommServer displays the Restarting Confirmation screen and then restarts the Psion Teklogix software inside the CommServer This restart is not an operating system reboot The Restarting Confirmation Screen The CommServer sends this screen to the browser then restarts the Psion Teklogix Communications Server software Restarting takes approximately 5 minutes OK Button After the CommServer has rebooted pressing the OK button in this screen causes the CommServer to display the Main Configuration Screen C 180 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Miscellaneous Commands 802 1Q v2 Features C 2 12 3 Validate and Save Database Contents When the Validate button in the
109. bar code data The data preloaded into the AIAG field by the application program determines whether the bar code data is accepted The format of the preloaded data is lt mode gt lt AIAG prefix gt The application program distinguishes an entry field as AIAG by preceding the field with a special mode character which denotes the existence of AIAG fields on the host screen This character is entered as an ASCII value Psion Teklogix 9500 Communications Server User Manual C 39 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 2392 Emulation The mode character is derived by starting with the decimal value 48 ASCII character 0 and adding the appropriate value from the table below Code Meaning of Code 1 Prevent the AIAG prefix from being displayed 2 Prevent the AIAG prefix from being sent to the host 4 Cause a transmission to the host when all AIAG fields with this mode set are filled The transmission is sent by a Function 0 F0 code 8 Allow overwriting of previously entered data 16 Start the search for a matching AIAG field at the current cursor position Other wise the cursor will start at the top of the page Table C 2 Mode values for the AIAG fields For example the symbol is used to apply the cursor matching function since adding 16 to 48 results in decimal value 64 which is the ASCII value for the characte
110. box is selected the CommServer sends its data in Fujitsu format Enabling this parameter causes the standard IBM formatting codes for start of field setting buffers etc to be replaced by the codes used by Fujitsu host computers Use International EBCDIC Checkbox Use International EBCDIC Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer uses the international EBCDIC character set swapping the positions of the and characters Terminal Protocol Listbox Terminal Protocol V Values TESS BCM HTML HTTP Default TESS BCM This listbox allows the user to select the protocol to be used for the connection between the terminal and the CommServer Terminals may connect through TESS or HTTP C 50 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 3274 Emulation Connecting Through TESS Data compression And Caching Software b Y NSI Terminal Software PTX TESS Host Application Emulation Software 3274 Base Terminal PTX CommServer Host Computer Terminals connecting through TESS take advantage of the CommServer s data caching and page saving software Connecting Through HTTP
111. ch is found the complete page is sent to the terminal over the radio link E Note There is a corresponding parameter on the terminal itself and the actual number of saved pages will be the smaller of the two values Psion Teklogix 9500 Communications Server User Manual C 85 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen HTML Emulation Transmit Lines Textbox Transmit Lines Values 0 24 Default 0 When this feature is enabled all modified data at the terminal will be automatically transmitted when the operator enters data into a transmit upon entry field The value in this textbox specifies the line on the screen which is designated the transmit line The last entry field above or on the transmit line on the screen will be identified as the transmit upon entry field If any entry fields exist on lines below the transmit line no entry field will be designated as the transmit upon entry field A value of 0 zero disables this feature Field Overhead Textbox Field Overhead Values 1 80 Default 5 This textbox specifies the maximum number of characters allowed between two fixed fields The HTML emulator joins two adjacent fixed fields separated by this many or fewer characters then sends them as one TESS field This reduces the overhead on the radio link For example if two fields were 4 characters apart and this parameter was 5 the
112. checkbox is selected the CommServer will enable the connection to this host as it boots C 20 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens Emulation and Protocol Listbox Emulation and Protocol V Values Configure New 3274 Telnet 3274 SNA 5250 Telnet 5250 SNA ANSI Telnet 9010 Telnet 2392 Telnet RF Modem Telnet HTML Remote Sockets Default 3274 Telnet This listbox allows the user to select the emulation and protocol to be used for the connection to this host Only certain combinations of emulation and protocol are available Terminal Range Textboxes Terminal Range Values lt see text gt Default I soc 32 These textboxes allow the user to specify the range of terminals which will communicate with this host The left hand textbox contains the lowest terminal number which is allowed to communicate with the host the right hand textbox contains the highest terminal number Terminal numbers may range from 1 to 3840 EL Note The Model S900L software only version of the CommServer can handle a maximum of 50 terminals so its highest terminal number is 50 Psion Teklogix 9500 Communications Server User Manual C 21 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens C 2 2 2 The Host Menu Cc CI es Ea a E E A Co
113. d are to disable auto telnet to enable auto telnet and to enable auto telnet and auto login When auto telnet is disabled telnet sessions from the terminals to the host must be initiated manually from the terminals When auto telnet is enabled the CommServer initiates one telnet session from each terminal whose terminal number is mapped to this host Additional telnet sessions may be initiated from each terminal to the host but they must be initiated manually E Note Auto telnet sessions are only initiated for terminals which are online that is turned on and operating properly on the Psion Teklogix RF network C 92 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen ANSI Emulation Telnet Protocol When auto telnet and auto login are enabled the CommServer initiates one telnet session from each terminal whose terminal number is mapped to this host It then logs each session in to the host using the username and password provided in this screen Note The usename and password is identical for all auto telnet sessions automatically logged in to this host Auto Telnet Host Textbox Auto Telnet Host Values valid host name or IP address Default lt none gt This textbox contains the host name or IP address for the host to which the CommServer connects auto telnet sessions Note A h
114. d listbox HTML Function Key Mapping C 131 fr command line option D 12 Free Window Factor textbox Configure New RRM Group C 146 function key back D 12 forward D 12 home D 12 mapping for HTML emulation D 11 mapping to button D 1 mapping to hyperlink D 1 predefined D 2 reset D 12 tags without support for D 2 Function Key Font Size listbox 3274 Emulation Options C 63 5250 Emulation Options C 80 Function Key Mapping screen C 123 Function Key n listbox ANSI Function Key Mapping C 125 3274 Function Key Mapping C 128 5250 Function Key Mapping C 130 Function Key Remapping checkbox ANSI Emulation Options C 29 Function key zero F0 D 13 FO function key zero D 13 F1 function key 1 D 12 F2 function key 2 D 12 F3 function key 3 D 12 F30 function key 30 D 12 G General Host Options screen C 23 General Options screen C 136 Group textboxes Configure New RRM Group C 148 H H Index Boldface indicates a parameter name as it appears in the Configuration Program Italics indicates a screen name as described in the Web Interface Reference Guide option for scheme debug D 18 lt HEAD gt tag D 5 heading tag D 7 Help button Radio Link Features C 164 helpdesk Z Z Hidden Match Character textbox 5250 Emulation Options C 76 Hidden Match Characters textbox 2392 Emulation Options C 42 3274 Emulation Options C 60 home key D 2 Home listbox HTML Function Key Mapping C 131 host application screens C 3 Host Menu
115. debug information for all schemes This includes the C H M P R and T types Psion Teklogix 9500 Communications Server User Manual D 17 Appendix D Developing HTML For The CommServer Automatic Terminal Response Feature C Show connection specific debug information the connection status and information transfer status H Show host data debug information prints host data received by the scheme M Show timestamping information from the scheme P Show protocol specific debug information such as HTTP encoding and decoding R Show debug information concerning the response to an HTTP request from the web server T Show debug information generated by the execution of program threads in the scheme code D 5 3 Automatic Terminal Response Feature In order to automate testing during development the HTML emulator has an automatic response feature This can be enabled for terminals in a specified range of terminal numbers If the automatic response feature is enabled and a terminal receives a screen from the host the emulator will immediately request another page on behalf of that terminal The pages are requested from URLs stored in a text file the name of this file can be specified on the command line using the af lt filename gt option This file is stored in the C tekhtml1 directory A range of terminals can be specified for autoresponse using the at lt t1 gt lt t2 gt option Not all terminals need to be configured
116. describing TekKHTML s operation This debug output from the TekKHTML emulator may be sent to a file or to the console screen To configure the emulator to send this debug output to a file start it with the option DF It then logs debug output messages to the file iledebu log This file is located in the install directory of the TeKHTML program It is overwritten every time the emulator is restarted To configure the emulator to send this debug output to the screen start it with the option dc All debug messages are then printed to the DOS window This option is only useful when TekHTML is not running as a Windows NT service The emulator has a variety of debugging options available listed below which enable the creation of debug messages for various actions They can be enabled singly or in combination There are two types of debug messages Emulator debug messages relate to TekHTML s parsing and translation of HTML source text Scheme debug messages relate to the operation of the connection between the emulator and the server which provides it information D 5 1 Emulator Debug The TekHTML option d lt type gt starts the logging of emulator debug messages The lt type gt can be one or more of the following A Show all emulator debug information This includes all of the B C D E F L M 0 P R S T U and X types B Show table debug information Prints out debug about the parsing and creation of tables Show debug in
117. dface indicates a parameter name as it appears in the Configuration Program Italics indicates a screen name as described in the Web Interface Reference Guide C 43 C 61 C 78 2392 Emulation Options 3274 Emulation Options 5250 Emulation Options Escape Overhead textbox 2392 Emulation Options 3274 Emulation Options Escape Timeout textbox ANSI Emulation Options F F option for emulator debug D 7 fb command line option D 12 ff command line option D 12 fh command line option D 12 Field Overhead textbox HTML Emulation Options C 86 5250 Emulation Options C 78 Field Underline Remapping listbox 5250 Emulation Options C 66 First Local Terminal Port textbox ANSI Telnet Protocol Options 2392 Telnet Protocol Options 3274 Telnet Protocol Options 5250 Telnet Protocol Options First Terminal Listen Port textbox ANSI Telnet Protocol Options C 91 RF Modem Protocol Options C 121 2392 Telnet Protocol Options C 98 3274 Telnet Protocol Options C 102 5250 Telnet Protocol Options C 111 First Terminal textboxes Configure Existing Base Station C 137 Configure New Base Station C 134 First Terminal mode parameter textbox 5250 SNA Protocol Options C 117 FKEY attribute D 11 FKEYONENTER attribute D 13 flags for TEKFLAGS attribute D 15 Foreground Colour listbox C 44 C 62 C 28 C 91 C 98 C 101 C 111 Psion Teklogix 9500 Communications Server User Manual 3274 Emulation Options C 63 5250 Emulation Options C 79 forward key D 12 Forwar
118. displays this version of the Protocol Options screen after the user has selected the 3274 SNA emulation protocol combination for this host connection C 106 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 3274 Emulation SNA Protocol Note The screen shown here gives the protocol options for a host named Eleanor Attention Key Listbox Attention Key V Values ENTER ATTN Default ENTER This listbox specifies the character sent back to the host when the user presses the lt ATTN gt function key on a Psion Teklogix terminal Note The actual key used at the terminal to obtain the lt ATTN gt function key is configurable through the Function Key Mapping screen for this host connection Use SSCP Sessions Checkbox Use SSCP Sessions Values lt selected gt lt unselected gt Default lt selected gt This checkbox indicates the type of sessions that can be used When this parameter is selected the CommServer will attempt to establish an SSCP LU session for a terminal before establishing an LU LU session Depending on the type of host an SSCP LU session may or may not be created When this parameter is not selected only LU LU sessions will be used When the OK button is pressed the CommServer displays a confirnmation screen PTX Communications Server Data pier received successfully D
119. e for one of the first 127 ASCII characters An entered value of 0 zero disables this match field feature For example assume that the gt character ASCII decimal character code 62 is defined for visible match fields This character must immediately precede the entry field Part gt C 58 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 3274 Emulation The field Part gt includes the character gt and is followed by the part number entry field on the screen If any other character was chosen as the last character of the text the entry field would not be a match field The preloaded data sent to a terminal may consist of the exact characters special match characters or a combination of the two The match characters recognized by the Psion Teklogix terminals are shown in the table below For example suppose you wish to preload an entry field with a part number If the exact part number is known you may simply preload the field with that part number If more flexibility is required and part numbers always begin with two alphabetic characters followed by a hyphen character and four digits then the match string for the field could be amp amp If an entry is different from the preloaded data the entry will be displayed the terminal will beep and the cursor will be in the first positi
120. e the following link invokes a hyperlink to the web address http www teklogix com when the terminal user presses the lt F8 gt key lt A HREF http www teklogix com FKEY 8 gt D 3 1 2 Mapping A Function Key To A Button Use the following syntax lt INPUT TYPE SUBMIT NAME lt BUTTON NAME gt VALUE lt BUTTON VALUE gt FKEY n gt where n is the number from 1 to 30 of the desired function key The following input tag submits the form to the HTTP server when the terminal user presses the lt F8 gt key lt INPUT TYPE SUBMIT NAME OK BUTTON VALUE OK FKEY 8 gt Psion Teklogix 9500 Communications Server User Manual D 11 Appendix D Developing HTML For The CommServer Tags Without Function Key Support D 3 2 Tags Without Function Key Support The FKEY attribute may not be used within certain anchor lt A gt and input lt INPUT gt tags The FKEY attribute may not be used within the named anchor tag lt A NAME somename gt because the named anchor tag does not specify a link It may not be used within certain lt INPUT gt tags as well some because of their nature such as lt INPUT TYPE HIDDEN3 others because of limitations of the emulator such as lt INPUT TYPE CHECKBOX gt The emulator prints a message to the debug console or file if such invalid tags are encountered The incorrect function key event is ignored D 3 3 Predefined Function Keys Certain function keys are predefined their action can not be altered T
121. e first position of the match field Psion Teklogix 9500 Communications Server User Manual C 75 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation Now either another entry in the match field can be made or the cursor can be moved to a new field When an entry even if it doesn t match the host s preloaded data is made in a match field this entry will be sent to the host as part of the terminal s modified data during the next transmission Match Character Use match a number amp match a letter either case match an upper case letter match a lower case letter match an alphanumeric character n match a letter number or space match a punctuation character T match any character match all character positions in the field with the preceding character match any remaining characters but not necessarily the remainder of the field with the preceding character Table C 11 Match Characters Hidden Match Character Textbox Hidden Match Character Values 0 127 Default lt none gt A special character is used to mark Hidden Match fields in a TESS screen This character precedes the field contents of the Hidden Match field In hidden match fields as opposed to visible match fields the preloaded entry is not displayed in the entry field at the operator s terminal
122. e host screen as the command region for example enter the values 23 7 and 24 80 Currently the only commands supported in the command region are ALARM and FONT e When the word ALARM is placed anywhere within the command region the CommServer will send a TESS beep command to the terminal e When the word FONT is placed anywhere within the command region and followed by a number the font code the CommServer will send the appropriate TESS Change Font command to the terminal Psion Teklogix terminals use the font code to specify what font to use See Fonts And Font Codes on page E 45 for a listing of fonts and font codes C 44 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens Fonts And Font Codes Fonts And Font Codes Many Psion Teklogix terminals use a font code to specify what font to use These font codes can be sent to the terminal by placing FONT followed by the code in the command region The font code can be expressed as a decimal number or as a TESS representation of a decimal number When a valid FONT statement is found in the command region the font code is stored with the page When that page is sent to the terminal an appropriate TESS Change Font command is also sent to the terminal causing the terminal to use the specified font if available The following font code table gives e the font code of each font
123. e out of bounds Normally Psion Teklogix terminals only display the upper left corner of the application screen because of their smaller display size Psion Teklogix 9500 Communications Server User Manual C 43 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 2392 Emulation Field Overhead Textbox Field Overhead _ Values 0 80 Default 5 This textbox contains the maximum number of characters allowed between two fixed fields which still allows the CommServer to join them into one field Sometimes the CommServer will join two adjacent fixed fields and then send them as one field This reduces the overhead on the radio link For example if two fields were 4 characters apart and this parameter was 5 then these fields would be joined into one This feature affects fields with the Normal display attribute only Command Region Textboxes Command Region 3 Values row values 0 24 column values 0 80 Default lt none gt These two pairs of textboxes define a region of the host screen which the CommServer will examine for the presence of reserved commands The first textbox of each pair contains the row number the second contains the column number These four numbers represent the row and column addresses of the upper left corner and the lower right corner of the command region To define the last two lines of th
124. eated as a TESS output field when it is translated into a TESS datastream by TekHTML and passed to the terminal Only the TEKFLAGS attributes S and I may be used with the lt TEKLOGIX gt tag The lt TEKLOGIX gt tag has a closing tag lt TEKLOGIX gt D 14 Psion Teklogix 9500 Communications Server User Manual Appendix D Developing HTML For The CommServer The Flags For The TEKFLAGS Attribute D 4 3 The Flags For The TEKFLAGS Attribute The flags are given in Table D 2 Flag Meaning A AUTOTAB Move the cursor to the next field when this one is filled B BARCODE Allow data input from scanner only C CURSOR Place the cursor in this field when the page is first dis played INVISIBLE Do not display this field This attribute may be used to hide buttons and text and leave only the input fields accessible This flag may be used within both the lt INPUT gt tag and the lt TEK LOGIX gt tag NUMBER Accept only numeric data in this field RIGHT JUSTIFY Place text against right hand side of field SERIAL Send and receive data through the terminal s serial I O port When used within the lt INPUT gt tag this flag makes the specified text input field a TESS serial input field When used within the lt TEKLOGIX gt tag this flag makes the specified text a TESS serial output field See the TESS manual for details TRANSMIT UPON ENTRY Generate an FO event when data
125. ection If Create New is selected the user may choose a new base station to add to the listbox the new base station connection can then be configured in the same way as previously existing choices See CommServer Configuration The Base Station Screens on page C 132 for details RRM Groups 1 Unnamed RRM Group v Confiqure The RRM Groups listbox allows the user to select a group of RRMs Choices include RRM groups already configured for this CommServer and a special Create New choice Psion Teklogix 9500 Communications Server User Manual C 15 Appendix C The 9500 CommServer s Web Interface The Configuration Main Menu Screen Pressing the Configure button displays the configuration screen for the selected RRM group If Create New is selected the CommServer displays a configuration screen for the new RRM group The user may choose RRMs to add to the new RRM group See CommServer Configuration The RRM Groups Screens on page C 140 for details Radio Link Features Configure Pressing the Radio Link Features button displays a number of configuration options related to the radio link See CommServer Configuration Radio Link Features on page C 160 for details 802 10 vl And v2 Features Configure Pressing the 802 10 v1 And v2 Features button displays a number of configuration options related to the radio link See CommServer Configuration 802 IQ v1 And v2 Features on page C 165 for details C
126. ely rare situations call for offsets on base stations UNDER NORMAL CIRCUMSTANCES NO OFFSET SHOULD BE SET EXTREME CAUTION IS ADVISED WHEN USING OFFSETS The offset capability was introduced to accommodate very rare situations such as e Host software that requires the terminal numbers to start at a number significantly higher than 1 If the Psion Teklogix terminal ID numbers were changed to this higher range more response windows would be required This would cause an increase in the response time e A necessity for duplicate terminal ID numbers in two or more remote sites where there is no chance of interference between the base stations B 10 Psion Teklogix 9500 Communications Server User Manual Appendix B Setting Terminal Numbers On The CommServer Setting The Terminal Range Base Stations Examples One host with one base station with offset Host Emulations on CommServer 12 3 4 5 67 8 9 10 11 12 13 14 15 16 17 18 19 20 2 3 4 5 6 7 8 9 10 12 22 13 24 15 16 17 18 1920 Base Station 1 fat2t3y4islel7 e 9 l10f12 A Terminal ID Numbers A Terminal ID 1 Terminal ID 11 Figure B 6 In this system we will define the ranges In the General Host Options screen for Host 1 Terminals 1 to 20 a range of 20 terminals or host emulations Since this range starts at 1 the offset for this host is zero In the Configure Existing Base St
127. ent be modified If any provision of this Agreement is deemed invalid or unenforceable by any country that particular provision will be deemed modified to the extent necessary to make the provision valid and enforceable and the remaining provisions will remain in full force and effect Failure by us to insist on strict performance or to exercise a right when entitled does not prevent us from doing so at a later time either in relation to that default or any subsequent one This Agreement will be binding upon and inure to our benefit and to the benefit of our respective successors and assigns Psion Teklogix 9500 Communications Server User Manual E 7 Appendix E Software License Agreements For IBM Personal Communications Software E 2 For IBM Personal Communications Software END USER LICENSE AGREEMENT FOR IBM SOFTWARE PROGRAM The Psion Teklogix products contain certain IBM software program Program By using the Program you agree to the terms of this End User License Agreement Agreement 1 LICENSE The Program is owned by IBM or its supplier and is copyrighted and licensed not sold This Agreement grants you a non exclusive license to use one copy of the Program only in conjunction with the Psion Teklogix products Except as expressly provided in this Agreement you shall have no rights in the Program 2 RESTRICTIONS a You may not use copy modify or distribute the Program b You may not reverse assemble
128. enters data into a transmit upon entry field The value in this textbox specifies the line on the screen which is designated the transmit line The last entry field above or on the transmit line on the screen will be identified as the transmit upon entry field If any entry fields exist on lines below the transmit line no entry field will be designated as the transmit upon entry field A value of 0 zero disables this feature A value of 2 causes the ast entry field on each application screen to be defined as transmit upon entry AIAG Textbox AIAG Values 0 127 Default lt none gt This textbox contains the decimal value of the ASCII character code of the AIAG mode character as described below Whenever bar code data is entered at a terminal the terminal searches for AIAG fields on the current page that can accept the bar code data The data preloaded into the AIAG field by the application program determines whether the bar code data is accepted The format of the preloaded data is lt mode gt lt AIAG prefix gt The application program distinguishes an entry field as AIAG by preceding the field with a special mode character which denotes the existence of AIAG fields on the host screen This character is entered as an ASCII value Psion Teklogix 9500 Communications Server User Manual C 57 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Opti
129. er is a Psion Teklogix RF Equipment the Software has been pre installed at factory and no media will be provided to you Ifthe Computer is not a Psion Teklogix RF Equipment the Software will be provided to you in a media and it will be your responsibility to install the Software on the Computer b provide you with one 1 copy of the Documentation and c permit you to make additional copies of the Documentation for your own internal business purposes in connection with the Use of the Software without charge 4 Action You May Take Under this License a If you receive a media with the Software you may make one 1 machine readable copy of the Software solely for backup or archival purposes provided that you 1 reproduce the copyright notice s and any other legend s of ownership on each copy or partial copy and ii maintain current records thereof including written records of the location of the Computer and authorized Use of the Software for audit purposes to ensure compliance with this Agreement given reasonable notice to conduct inspection and audit of such records in a manner not to interfere unreasonably with your normal business activities b You may permanently transfer the Software license from one Computer to another Computer running on the same operating system provided that you are not using the Software concurrently on more than one Computer You are required to obtain a separate license for each Computer on which the Sof
130. erver displays the Connectivity Options screen after the user has selected pressed the Connectivity Options button IP Address and Port Textboxes IP Address Values lt see text gt Default IP Address lt none gt Port 16100 These textboxes allow the user to enter an IP address and port number for the base station The IP address may be any valid IP address the port number can range from 1024 to 32767 Psion Teklogix 9500 Communications Server User Manual C 139 Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens C 2 4 CommServer Configuration The RRM Groups Screens RRM Groups V RRM Groups listbox on Configuration Main Menu 1 Example Group V Create New Configure New RRM Group 1 Example Group a RRM Groups Menu The RRM Groups screens of the CommServer are accessible from the RRM Groups listbox and selection button The RRMs in each group transmit on the same frequency alternately The CommServer coordinates the transmissions so that no RRMs transmit at the same time This is different from base stations where the timing of the radio transmissions is controlled only by the base stations themselves See CommServer Configuration The Base Station Screens on page E 132 for more information on configuring base stations To add RRMs first create a new RRM group through
131. eter Terminal Number Textbox Terminal Number Values 1 lt number of configured terminals gt Default lt none gt This textbox specifies the number of the terminal which will receive the name in the Terminal Name textbox Terminal Name Textbox Terminal Name Values lt see text gt Default lt none gt C 104 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The 3274 Telnet Terminal Naming Screen This textbox specifies an LU name for the terminal This name can contain no more than 1 5 alphanumeric characters If no terminal name is specified here for a terminal the 9500 will append the terminal number as five digits with leading zeros if necessary to the LU Prefix to create the full LU terminal name Show Set Button Show Set Press the Show Set button to display the LU name associated with a terminal number If you have just entered a terminal number and LU name press this button to add the terminal number and LU name to the list of configured terminals Delete Button The Delete button allows the user to delete the currently displayed terminal number and LU name from the list When it is pressed the 9500 displays a confirmation screen Press OK in this screen to delete the terminal name and number from the list OK Button The OK button saves changes to the database When it is p
132. f the RRMs These parameters include the radio baud rate and the transmit on time These parameters are compared against the values returned by other RRMs within the same group Error messages are displayed should these values not match but the worst case value is then chosen for use Warning THE RADIO PARAMETERS ARE PRE CONFIGURED FOR YOUR SYSTEM AND SHOULD NOT BE CHANGED without a proper understanding of how it affects the radio link Sync Delay Textbox Sync Delay Values 3 45 Default 28 Psion Teklogix 9500 Communications Server User Manual C 147 Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens This textbox allows the user to specify the number of delay characters inserted between the RRM s transmission and the first response window Remote TxOn Textbox Remote TxOn Values 3 60 Default 13 This textbox allows the user to specify the number of fill characters sent by the terminals to their radios before the terminals send message data Active Channel Textbox Active Channel Values 1 20 Default 1 This textbox allows the user to specify the radio channel to be used by all the RRMs in the RRM group Group Parameters Group Textboxes Group 1 Group 2 Values lt see text gt Default lt none gt These textboxes allow the user to specify RRM subgroups If the coverage areas of two or
133. formation about cookie parsing and storage D 16 Psion Teklogix 9500 Communications Server User Manual X Appendix D Developing HTML For The CommServer Scheme Debug Show debug information generated from the creation of the web page structure This option generates lots of debug information Show HTML parser debug information This relates to the initial parsing of the web pages Show forms debug information Show table layout debug information This option generates lots of debug information Show debug information generated by the main emulator routines general debug Show debug information involving internal HTML objects one object per tag or block of text Show placement debug information about placement of items on the screen This option generates extreme amounts of debug information Show debug information generated when the emulator receives a response from the web server Show scheme specific debug information generated by the emulator not the scheme itself Show TESS specific debug information generated by the TESS library interface Show debug information generated when an unsupported tag is seen Currently not all unsupported tags generate a message Show debug information generated by the TSX library interface D 5 2 Scheme Debug The TekHTML option s lt type gt starts the logging of scheme debug messages The lt t ype gt can be one or more of the following A Show all scheme
134. ftware PTX re Host Application Emulation Software Base Terminal 9500 CommServer HTTP Server Host Computer This emulation can handle HTTP datastreams with the following limitations e Graphics fonts and stylesheets are not supported Frames are not supported e Some HTML tags are not supported lt LAYER gt lt MAP gt etc e Paragraph alignment is not supported e HTML pages may not exceed the height of the terminal screen The emulator attempts to display such screens but only the first part of the page is displayed There is no way to scroll to other parts of the page e The emulator uses HTTP 1 0 e Only http and file access protocols schemes are supported e Only unencrypted connections are supported e User authentication is not supported e MIME types sent by the web server are not used e Drop down list boxes radio buttons and checkboxes are not supported e Advanced features of Web servers like redirection are not supported Psion Teklogix 9500 Communications Server User Manual D 3 Appendix D Developing HTML For The CommServer Supported HTML Tags D 2 Supported HTML Tags The Psion Teklogix HTML emulator accepts the tags described in Section D 2 1 to Section D 2 4 and uses them to display text Other tags are unsupported or ignored Unsupported Tags Tags not mentioned in these
135. ftware See page 208 The LU prefix for terminals using the QPCSUPP mode and which terminals are using it When the Update button is pressed the CommServer changes the configuration file and displays a confirmation screen similar to this screen PTX Communications Server Update Results Psion Teklogix C Program Files IBM Personal Communications private sna3274 acg was successfully updated for terminal range 1 32 x Copyright 2002 Psion Teklogix Inc Press OK in this screen to return to the Main Menu C 118 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 9010 Emulation Telnet Protocol The Protocol Options Screen 9010 Emulation Telnet Protocol 000000 PTX Communications Server Host 9010 Cecil 9010 Telnet Options Monitor Polls r OK Cancel Copyright 2002 Psion Teklogix Inc The CommServer displays this version of the Protocol Options screen after the user has selected the 9010 Telnet emulation protocol combination for this host connection Note The screen shown here gives the emulation options for a host named Bob Monitor Polls Checkbox Monitor Polls M Values lt selected gt lt unselected gt Default lt selected gt Hosts usually send messages or null polls to the CommServer within a period of approximately
136. ge is sent to the terminal over the radio link E Note There is a corresponding parameter on the terminal itself and the actual number of saved pages will be the smaller of the two values C 38 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 2392 Emulation Transmit Line Textbox Transmit Line fal Values 0 24 Default lt none gt When this feature is enabled all modified data at the terminal will be automatically transmitted when the operator enters data into a transmit upon entry field The value in this textbox specifies the line on the screen which is designated the transmit line The last entry field above or on the transmit line on the screen will be identified as the transmit upon entry field If any entry fields exist on lines below the transmit line no entry field will be designated as the transmit upon entry field A value of 0 zero disables this feature A value of 2 causes the ast entry field on each application screen to be defined as transmit upon entry AIAG Textbox AIAG Values 0 127 Default lt none gt This textbox contains the decimal value of the ASCII character code of the AIAG mode character as described below Whenever bar code data is entered at a terminal the terminal searches for AIAG fields on the current page that can accept the
137. han space characters to present a space on the screen Auto Login Password Prompt Textbox Auto Login Password Prompt Values any ASCII string Maximum 15 characters Default word The CommServer compares the text in this textbox to the text presented to it by the host When they match the CommServer assumes that the host has just sent its request for a password and it sends the password specified in the Auto Login Password parameter to the host Note The match string should be as short as possible yet long enough to uniquely identify the password prompt It is strongly advised not to include multi part words separated by space characters since some hosts send out characters other than space characters to present a space on the screen Auto Login Failed Prompt Textbox Auto Login Failed Prompt Values any ASCII string Maximum 15 characters Default incorrect The CommServer compares the text in this textbox to the text presented to it by the host When they match the CommServer assumes that the host has just sent a string informing the terminal of a failed login attempt The CommServer then presents the Auto Telnet Terminal Prompt on the terminal s screen to request the user to login manually The match string should be as short as possible yet long enough to uniquely identify the failed login prompt Psion Teklogix 9500 Communications Server User Manual C 95 Appendix C The 9500 CommServer
138. haracters recognized by the Psion Teklogix terminals are shown in the table below For example suppose you wish to preload an entry field with a part number If the exact part number is known you may simply preload the field with that part number If more flexibility is required and part numbers always begin with two alphabetic characters followed by a hyphen character and four digits then the match string for the field could be amp amp If an entry is different from the preloaded data the entry will be displayed the terminal will beep and the cursor will be in the first position of the match field Now either another entry in the match field can be made or the cursor can be moved to a new field When an entry even if it doesn t match the host s preloaded data is made in a match field this entry will be sent to the host as part of the terminal s modified data during the next transmission Match Character Use match a number amp match a letter either case match an upper case letter match a lower case letter match an alphanumeric character m match a letter number or space match a punctuation character match any character match all character positions in the field with the preceding character match any remaining characters but not necessarily the remainder of the field with the preceding character Psion Teklogix 9500 Communications Server User Manual
139. he arrangement of all of the CommServer s Web screens on all of the map pages the screen or screens referenced on that particular page are coloured black Baa Screens on page of the map i 7 a Screens on page 2 of the map This key is also provided with the descriptions of the individual screens following page C 14 The individual screen is coloured black here Screens on page of the map es s ELA Screens on page 2 of the map The screen referenced by this key Pai The screens referenced by this key In some places in the CommServer s web interface the user can choose an item from a listbox then press a corresponding button The CommServer then displays a screen corresponding to the item in the list The displayed screen is one of a number of related screens one for each item in the list If the user can add new items to the list there is a selection labeled appropriately in the listbox Choosing this item and pressing the button opens a screen that allows the new item to be configured In some cases it is necessary to return to the main menu to configure additional properties for the new item In
140. he restrictions on your Use of the Software ii you fail to make any payment when due to us or one of our affiliates or iii your rights are assigned by you by operation of law or otherwise E 6 Psion Teklogix 9500 Communications Server User Manual Appendix E Software License Agreements For Psion Teklogix Software Upon termination all license fees paid by you are non refundable You agree to return or destroy all copies of the Software and Documentation as well as any other Proprietary Information in your possession within fourteen 14 days of the date of termination Any rights and obligations under this Agreement that by their nature continue after it ends will remain in effect until they are completed 11 Notices Notices can be delivered to our address stated below or delivered by electronic communication including facsimile and internet e mail Notice will be effective two 2 business days after confirmed receipt Either of us may change our address for notice by giving reasonable notice of this to the other Psion Teklogix Inc 2100 Meadowvale Boulevard Mississauga ON L5N 7J9 Canada Attention Director Contracts 12 General The laws of the Province of Ontario and the federal laws applicable therein excluding the conflict of laws provisions govern this Agreement This Agreement may only be modified by written agreement signed by duly authorized representatives expressing their intention that this Agreem
141. hen the terminal resumes activity it sends a warm initialization message to the CommServer to re establish communication This parameter is related to the Percent Polling Protocol Terminal Timeout parameter below it is used in systems with network timeplexing and RRMs Percent Polling Protocol Terminal Timeout Textbox Percent Polling Protocol Terminal Timeout Values 50 90 Default 75 This parameter specifies the time that a terminal is allowed to be inactive before the CommServer declares it offline This time is expressed as a percentage of the Polling Protocol Terminal Timeout parameter above Thus if the Timeout parameter is 60 and this parameter is 75 the CommServer declares a terminal offline after 45 minutes of inactivity 45 minutes is 75 percent of 60 minutes Psion Teklogix 9500 Communications Server User Manual C 161 Appendix C The 9500 CommServer s Web Interface CommServer Configuration Radio Link Features An offline terminal is still considered part of the Psion Teklogix system messages to it are queued at the CommServer In this example the terminal remains offline until it notifies the CommServer that it is online or until the CommServer removes it from the system entirely after 60 minutes of inactivity This parameter is used in systems with network timeplexing and RRMs Direct TCP Connections For TekTerm Checkbox Direct TCP Connections for TekTerm J Values lt selected gt
142. hey are given in Table D 1 Additional values for these keys may be specified when starting TekHTML using the given configuration commands Ifa programmable function key with the same number is defined in the HTML page using the ACCESSKEY or FKEY attribute the action of the predefined function key prevails Default pe Function Key Action Configuration Command Go to start page show fhn where n is the Fl the configured home number of the desired func page tion key Go back a show the previous page apn Go forward Ea show the next page N F30 Reset frn Table D I Function Key Actions And Configuration Commands D 12 Psion Teklogix 9500 Communications Server User Manual Appendix D Developing HTML For The CommServer Remapping Function Key Zero F0 D 3 4 Remapping Function Key Zero F0 During operation the lt ENTER gt key of the terminal should not be pressed when the cursor is in an entry field This is because the HTML emulator browser does not know which form submitting tags lt INPUT TYPE SUBMIT gt touse The terminal s lt ENTER gt key is usually programmed to act as or be mapped to function key zero F0 While there is no actual FO key to press on a Psion Teklogix terminal several events can mimic the press of the key The data corresponding to an FO keypress can be artificially created using the lt ENTER gt key or a scanner These mappings are done in the TESS
143. hich is reasonably identifiable as confidential and proprietary Psion Teklogix RF Equipment means a radio frequency equipment on which the Software has been factory pre installed and authorized for Use Software means the Psion Teklogix application software product licensed for Use in conjunction with the Computer and any release update or correction level thereto or any complete or partial copies thereof Third Party Software means a software program or portion thereof which is owned in whole or in part by an independent third party and licensed to Psion Teklogix Inc Use means to install execute employ utilize store or display one 1 copy of the Software on the Computer 2A Grant of License We hereby grant you and you hereby accept a non exclusive non transferable license to Use the Software and Documentation as authorized under this Agreement The Software may be used by you only on a single Computer for Psion Teklogix 9500 Communications Server User Manual E 3 Appendix E Software License Agreements For Psion Teklogix Software as long as this Agreement is in effect As the Software and Documentation are copyrighted and licensed not sold we retain title to the Software and any copies made from it Any copies of the Software you make are subject to the restrictions of this Agreement 3 Our Responsibilities We agree to a provide you with one 1 machine readable copy of the Software If the Comput
144. ibute placed between column 2 and the end of the word PASSTHRU will push all following characters one position to the right Therefore any required attributes should occupy column 1 of the first line just preceding the word PASSTHRU Psion Teklogix 9500 Communications Server User Manual C 69 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation For example column 12345678 9 line 1 PAS STHRU line 2 PART 12345 where is an attribute When the CommServer is finished sending the data to the terminal s printer it will send an ENTER key to the host The host must wait for the ENTER key before sending any more screens including other PASSTHRU screens to this terminal E Note Refer to the appropriate terminal user manual for information about setting parameters on the terminal for pass through Procedures Checkbox Procedures Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer is allowed to send TESS procedures to the terminals A TESS procedure is a group of TESS commands that can be executed by the TESS execute procedure command Local Checkbox Local Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer is allowed to provide pages to be l
145. ications Server User Manual Appendix A Ports Pinouts And Cable Diagrams Cable Descriptions DTE DTE Null Modem Cable for 9500 P N 3002186 So oo N aoU A w N 2 3 4 5 6 7 8 9 DE9 S DE9 S Psion Teklogix 9500 Communications Server User Manual A 7 APPENDIX B SETTING TERMINAL NUMBERS ON THE COMMSERVER B 1 Introduction aa e aha a ea a 22000000005 B 3 B 1 1 The General Host Options Screen B 3 B 1 2 The Configure Existing Base Station Screen B 4 B 2 Setting The Terminal Range Hosts B 4 B 2 1 Systems With One Host B 5 B 2 2 Systems With Multiple Hosts B 6 B 3 Setting The Terminal Range Base Stations B 9 Psion Teklogix 9500 Communications Server User Manual B 1 Appendix B Setting Terminal Numbers On The CommServer Introduction B Introduction E Note Unless stated otherwise the information given in this appendix applies to both TESS and ANSI hosts Several screens in the 9500 CommServer s configuration interface allow you to specify ranges of terminal numbers The General Host Options screen The Configure Existing Base Station screen The terminal numbering parameters on these screens interact to determine how terminals connect to hosts in the Psion Teklogix system B 1 1 The General Host Options Screen PTX Communications Server General Host Options Fred Name Fed tS Enabled Vv Emul
146. inals so its highest terminal number is 50 Delete Button The Delete button allows the user to delete the currently displayed host connection When it is pressed the CommServer displays a confirmation screen 9400 Delete Host Fred Really delete host Fred OK Cancel Copyright 2000 2002 Psion Teklogix Inc Psion Teklogix 9500 Communications Server User Manual C 25 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens A amp L Note The screen shown here is the confirmation screen for deleting a host named Fred If the user presses the Cancel button on this screen the CommServer displays the Configure Host screen again If the user presses the OK button the CommServer removes the host connection s data from the configuration cache and displays a confirmation screen PTX Communications Server Data deleted successfully Data deleted successfully x Copyright 2002 Psion Teklogix Inc When the user presses the OK button in this confirmation screen the CommServer displays the Main Configuration screen again The choice for the deleted host connection is no longer present in the Hosts listbox C 2 2 4 Emulation Options This screen differs depending on the type of emulation and protocol selected in the General Host Options screen There are eight variants of this screen one for each of the following emulation and protocol combinations e ANSI emulation te
147. int no escape commands can be sent to the printer e Support for printing must be enabled at the terminal refer to the appropriate terminal user manual for more information Remote Print Checkbox Remote Print Values lt selected gt lt unselected gt Default lt unselected gt When this parameter is enabled the CommServer sends the print page to a terminal whenever the terminal requests it by sending the F17 function key from the terminal or the PRINT key on older terminals The CommServer sends the function response back to the host This is in contrast to Host Print where the host makes the initial print request E Note Support for printing must be enabled at the terminal refer to the appropriate terminal user manual for more information Pages Textbox Pages Values 0 79 Default 8 The number of host screens or pages stored at the terminal The CommServer reduces data transmitted to the terminals by using the terminal s capability to store a page of data for each screen it displays The CommServer maintains an image of each page stored at the terminal After receiving an application screen the CommServer tries to match the screen with a stored page If a similar page is already in the terminal s memory the CommServer simply instructs the terminal to re display its copy of the page only the necessary changes are sent from the CommServer If no match is found the complete pa
148. iny Perl script which was used to list all environment variables HTML generation is omitted for brevity while key value each ENV print Skey value n D 6 2 Implementation Of Cookies There are important differences between the HTTP standard as described in RFC 2109 and the de facto implementation of cookies in both Netscape Navigator and Microsoft Internet Explorer D 6 2 3 Difference In Cookie Expiration Mechanism RFC 2109 proposes attribute Max Age nnn to define for long the browser should keep the cookie This value is given in seconds The value 0 requests that the browser delete the cookie immediately D 20 Psion Teklogix 9500 Communications Server User Manual Appendix D Developing HTML For The CommServer Implementation Of Cookies Older versions of Netscape and Internet Explorer do not understand the Max Age attribute The Web developer may be forced to use the older Expires attribute though it is much more difficult to handle If the Web application is designed to work only with newer browsers this may not be a concern and the Max Age nnn attribute should be used instead of Expires The Expires attribute has the following structure Wdy DD Mon YY HH MM SS GMT where Wdy is the day of the week for example Mon or Tue DD is a two digit representation of the day of the month Mon is a three letter abbreviation for the month for example Jan or Feb YY is the last two digits of the year HH MM
149. is entered in this field Table D 2 Flags For The TEKFLAGS Attribute The INVISIBLE flag I can be used to hide buttons from the user if the user is supposed to press function keys to perform certain actions The button defined with the lt INPUT gt tag is still required to define the action it also defines the function key to be associated with this action However with addition of the TEKFLAGS I attribute the button itself becomes invisible and therefore inaccessible in the TESS screen presented to the terminal This can also be used to prevent scanner data input into button fields TESS does not have protected fields the BARCODE flag the B flag can protect button fields from keyboard data entry but this doesn t protect against scanner data entry Psion Teklogix 9500 Communications Server User Manual D 15 Appendix D Developing HTML For The CommServer Debugging And Testing With TekHTML The TRANSMIT UPON ENTRY flag T can be assigned to the last entry field in a form Then with an appropriate FKEYONENTER attribute an FO keypress event either the lt ENTER gt key or scanner data can initiate transmission of the form without any additional actions from the user D 5 Debugging And Testing With TekHTML The TekHTML emulator may be started with a number of debug options which cause it to create messages of various types as it operates The messages are such things as error messages or status messages
150. ize rows x columns Textboxes Maximum Screen Size rows x columns x Values rows 1 24 columns 1 80 Default 24 x 80 Psion Teklogix 9500 Communications Server User Manual C 27 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen ANSI Emulation These textboxes allow the user to specify the dimensions in rows and columns of the maximum terminal screen size Host Timeout Textbox Host Timeout Values 0 255 Default 15 The host timeout is the interval in 60ths of a second between bursts of data received from the host If the CommServer does not receive any characters from the host after this timeout has elapsed it assumes that the host has finished sending data and is waiting for user input in other words it assumes that a screen of data has been completed Escape Timeout Textbox Escape Timeout Values 0 255 Default 12 The escape timeout is the length of time in 60ths of a second that the CommServer will hang onto an ESC received from the host and consider the next received byte to be part of an escape sequence When this timeout has elapsed the host will have to send another ESC character to start or continue an escape sequence E Note This is especially important when an ESC is at the end of a data packet Threshold Textbox Threshold Values 0 999
151. jos oA eS o i Co CA E 1 2 PTX Communications Server Host Menu Fred Psion Teklogix General Options i Configure Emulation Options i Configure Protocol Options i Configure Function Key Mappings Configure Main Menu Main Menu Copyright 2002 Psion Teklogix Inc When the user chooses an existing host from the Hosts listbox and then presses the Configure button the CommServer displays the Host Menu The Host Menu has four Configure buttons which are located next to the following text e General Options When the user presses this Configure button the CommServer displays the General Options screen for this host e Emulation Options When the user presses this Configure button the CommServer displays the Emulation Options screen for this host This screen varies depending on the type of emulation and protocol selected for the host C 22 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens e Protocol Options When the user presses this Configure button the CommServer displays the Protocol Options screen for this host This screen varies depending on the type of emulation and protocol selected for the host e Function Key Mappings When the user presses this Configure button the CommServer displays the Function Key Mapping screen for this host This screen varies depending on the type of emul
152. k which communicate directly with the Psion Teklogix network CommServer s IP address such as terminals using Direct TCP may communicate with the alias IP address They will then communicate with whichever of the two redundant CommServers is the primary The TCP Direct Connections To Host check box in the Radio Link Features screen must be checked in this case C 170 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Redundancy Options 802 1Q v2 Features Interface Number Listbox 0 Ethernet Change to SS Values lt indexes and IP addresses of currently installled interfaces gt Default lt index 0 and IP address of interface 0 gt This listbox allows the user to specify the interface number through which this 9500 communicates with the other 9500 if redundancy is used Arbiter IP Address Textbox Arbiter IP Address itz 5 Values lt any valid IP address gt Default 0 0 0 0 This parameter contains the address of a device on the network which is known to be reliable Both CommServers ping this device if they receive no reply they assume that the network is not operating This address should be the same on both the primary and secondary CommServers Poll Interval Poll Timeout And Poll Tries Textboxes Poll Interval Values 1 1000 Default 10 Poll Timeout Values 1 10 Default 2 Poll Tries Values 2 7 Def
153. l Listbox Type V Values TCP IP Default TCP IP This listbox allows the user to select the protocol to be used for the connection to this base station Currently the TCP IP protocols is available Psion Teklogix 9500 Communications Server User Manual C 133 Appendix C The 9500 CommServer s Web Interface CommServer Configuration The Base Station Screens First Terminal Textbox First Terminal Values 1 3840 lt see text gt Default 1 This textbox allows the user to specify the Psion Teklogix terminal number of the first terminal which will communicate with this base station E Note This parameter has a maximum of 50 on the Model S900L software only ver sion of the CommServer since this version can handle a maximum of 50 ter minals Message Size Textbox Message Size Values 32 380 Default 100 This textbox allows the user to specify the size in number of characters of the largest single message that can be passed to a terminal in a single packet Longer messages are broken into several packets E Notes e This parameter only applies when the CommServer is using the cellular polling protocol the Use Cellular Protocol checkbox in the CommServer s Radio Link Features screen has been checked In systems using the Wireless LAN protocol the maximum value for this parameter is 380 In systems using the polling protocol the maximum value is 116 Auto Startup Checkb
154. le limited support This tag is recognized but no tag attributes are sup ported All tags between lt HEAD gt and lt HEAD gt except lt TITLE gt are ignored lt TITLE gt Title of page Terminal and console limited support The title is printed at the top of the screen lt BODY gt Content of page Limited support No attributes of the lt BODY gt tag are recog nized TekHTML for Windows NT does not rec ognize Psion Teklogix PASSTHRU PASSTHRUPORT PASSTHRUESC and PASSTHRUNEXT PAGE attributes which are used by the HTML emulation in Psion Teklogix network controllers lt TEKLOGIX gt Information about output fields Full support This tag is Psion Teklogix specific It has one attribute TEKFLAGS and is used for marking text to be treated as TESS output fields Psion Teklogix 9500 Communications Server User Manual Appendix D Developing HTML For The CommServer Link Miscellaneous And Input Tags Terminal and Recognizes the HREF console attribute for hyperlinks All oe pee limited other attributes including support NAME are ignored Fully supported input types HIDDEN PASS WORD SUBMIT TEXT Limited support RESET A button with the RESET attribute does nothing Terminal and when pressed The lt INPUT gt Input fields Console cea Toana PE limited input types are displayed support there is no support for ent
155. le Telnet User Authentication T OK Cancel Copyright 2002 Psion Teklogix Inc In this screen the user can set miscellaneous system options for the CommServer Serial Number Textbox SerialNumber sd Values lt see text gt Default 0 This textbox allows the user to enter a serial number for this CommServer Psion Teklogix 9500 Communications Server User Manual C 177 Appendix C The 9500 CommServer s Web Interface System Configuration Miscellaneous System Options 802 1Q v2 Features Enable Telnet Authorization Checkbox Enable Telnet Authorization Values lt enabled gt lt disabled gt Default lt disabled gt When this parameter is enabled the CommServer requests a username and password from telnet sessions connecting to the network console When a session connects the CommServer requests a username gt User After the user enters a username the CommServer requests a password gt User sue gt Password ma After the user enters the correct password the CommServer displays the network console prompt gt User sue gt Password kkkk gt User Logged In If the user does not enter a correct username and password the CommServer displays the message Unknown Name or Password and requests another username The user names and passwords are those listed in the Users listbox in the CommServer s Main Configuration Screen and set in the
156. llows the user to specify the Psion Teklogix terminal number of the first terminal which will communicate with this base station EL Note This parameter has a maximum of 50 on the Model S900L software only ver sion of the CommServer since this version can handle a maximum of 50 ter minals Message Size Textbox Message Size Values 32 380 Default 100 This textbox allows the user to specify the size of the largest single message in number of characters that can be passed to a terminal Longer messages are broken into several packets E Notes 1 This parameter only applies when the CommServer is using the cellular polling protocol the Use Cellular Protocol checkbox in the Com mServer s Radio Link Features screen has been checked 2 In systems using the Wireless LAN protocol the maximum value for this parameter is 380 In systems using the polling protocol the maximum value is 116 Psion Teklogix 9500 Communications Server User Manual C 137 Appendix C The 9500 CommServer s Web Interface CommsServer Configuration The Base Station Screens Auto Startup Checkbox Auto Startup M Values lt selected gt lt unselected gt Default lt selected gt If this checkbox is selected the CommServer will command the base station to start polling after the CommServer is turned on E Note Ifthe CommServer is being configured as a slave controller the Auto Star tup parameter should be disabled
157. lly The password must use the SNA Type A character set which includes uppercase letters A Z numbers 0 9 and the special characters and Lower case letters are accepted and translated to uppercase characters An SNA Type A character string must not begin with a number Enable Connect Screen Checkbox Enable Connect Screen Values lt selected gt lt unselected gt Default lt unselected gt Psion Teklogix 9500 Communications Server User Manual C 115 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 5250 Emulation SNA Protocol If this checkbox is selected the CommServer sends a special screen to the terminal when it is unable to connect to the host Pressing lt ENTER gt on the terminal causes the CommServer to reattempt connection to the host Reconnection Timeout Textbox Reconnection Timeout Values lt see text gt Default 30 This textbox specifies the maximum amount of time that the CommServer will wait for a reply when attempting a connection to the host If there is no reply it will attempt another connection to the maximum number of times specified in the Maximum Reconnection Attempts parameter below Maximum Reconnection Attempts Textbox Maximum Reconnection Attempts Values lt see text gt Default 3 This textbox specifies the maximum number of times that the CommServer attempts
158. lnet protocol See page C 27 e 2392 emulation telnet protocol See page C 33 e 3274 emulation telnet or TESS protocols See page C 49 e 5250 emulation telnet or TESS protocols See page C 65 e 9010 emulation telnet protocol See page C 81 e RF Modem emulation telnet protocol See page C 82 e HTML emulation TCP IP protocol See page C 83 e Remote Sockets emulation protocol See page C 87 There are no configurable options for Remote Sockets C 26 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen ANSI Emulation The Emulation Options Screen ANS Emulation PTX Communications Server ANSI Emulation Options ANSI Maximum Screen Size rows x columns Host Timeout Escape Timeout Threshold Echo Function Key Remapping Arrow Key Remapping Page Saving Page Saving consider Double Byte Characters RLE Convert 7 to 8 Bits Lower Character Set GL ASCII gt Upper Character Set GR DEC_Multi gt OK Cancel Copyright 2002 2004 Psion Teklogix Inc he CommServer displays this version of the Emulation Options screen after the user has selected the ANS Telnet emulation protocol combination for this host connection AL Note The screen shown here gives the emulation options for a host named Gary Maximum Screen S
159. lost Cancel Button When the user presses the Cancel button the CommServer displays the Configuration Main Menu Changes remain in the temporary configuration cache C 182 Psion Teklogix 9500 Communications Server User Manual APPENDIX D DEVELOPING HTML For THE CoMMSERVER D 1 Limitations Of The CommServer s HTML TESS Emulation D 3 D 2 Supported HTML Tags 2 200 2 0004 D 4 D 2 1 Link Miscellaneous And Input Tags D 5 D 2 2 Text Attribute Tags 0 D 7 D 2 3 Text Formatting Tags 0 D 8 D 2 4 Table List and Definition Tags D 9 D 3 Function Keysi ef fe ee eba 8 oe eS ew ee Ee D 11 D 3 1 Mapping The Function Keys D 11 D 3 2 Tags Without Function Key Support D 12 D 3 3 Predefined Function Keys D 12 D 3 4 Remapping Function Key Zero FO D 13 D 4 HTML Extensions For TESS 0 D 14 D 5 Debugging And Testing With TeKHTML D 16 D6 Cookies sene m ke doe RAR RE ee a D 19 Psion Teklogix 9500 Communications Server User Manual D 1 Appendix D Developing HTML For The CommServer Limitations Of The CommServer s HTML TESS Emulation D I Limitations Of The CommServer s HTML TESS Emulation The CommServer can translate HTTP datastreams and the web pages they transport into TESS for display on Psion Teklogix terminals Data compression And Caching aan tL i TESS Terminal So
160. ls C 120 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen HTML Emulation First Terminal Listen Port Listbox First Terminal Listen Port Values 10000 65535 Default 10000 This textbox contains the number of the first port upon which the CommServer listens for telnet connections from the host AL Note Entering a value of 0 disables this option The Protocol Options Screen HTML Emulation LJ 1 2 PTX Communications Server ve HTML Emulation Options Aline Psion Teklogix These parameters are not applicable to the HTML emulation Cancel noil Copyright 2002 Psion Teklogix Inc The CommServer displays a version of the Protocol Options screen with no configurable options after the user has selected the HTML emulation protocol combination for this host connection E Note The screen shown here gives the emulation options for a host named Aline Psion Teklogix 9500 Communications Server User Manual C 121 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen Remote Sockets Emulation The Protocol Options Screen Remote Sockets Emulation
161. lt LI gt tag D 9 listbox defined C 7 Local checkbox 2392 Emulation Options C 36 3274 Emulation Options C 54 5250 Emulation Options C 70 Local IP Address to Bind textbox Psion Teklogix 9500 Communications Server User Manual v Index vi Boldface indicates a parameter name as it appears in the Configuration Program Italics indicates a screen name as described in the Web Interface Reference Guide ANSI Telnet Protocol Options C 91 2392 Telnet Protocol Options C 98 3274 Telnet Protocol Options C 101 5250 Telnet Protocol Options C 112 Lower Character Set GL listbox 3274 Emulation Options C 31 LU Name Prefix textbox 3274 Telnet Protocol Options C 102 LU Prefix mode parameter textbox 5250 SNA Protocol Options C 117 M M option for emulator debug D 7 option for scheme debug D 18 main configuration screen C 14 mapping function key for HTML emulation D 1 function key zero F0 D 13 Maximum Message Segment Size textbox Configure New RRM Group C 145 Maximum Reconnection Attempts textbox 5250 SNA Protocol Options C 116 Merion Screen Size rows x columns check ox ANSI Emulation Options C 27 Maximum Sessions per Terminal textbox ANSI Telnet Protocol Options C 90 2 a Protocol Options C 98 C 5250 Telnet Protocol Options C 111 Message Mode Limit textbox Configure New RRM Group C 146 Message Size textbox Configure Existing Base Station C 137 Configure New Base Station C 134 Miscellaneous System Options screen C m
162. mapping does exist in the terminals but is applicable only to telnet direct connections Function key remapping and arrow key remapping can be enabled and operate independently of each other Arrow key sequences sent from the terminal can be switched between Application mode and Cursor Key mode by the DECCKM command sent by the host The sequences ares CSI 1h and CSI 11 There is also a local parameter on the terminal that can choose this mode Psion Teklogix 9500 Communications Server User Manual C 125 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The ANSI Function And Arrow Key Mapping Screen The default arrow key sequences in Psion Teklogix ANSI debug format are In Cursor Key Mode 1 Bit 8 Bit Up arrow 1b A 9b A Down arrow 1b IB 9b B Right arrow 1b C 9b Cc Left arrow 1b D 9b D In Application Mode Left arrow 1b OA 8f A Right arrow 1b OB 8 B Up arrow 1b 0C 8 C Down arrow 1b OD 8 D These sequences are remapped by the Communications Server to 4 configurable sequences each a minimum of 5 hex characters long A null entry terminates the map to sequence it is not necessary to transmit nulls The default values for arrow key mappings are the 7 bit Cursor key Mode values shown above The CommServer recognizes both the 7 bit and the 8 bit forms of the key sequences The same escape time
163. me Values lt see text gt Default lt none gt This textbox allows the entry of a name for the user The name must be an ASCII string Password Textbox Password Values lt see text gt Default lt none gt This textbox allows the entry of a password for this user The password must be an ASCII string and may be up to 32 characters long This password is case sensitive the CommServer recognizes differences in case when checking it The password EXAMPLE is considered to be different than passwords example or EXamPLe E Note The password is displayed in cleartext on this screen C 2 9 2 Edit Existing User Entry PTX Communications Server User Sam Psion Teklogix Name Sam Password 123456 OK Cancel Delete Copyright 2002 Psion Teklogix Inc In this screen the user can set options for an existing user C 174 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface System Configuration The Users Screens 802 1Q v2 Features Name Textbox Name Values lt see text gt Default lt none gt This textbox allows the entry of a new name for this existing user The name must be an ASCII string and may be up to 32 characters long This name is not case sensitive Password Textbox Password Values lt see text gt Default lt none gt This textbox allows the entry of a new password for this existi
164. meters Number of Poll Windows Textbox Number of Poll Windows Values 2 4 Default 3 This textbox allows the user to specify the number of poll windows in which the RRM listens for terminal responses after sending a poll g Warning THIS PARAMETER IS PRE CONFIGURED FOR YOUR SYSTEM AND SHOULD NOT BE CHANGED without a proper understanding of how it affects the radio link Size of Poll Windows Textbox Size of Poll Windows Values 5 32 Default 8 This textbox allows the user to specify the size of the poll windows in which the RRMs of this RRM group listen for terminal replies C 144 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens Warning THIS PARAMETER IS PRE CONFIGURED FOR YOUR SYSTEM AND SHOULD NOT BE CHANGED without a proper understanding of how it affects the radio link Maximum Message Segment Size Textbox Maximum Message Segment Size Values 32 116 Default 100 This textbox allows the user to specify the size of the largest message segment in bytes that will be sent over the Psion Teklogix radio network Larger messages are broken into parts Warning THIS PARAMETER IS PRE CONFIGURED FOR YOUR SYSTEM AND SHOULD NOT BE CHANGED without a proper understanding of how it affects the radio link Number of Retries Textbox Number of Retries Values 1 7
165. minal ID numbers match the host emulation numbers B 2 1 Systems With One Host If the 9500 CommServer is configured for one host the range of terminals defined in the Host 1 screen will be 7 ton where n is the total number of terminals host emulations defined in the main Configuration screen Thus the offset is zero for systems with only one host and the ID numbers of the RF terminals are identical to the host emulation numbers Example Host Emulations on CommServer 12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 2 3 14 5 6 7 8 9 20 12 12 23 14 15 16 17 18 19 20 Base Station 1 ee Terminal ID Numbers Terminal ID 1 Terminal ID 20 Figure B I In this system we will define the ranges In the General Host Options screen for Host 1 Terminal Range 1 to 20 since this range starts at 1 the offset for this host is zero and the RF terminal ID numbers will be identical to the host emulation numbers Psion Teklogix 9500 Communications Server User Manual B 5 Appendix B Setting Terminal Numbers On The CommServer Systems With Multiple Hosts In the Configure Existing Base Station screen for Base Station 1 First Terminal 1 no offset on the Base Station B 2 2 Systems With Multiple Hosts Terminal number mapping offsets become useful when the 9500 CommServer is configured for multiple hosts and there is a need to diffe
166. minals with which the RRMs will be communicating See Radio Parameters on page C 147 for descriptions and possible ranges for these parameters Group Parameters This section lists which RRMs belong to which RRM group e Combination 1 e Combination 2 C 158 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens Results This section lists the results of the analysis e Errors This section lists problems which will cause this RRM group configuration to not work e Warnings This section lists less serious problems than the Errors section This RRM group configuration will work but it is not optimal Number of RRMs The number of RRMs in this group e RRM Combination Cycle This parameter shows the polling arrangement of the RRMs e Poll Timeout in Terminals average load Poll Timeout in Terminals maximum load These two parameters show how the RRMs will perform under differing loads Psion Teklogix 9500 Communications Server User Manual C 159 Appendix C The 9500 CommServer s Web Interface CommsServer Configuration Radio Link Features 2 5 CommServer Configuration Radio Link Features ea m joo S Eq coe SS m D a G 1 2 PTX Communications Server Radio Link Features Operate in Cellular Mode Poll ID Polling Protocol Terminal Timeout Percent Polling Protocol Terminal Timeout
167. mmunications Server User Manual C 77 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation Barcode Textbox Barcode Ear Values 0 127 Default lt none gt Barcode input only fields are special entry fields that only accept input from a bar code reader The application program distinguishes an entry field as barcode input only by preceding the field with a special character This textbox contains the decimal representation of the ASCII character code of this special character A value of 0 zero disables this feature Entry Line Textbox Entry Line Values 0 24 Default lt none gt This textbox contains the number of the first line displayed if there is no entry field in the upper left portion of the screen and if an entry field is at or below this line The Entry Line parameter allows an automatic offset within the host screen so that the area displayed by the terminal includes an entry field that would normally be out of bounds Normally Psion Teklogix terminals only display the upper left corner of the application screen because of their smaller display size Field Overhead Textbox Field Overhead si Values 0 80 Default 0 This textbox contains the maximum number of characters allowed between two fixed fields which still allows the CommServer to join them into one field Sometimes the CommServer will join t
168. more of the RRMs in this RRM group do not overlapping the non overlapping RRMs may be assigned to the same subgroup They will then poll at the same time This improves system response time and reduces the amount of signalling on the network As an example if the RRM group has 3 RRMs and RRMs 1 and 3 don t overlap RRMs 1 and 3 may be placed in one subgroup They will then poll simultaneously RRM 2 may be placed in another subgroup Polling then alternates between the two subgroups C 148 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens To configure a subgroup place the numbers of the RRMs in the textbox for that subgroup The numbers correspond to the numbers of the RRMs named in the RRM list on the RRM Group Menu see page C 149 For instance 13 in the textbox for subgroup 1 places RRMs 1 and 3 in that subgroup RRMs that are not assigned to subgroups poll individually after all of the RRMs in the subgroups poll 2 4 2 The RRM Group Menu 0 O0U0000 PTX Communications Server RRM Group Menu General Options Configure RRMs 1 Sport hes Configure Analyze Analyze Main Menu Copyright 1999 2000 Teklogix Inc When the user chooses an existing RRM group from the RRM Groups listbox and then presses the Configure button the CommServer displays the RRM Group Menu Main Menu The RRM G
169. n g Warning THIS PARAMETER IS PRE CONFIGURED FOR YOUR SYSTEM AND SHOULD NOT BE CHANGED without a proper understanding of how it affects the radio link Callsign Period Textbox Callsign Period Values 0 60 Default 0 C 146 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens This textbox allows the user to specify the amount of time between transmissions of the callsign This parameter is in minutes A value of 0 zero indicates that no callsign is transmitted Callsign Text Textbox Callsign Text Values lt text gt Default Teklogix This textbox allows the user to specify the text to be transmitted as the RRM s callsign The text is transmitted as Morse code Radio Parameters Because some of the radio parameters are identical for a given group of timeplexed RRMs they may be configured by the user once on the CommServer the CommServer then passes them to the RRMs in the group These parameters include the synchronization delay Sync Delay the remote transmit on time Remote TxOn the channel number to be used Active Channel and the size of the poll header Although the TRX7370 narrow band FM radio in each RRM in the group is configured separately the CommServer assumes that they will be configured the same To ensure this the CommServer looks at certain parameters returned by each o
170. n Options C 38 3274 Emulation Options C 56 5250 Emulation Options C 73 part numbers of cables 4 5 PASSTHRU attributes D 5 Passthru checkbox HTML Emulation Options C 85 2392 Emulation Options C 35 3274 Emulation Options C 52 5250 Emulation Options C 69 Password textbox Create New User Entry C 174 Edit Existing User Entry C 175 5250 SNA Protocol Options C 115 Percent Polling Protocol Terminal Timeout textbox Radio Link Features C 161 C 162 pinouts RJ 45 connector A 3 9 pin D connector A 4 lt PLAINTEXT gt tag D 8 Poll ID textbox Radio Link Features C 161 Poll Interval textbox Redundancy Parameters C 171 Poll Timeout textbox Redundancy Parameters C 171 Poll Tries textbox Redundancy Parameters C 171 Polling Protocol Terminal Timeout textbox Radio Link Features C 161 Port textbox Base Station Connectivity TCP IP Options C 139 Configure Existing RRM C 153 C 154 PPP modem cable A 6 PPP null modem cable A 6 A 7 lt PRE gt tag D 8 predefined function keys D 12 Preferred Primary checkbox Redundancy Parameters C 169 Print Form Length textbox 2392 Emulation Options C 43 3274 Emulation Options C 61 5250 Emulation Options C 77 Print Line textbox 2392 Emulation Options C 42 3274 Emulation Options C 60 5250 Emulation Options C 77 Procedures checkbox 2392 Emulation Options C 36 3274 Emulation Options C 54 5250 Emulation Options C 70 Protocol listbox Configure Existing Base Station C 137 Configure New
171. n these fields would be joined into one This feature affects fields with the Normal display attribute only C 86 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen Remote Sockets Emulation The Emulation Options Screen Remote Sockets Emulation a ed 0 OOOO PTX Communications Server Remote Sockets Emulation Options Unnamed Host Remote Sockets Emulation Options Remote Sockets has no emulation options Cancel Copyright 2004 Psion Teklogix Inc The CommServer displays this version of the Emulation Options screen after the user has selected the Remote Sockets emulation protocol combinations for this host connection EL Note The screen shown here gives the emulation options for a host named Unnamed Host This emulation is intended for a CommServer communicating with a Psion Teklogix device using the Remote Sockets proxy communications mechanism There are no emulation options 2 2 5 Protocol Options This screen differs depending on the type of emulation and protocol selected in the General Host Options screen There are nine variants of this screen for the following emulation and protocol combinations e Telnet protocol ANSI emulation See page C 89 e Telnet protocol 2392 emulation See page C 97 e Telnet protocol 3274 emulation See
172. nation of 2392 Telnet for this host E Note The screen shown here gives the protocol options for a host named Elaine Psion Teklogix 9500 Communications Server User Manual C 97 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 2392 Emulation Telnet Protocol Host Port Textbox Host Port ss Values 1 32767 Default 23 This textbox allows the user to enter a host port value for the selected 2392 telnet host connection Maximum Sessions per Terminal Textbox Maximum Sessions per Terminal Values 0 127 Default 4 This textbox contains the maximum number of telnet sessions which are allowed to originate from each terminal First Local Terminal Port Textbox First Local Terminal Port Values 1024 32767 Default 0 This textbox contains the port number from which the first terminal will connect on outbound telnet sessions Local IP Address to Bind Textbox Local IP Address to Bind Values lt any valid IP address gt Default 0 0 0 0 This textbox contains the IP address of the network adaptor in the CommServer from which the first terminal will connect on outbound telnet sessions First Terminal Listen Port Textbox First Terminal Listen Port Values 0 32767 C 98 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configura
173. ng user The password must be an ASCII string and may be up to 32 characters long This password is case sensitive the CommServer recognizes differences in case when checking it The password EXAMPLE is considered to be different than passwords example or EXamPLe E Note The password is displayed in cleartext on this screen Delete Button The Delete button allows the user to delete the currently displayed user from the list of users When it is pressed the CommServer displays a confirmation screen PTX Communications Server 4 Delete user Sam Really delete user Sam OK Cancel Copyright 2002 Psion Teklogix Inc If the user presses the Cancel button on this screen the CommServer displays the Edit Existing User Entry screen again Psion Teklogix 9500 Communications Server User Manual C 175 Appendix C The 9500 CommServer s Web Interface System Configuration SNMP Parameters 802 1Q v2 Features If the user presses the OK button on this screen the CommServer removes the user s data from the configuration cache and displays a confirmation screen PTX Communications Server Data deleted successfully Psion Teklogix Data deleted successfully _ok Copyright 2002 Psion Teklogix Inc When the user presses the OK button in this confirmation screen the CommServer displays the Configuration Main Menu again The choice for the deleted user entry is no longer present in the Users listbox C 2
174. ng via HTTP The choices are the 16 predefined HTML colour names User Data Font Size Listbox User Data Font Size V Values 1 2 3 4 5 6 7 Default 3 This listbox allows the user to select the size of the font in which user data will be presented to the terminals web browser Function Key Font Size Listbox Function Key Font Size V Values 4pt 6pt Spt 10pt 12pt 14pt Default 8pt This listbox allows the user to select the protocol to be used for the connection between the terminal and the CommServer Terminals may connect through TESS or HTTP TSF O Checkbox TSF O Values lt selected gt lt unselected gt C 80 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 9010 Emulation Default lt unselected gt If this checkbox is selected the CommServer uses Psion Teklogix Screen Formatter Optimizer software The Emulation Options Screen 9010 Emulation PTX Communications Server 9010 Emulation Options Cecil 9010 Options Refrain from sending On line amp Off line messages O OK Cancel Copyright 2002 Psion Teklogix Inc The CommServer displays this version of the Emulation Options screen after the user has selected the 90 0 Telnet or 9010 Serial emulation protocol combina
175. o telnet Host textbox 2392 Telnet Protocol Options C 99 3274 Telnet Protocol Options C 103 5250 Telnet Protocol Options C 112 Auto Telnet Without User Action checkbox 2392 Telnet Protocol Options C 99 3274 Telnet Protocol Options C 103 5250 Telnet Protocol Options C 112 Auto telnet login enable listbox 2392 Telnet Protocol Options 3274 Telnet Protocol Options 5250 Telnet Protocol Options B B C 99 C 103 C 112 flag for TEKFLAGS attribute D 15 option for emulator debug D 6 lt B gt tag D 7 back key D 12 Back listbox HTML Function Key Mapping C 131 Background Colour listbox 3274 Emulation Options C 63 5250 Emulation Options C 80 Backup IP Address textbox Redundancy Options C 170 er et flag for TEKFLAGS attribute D Barcode textbox 2392 Emulation Options C 43 3274 Emulation Options C 61 5250 Emulation Options C 78 Base Station Connectivity TCP IP Options screen C 39 Base Station Menu screen C 135 Psion Teklogix 9500 Communications Server User Manual Beacon Gateway Interface listbox 802 10 v2 Features C 166 C 167 Beacon Period textbox 802 10 v2 Features C 166 Beacon UDP Port textbox 802 10 v2 Features C 167 lt BLINK gt tag D 7 lt BODY gt tag D 5 lt BR gt tag D 8 button defined C 6 button mapping function key to D 1 C C flag for TEKFLAGS attribute D 15 option for emulator debug D 16 option for scheme debug D 18 cables descriptions 4 5 diagrams 4 1 part numbers A 5 ports pinouts 4 1 19680 modem
176. o this host Auto telnet Host Textbox Auto telnet Host Values lt any host ID gt Default lt none gt This parameter specifies a host ID to which auto telnet requests will be directed Auto Telnet Without User Action Checkbox Auto Telnet Without User Action M Values lt selected gt lt unselected gt Default lt selected gt C 112 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 5250 Emulation Telnet Protocol If this checkbox is selected the CommServer will attempt to connect to a configured Auto Telnet host by auto telnet whenever that host is available Negotiate Virtual Device Name With Host Checkbox Negotiate Virtual Device Name with Host Values lt selected gt lt unselected gt Default lt unselected gt If this textbox is selected the CommServer negotiates with the host to obtain a virtual device name for the telnet connection Virtual Device Name Prefix Textbox Virtual Device Name Prefix Values lt any host ID gt Default lt none gt This parameter specifies a prefix for the automatically generated virtual device name The device name on the host starts with the prefix specifies the terminal as its terminal number and specifies a session number as a letter If the virtual device name prefix is TLX for example the first se
177. oaded as local TESS procedures in the terminals The local procedures are selected from a menu at the terminal The terminals can perform these procedures when they are offline Later when the terminals are online they send the results of these functions to the host E Note The Procedures parameter also must be enabled for Local to work C 70 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation TSF O Checkbox TSF O Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer uses Psion Teklogix Screen Formatter Optimizer software Host Print Checkbox Host Print Values lt selected gt lt unselected gt Default lt unselected gt When this parameter is enabled the host can send extra data to the terminal s screens and instruct the terminal to print it This is in contrast to the Local Print feature where the terminal makes the initial print request The text that is passed to the printer is formatted into the 24 x 80 application screen If the host can initiate the print operation the text is printed The CommServer identifies the additional text as a print page by the presence of the word PRINT in capital letters beginning in the 2nd column of line 13 on the 24 x 80 screen The word PRINT sh
178. ocal Terminal Port Textbox First Local Terminal Port Values 1024 32767 Default 0 This textbox contains the port number from which the first terminal will connect on outbound telnet sessions First Terminal Listen Port Textbox First Terminal Listen Port Values 0 32767 Default 10000 This textbox specifies the first port number at which the CommServer will listen for telnet connection requests to the terminals E Note Entering a value of 0 disables this option Psion Teklogix 9500 Communications Server User Manual C 111 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 5250 Emulation Telnet Protocol Local IP Address To Bind Textbox Local IP Address to Bind Values lt any valid IP address gt Default 0 0 0 0 This textbox contains the IP address of the network adaptor from which the first terminal will connect on outbound telnet sessions Actively Negotiate With Host Checkbox Actively Negotiate With Host Values lt selected gt lt unselected gt Default lt unselected gt If this textbox is selected the CommServer negotiates with the host during setup of the telnet connection Auto telnet login Enable Listbox Auto telnet login enable lV Values DISABLE AUTO TELNET Default DISABLE This listbox allows the user to choose whether auto telnet sessions are allowed to connect t
179. odem cable for PPP link 4 6 Monitor Polls checkbox 9010 Telnet Protocol Options C 119 N N flag for TEKFLAGS attribute D 15 Psion Teklogix 9500 Communications Server User Manual Name textbox Configure Existing Base Station C 136 Configure Existing RRM C 153 C 154 Configure New Base Station C 133 Configure New Host C 20 Configure New RRM Group C 143 Create New User Entry C 174 Edit Existing User Entry C 175 General Host Options C 24 Name mode parameter textbox 5250 SNA Protocol Options C 116 Negotiate Virtual Device Name with Host checkbox 5250 Telnet Protocol Options C 113 Network Name textbox SNA Parameters C 172 null modem cable for PPP link A 6 A 7 NUMBER flag for TEKFLAGS attribute D 15 Number of Poll Windows textbox Configure New RRM Group C 144 Number of Retries textbox Configure New RRM Group C 145 O O option for emulator debug D 17 offices list Z Z OK button a aa Terminal Numbering C lt OL gt tag D 9 Operate in Cellular Mode checkbox Radio Link Features C 160 P P option for emulator debug D 7 option for scheme debug D 8 lt P gt tag D 8 Page checkbox ANSI Emulation Options C 30 Page Saving consider Double Byte Characters checkbox ANSI Emulation Options C 30 Pages textbox Index Boldface indicates a parameter name as it appears in the Configuration Program Italics indicates a screen name as described in the Web Interface Reference Guide HTML Emulation Options C 85 2392 Emulatio
180. on of the match field Now either another entry in the match field can be made or the cursor can be moved to a new field When an entry even if it doesn t match the host s preloaded data is made in a match field this entry will be sent to the host as part of the terminal s modified data during the next transmission Match Character Use match a number amp match a letter either case match an upper case letter match a lower case letter match an alphanumeric character m match a letter number or space 0 match a punctuation character g match any character match all character positions in the field with the preced ing character match any remaining characters but not necessarily the remainder of the field with the preceding character Table C 8 Match Characters Psion Teklogix 9500 Communications Server User Manual C 59 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 3274 Emulation Hidden Match Character Textbox Hidden Match Character __ _ lt Values 0 127 Default lt none gt A special character is used to mark Hidden Match fields in a TESS screen This character precedes the field contents of the Hidden Match field In hidden match fields as opposed to visible match fields the preloaded entry is not displayed in the entry field at the operator s terminal This te
181. ons Values lt selected gt lt unselected gt C 96 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 2392 Emulation Telnet Protocol Default lt selected gt If this checkbox is unselected and auto telnet is enabled all sessions requested by the terminal to this host emulation will be Auto Login sessions If this checkbox is selected sessions requested by the terminal can be either auto iogin or TCP sessions At the prompt of a TCP session the operator can specify the desired host to connect to and provide username and password On the terminal lt CTRL gt A requests a new session lt CTRL gt B changes to the next available session and lt CTRL gt E changes to the last available session The Protocol Options Screen 2392 Emulation Telnet Protocol U UOUU0U0 PTX Communications Server 2392 Telnet Protocol Options Unnamed Host Psion Teklogix Host Port Boo Maximum Sessions per Terminal fa First Local Terminal Port fioooo Local IP Address to Bind booo First Terminal Listen Port booo Auto telnet login Enable DISABLE a Auto telnet Host o Auto telnet Without User Action Vv OK Cancel Copyright 2002 2003 Psion Teklogix Inc The CommServer displays this version of the Protocol Options screen when the user selects the emulation protocol combi
182. ons Screen 3274 Emulation The mode character is derived by starting with the decimal value 48 ASCII character 0 and adding the appropriate value from the table below Code Meaning of Code 1 Prevent the AIAG prefix from being displayed 2 Prevent the AIAG prefix from being sent to the host 4 Cause a transmission to the host when all AIAG fields with this mode set are filled The transmission is sent by a Function 0 F0 code 8 Allow overwriting of previously entered data 16 Start the search for a matching AIAG field at the current cursor position Other wise the cursor will start at the top of the page Table C 7 Mode values for the AIAG fields For example the symbol is used to apply the cursor matching function since adding 16 to 48 results in decimal value 64 which is the ASCII value for the character A value of 0 zero disables this feature Visible Match Character Textbox Visible Match Character Values 0 127 Default lt none gt With field matching the host computer preloads data into an entry field The terminal operator can make an entry that matches this preloaded data For visible match fields the preloaded data will be displayed in the entry field at the operator s terminal The application program distinguishes an entry field as a match field by preceding it with a special character The special character is entered as the decimal character cod
183. operating systems may appear somewhat different Psion Teklogix 9500 Communications Server User Manual C 5 Appendix C The 9500 CommServer s Web Interface The CommServer s Web Configuration Screens 3 PTX Communications Server Configuration Main Menu Microsoft Internet Explorer provided by Psion Teklogix File Edit View Favorites Tools Help Bak gt A Qsearch GaFavorites lt Bristory B 3 wi S Address ja http 10 10 10 10 8008 PTX Communications Server Configuration Main Menu Controller Configuration Hosts 1 Fred g Configur Base Stations i Velma v Configur RRM Groups 1 Daphne Configur Figure C 1 A Browser Screen With Textboxes Listboxes Checkboxes And Buttons This screen contains a selection of HTML elements used by the CommServer textboxes a listbox checkboxes and buttons HTML elements used by the CommServer are described below Text links When a fext link is selected the browser fetches another page from the CommServer Text links are often shown in graphical browsers as coloured and underlined text and they will be indicated in this manual as underlined text text link Buttons When a button is selected data is sent to the server to request another page Buttons are often rendered to appear three dimensional so that they appear to move in and out when selected this can be described as pressing the button This manual indicates but
184. or TEKFLAGS attribute D 15 option for emulator debug D 17 lt S gt tag D 7 screen Analyze RRM Group C 156 ANSI Emulation Options C 27 ANSI Function Key Mapping C 124 ANSI Telnet Protocol Options C 89 Base Station Connectivity TCP IP Options C 139 Base Station Menu C 135 Configuration Main Menu C 14 Configure Existing RRM C 154 Configure Existing RRM Group C 151 Configure New Base Station C 133 Configure New Host C 19 Configure New RRM C 153 Configure New RRM Group C 142 Create New User Entry C 173 Database Valkidation Results C 181 Display Entire Database C 179 Edit Existing User Entry C 174 Emulation Options C 26 Function Key Mapping C 123 General Host Options C 23 General Options C 136 Psion Teklogix 9500 Communications Server User Manual Host Menu C 22 HTML Emulation Options C 83 ey Emulation Protocol Options C Miscellaneous System Options C 177 Protocol Options C 87 Redundancy Options C 168 Remote Sockets Emulation Options C Remote Sockets Emulation Protocol Options C 122 Remote Sockets Function Key Mapping C 132 Restart Controller Software C 180 Restarting Confirmation C 180 RF Modem Emulation Options C 82 RF Modem Function Key Mapping C 130 C 132 RF Modem Telnet Protocol Options C 120 RRM Group Menu C 149 SNA Parameters C 172 C 176 2392 Function Key Mapping C 132 2392 Telnet Protocol Options C 97 3274 Emulation Options C 33 C 49 3274 Function Key Mapping C 127 3274 Telnet Terminal Naming
185. ort Values lt see text gt Default 0 This textbox specifies the lowest port number at which the CommServer listens for telnet connections initiated by the host EL Note Entering a value of 0 disables this option TCP Session Request Textbox TCP Session Request Values 0 255 Default 1 Psion Teklogix 9500 Communications Server User Manual C 91 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen ANSI Emulation Telnet Protocol This textbox contains the decimal ASCII character code of the character which when entered at the terminal requests a new ANSI terminal session Session Cycle Key Textbox Session Cycle Key E Values 0 255 Default 2 This textbox contains the decimal ASCII character code of the character which when entered at the terminal requests the next ANSI terminal session Last Active Session Key Textbox Last Active Session Key Values 0 255 Default 5 This textbox contains the decimal ASCII character code of the character which when entered at the terminal requests the last ANSI terminal session Auto Telnet Auto Login Enable Listbox Auto Telnet Login Enable Z Values Disable Auto Telnet Auto Telnet Login Default Disable This listbox enables the user to disable or enable automatic connection of telnet sessions from terminals to this host The choices provide
186. ost Emulations on CommServer 23 4 5 67 8 9 10 11 12 13 14 15 16 17 18 19 20 2 3 4 5 71 8 9 Host1 ab e S yaaa Base Station 1 Terminal ID Numbers Terminal ID 1 Terminal ID 20 000000000090 Base Station 2 A A Terminal ID Numbers Terminal ID 1 Terminal ID 11 Figure B I In this system we will define the ranges In the General Host Options screen for Host 1 Terminals 1 to9 arange of9 terminals or host emulations for Host 1 Since this range starts at 1 the offset for this host is zero and the RF terminal ID numbers will be identical to the host emulation numbers In the General Host Options Host 2 screen Terminals 10 to 20a range of 11 terminals or host emulations for Host 2 The lower number in the range host emulation 10 in this case is mapped to the first terminal on Host 2 and the higher number host emulation 20 in this Psion Teklogix 9500 Communications Server User Manual B 15 Appendix B Setting Terminal Numbers On The CommServer Setting The Terminal Range Base Stations case is mapped to the 17th terminal on Host 2 an offset of 9 In the Configure Existing Base Station screen for Base Station 1 First Terminal 1 since this will map host emulation 1 to RF terminal ID 1 the offset for this Base Station is zero Thus host emulations 1 20 will match terminal ID numbe
187. ost name placed in this textbox must be resolvable by the CommServer the CommServer must be able to obtain an IP address for it For example the host name may correspond to an entry in the CommServer host table or the CommServer may be able to query a domain name server Any host name which can be used at the terminals TCP gt prompt may be used here Auto Telnet Terminal Prompt Textbox Auto Telnet Terminal Prompt Values any ASCII string Max 60 characters Default Press ENTER to login This textbox contains the text presented to the user to request a login Non printable characters such as are used in escape sequences are allowed These characters can be entered using either octal or hexadecimal digits An octal escape sequence takes one of the forms 0d or 0dd or O0ddd where each d can be any digit 0 7 A hexadecimal escape sequence takes one of the forms xh or xhh where each h can be 0 9 or any of a f or A F Psion Teklogix 9500 Communications Server User Manual C 93 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen ANSI Emulation Telnet Protocol Each of these numeric escape sequences encodes one character For example the sequence 033abc becomes the character array 033 a b c 0 E Notes 1 Ifthe octal ddd is greater than decimal 256 the code value of the repre sented character will be the remainder of decimal
188. ost named Fred Psion Teklogix 9500 Communications Server User Manual C 127 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The 3274 Function Key Mapping Screen Function Key n Listbox Values ENTER NONE F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 F13 F14 F15 F16 F17 F18 F19 F20 F21 F22 F23 F24 PA1 PA2 PA3 PA4 ATTN CLEAR RESET SELECTOR SESS SYSREQ Default lt see text gt The function key textboxes allow the user to select a code that will be sent to the host when the user presses a function key on the terminal Each function key may be chosen from the same range of possible codes however each function key has a different default code C 128 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The 5250 Function Key Mapping Screen The 5250 Function Key Mapping Screen 1 2 PTX Communications Server La 5250 Function Key Mappings Bob Psion Teklogix FO ENTER gt F 14 F14 z F27 F17 7 Fi Fl im F15 F15 Bj F28 F18 hd F2 F2 7 F16 CLEAR F29 UP 7 F3 F3 z F17 PRINT F30 Sess F4 F4 7 Fis HEP a Fan ENTER x FS F5 z F19 F19 7 F22 ENTER x F6 F6 7 F20 F20 z F33 ENTER x F7 F7 z F21 F21 z
189. ould be defined as display only text The print page is positioned below the terminal s display page see the following figure The size of the print page is always the same as the terminal s display page assuming that in the terminal s configuration the page length is less than 12 lines When Host Print is enabled the CommServer passes the print page to the terminal after receiving the application screen from the host Psion Teklogix 9500 Communications Server User Manual C 71 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation Display Page 8 x 40 WODINHAUBWNH 14 PRINT Print Page 8 x 40 Figure C 9 Application Screen With Print Page E Notes Unlike with the Passthru option when using Host Print no escape commands can be sent to the printer e Support for printing must be enabled at the terminal level refer to the Terminals User Manual or the Parameter Guide for more information Remote Print Checkbox Remote Print Values lt selected gt lt unselected gt Default lt unselected gt When this parameter is enabled the CommServer sends the print page to a terminal whenever the terminal requests it by sending the F17 function key from the terminal or the PRINT key on older terminals The CommServer sends the function response back to the host This is
190. out applies to arrow key remapping as to function key remapping The cursor key mode parameter setting in the terminal is not considered by the CommServer If the host changes the key sequence using DECCKM the CommServer continues to remap the new key sequences In other words with arrow key mapping enabled DECCKM will have no net effect C 126 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The 3274 Function Key Mapping Screen The 3274 Function Key Mapping Screen CJ RS PTX Communications Server 3274 Function Key Mappings Fred FO ENTER gt F 14 PA2 z F27 F13 7 Fi Fl my F15 PA3 E F28 F14 ha F2 F2 7 F16 CLEAR F F29 F15 x F3 F3 z F17 F17 z F30 Sess F4 F4 B F18 F18 g F31 F16 E FS F5 7 F19 F19 7 F322 ENTER z F6 Fb z F20 F20 7 F33 ENTER z F7 F 7 F21 F21 z F34 ENTER z F8 F8 z F22 F22 z F3s ENTER x F9 Fg 7 F23 F23 7 F36 ENTER z F10 F10 7 F24 F24 z F37 ENTER z F11 Fil 7 F25 SYSREQ z F38 ENTER z F12 F12 7 F26 ATTN z F39 ENTER x F13 PAI hd OK Cancel Copyright 2002 Psion Teklogix Inc The CommServer displays this version of the Function Key Mapping screen after the user selects the 3274 ANSI or 3274 SNA emulation protocol combinations for this host E Note The screen shown here gives the function key options for a h
191. ox Auto Startup J Values lt selected gt lt unselected gt Default lt selected gt If this checkbox is selected the CommServer commands the base station to start polling after the CommServer is turned on C 134 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommServer Configuration The Base Station Screens E Note Ifthe CommServer is being configured as a slave controller the Auto Star tup parameter should be disabled C 2 3 2 The Base Station Menu U POOOR PTX Communications Server Base Station Menu Velma Psion Teklogix Configure Configure Main Menu Copyright 2002 Psion Teklogix Inc General Options Connectivity Options Main Menu When the user chooses an existing base station from the Base Stations listbox and then presses the Configure button the CommServer displays the Base Station Menu E Note The screen shown here is for a base station named Velma The Base Station Menu has two Configure buttons which are located next to the following text e General Options When the user presses this Configure button the CommServer displays the Configure Base Station screen e Connectivity Options When the user presses this Configure button the CommServer displays the Connectivity Options screen for this base station The Base Station Menu also has a Main Menu button When the user presses the M
192. page C 100 Telnet protocol 5250 emulation See page C 110 Telnet protocol 9010 emulation See page C 119 Psion Teklogix 9500 Communications Server User Manual C 87 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen Remote Sockets Emulation Telnet protocol RF modem emulation See page C 120 SNA protocol 3274 emulation See page C 106 SNA protocol 5250 emulation See page C 114 HTML protocol emulation See page C 121 Remote Sockets protocol emulation See page C 122 There are no configurable protocol options for the HTML or Remote Sockets protocol emulation combinations C 88 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen ANSI Emulation Telnet Protocol The Protocol Options Screen ANS Emulation Telnet Protocol LJ m HOWUUL poao L ogoi gt PTX Communications Server ANSI Telnet Protocol Options Daevid Psion Teklogix Terminal Type T100 Host Port B Maximum Sessions per Terminal fa Close Host sessions on Terminal reset O First Local Terminal Port ooon Local IP Address to Bind 0 0 0 0 First Terminal Listen Port poo TCP Session Request Key i Session Cycle Key e Last Active Session Key 5 Auto telnet login Enable DISABLE Auto telnet Host i ai i
193. parameter menu in each RF terminal If the lt ENTER gt key is mapped to function key zero FO in the terminal s TESS FIELDS menu Enter to F0 Y then pressing the lt ENTER gt key on the terminal s keyboard causes an FO keypress to occur The terminal submits the form sending the form data back to the host Otherwise pressing the lt ENTER gt key simply moves the cursor to the next field on the screen sending nothing By default the lt ENTER gt key is mapped to the FO key A similar mapping exists for scanners In a Psion Teklogix terminal the TESS WAND menu has two settings Append Enter and Append F0 If neither of these is enabled scanner data is entered into the current field after a scan and the cursor stays where it happens to be depending on data size and other settings If Append Enter is selected the terminal acts as if the lt ENTER gt key had been pressed and the cursor moves to the next field If Append FO is selected the terminal acts as if the FO key had been pressed after the data was entered and submits the form data The FO keypress event like that from any other function key causes the terminal to send a TESS page to the CommServer which is translated and sent to the host It is possible however to remap the FO key to act as any other function key using the FKEYONENTER attribute This remapping is on a per field basis the key can thus be assigned to any
194. ping FedEx Path acme some form data Again this long string is wrapped Older Web servers ignore unknown NAMEs starting with the character thus providing backward compatibility Older browsers do not send this extended cookie at all D 6 2 5 Differences In Punctuation In Netscape s original proposal the values in attribute value pairs did not accept quoted strings Servers should be cautious about sending values that require quotes unless they know the receiving user agent understands them i e is using new cookies A new user agent should only use quotes around values in Cookie headers when the cookie s version is compliant with this specification In Netscape s original proposal no whitespace was permitted around the that separates attribute value pairs Such whitespace should therefore be used with caution in new implementations For backward compatibility the separator in the Cookie header is the semi colon everywhere A server should also accept the comma as the separator between cookie values for future compatibility TekHTML accepts the character as a valid separator in the Set Cookie header and generates Cookie requests using only as a separator Quoted strings are generated only if the value string from an incoming cookie contains spaces and this automatically means that such a cookie came from a new Web server which apparently is willing to accept quoted cookies back
195. plays the Base Station Menu 3 Press the Configure button next to General Options on the Base Station Menu The CommServer displays the Configure Existing Base Station screen See General Options on page C 136 for more information about this screen B 2 Setting The Terminal Range Hosts The Terminal Range in each General Host Options screen represents host emulation numbers It maps terminal numbers on the host to the host emulations on the 9500 CommServer A range of n terminals host emulations in the host screen matches the lower number in the range to the first terminal defined on this host and the higher number in the range to the nth terminal defined on this host B 4 Psion Teklogix 9500 Communications Server User Manual Appendix B Setting Terminal Numbers On The CommServer Systems With One Host When the range starts at 1 the host terminal number is identical to the host emulation number in other words the offset is equal to zero When the range starts with a number other than 1 an offset is created equal to the lower number minus 1 For instance the range 10 to 20 sets an offset of 9 and matches the first terminal on this host to host emulation 10 The examples in this chapter demonstrate the effect of such offsets E Note In the following examples no offsets were defined in the Base Station screens base station offsets are explained in Section B 3 on page 9 Thus in these examples the ter
196. r A value of 0 zero disables this feature Visible Match Character Textbox Visible Match Character Values 0 127 Default lt none gt With field matching the host computer preloads data into an entry field Now the terminal operator can make an entry that matches this preloaded data For visible match fields the preloaded data will be displayed in the entry field at the operator s terminal The application program distinguishes an entry field as a match field by preceding it with a special character The special character is entered as the decimal character code for one of the first 127 ASCII characters A value of 0 zero disables this match field feature For example assume that the gt character ASCII decimal character code 62 is defined for visible match fields This character must immediately precede the entry field Part gt C 40 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 2392 Emulation The field Part gt includes the character gt and is followed by the part number entry field on the screen If any other character was chosen as the last character of the text the entry field would not be a match field The preloaded data sent to a terminal may consist of the exact characters special match characters or a combination of the two The match c
197. reg These emulations do not have function key parameters C 2 3 CommServer Configuration The Base Station Screens Base Stations listbox on Configuration Main Menu 1 Example Base V Create New 1 Example Base Configure New Base i ee The base station screens of the CommServer are accessible from the Base Stations listbox and selection button Base Station Menu Base stations coordinate their own radio link timing unlike Remote Radio Modules RRMs which are coordinated by the CommServer See CommServer Configuration The RRM Groups Screens on page E 140 for more information on configuring RRMs C 132 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommServer Configuration The Base Station Screens 2 3 1 Configure New Base Station l m i i eo Co coco c4 PTX Communications Server Configure New Base Station Psion Teklogix Name Unnamed Base Station Protocol ti TCPyP gt First Terminal i Message Size ho Auto Startup Vv OK Cancel Copyright 2002 Psion Teklogix Inc In this screen the user can set options for a new base station Name Textbox Name Values lt any text string gt Default Unnamed Base Station This textbox allows the user to enter a name for the new base station Protoco
198. rentiate between terminals that communicate with one host and those that communicate with another The ranges defined for the hosts can either overlap or be mutually exclusive depending on the desired result AN Important YOU CANNOT OVERLAP AN ANSI HOST WITH ANOTHER ANSI HOST OR WITH A TESS HOST Examples Two hosts with no overlap in terminal numbers Host Emulations on CommServer 1 2 345 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 1 2 3 4 5 6 7 9 Host 1 1o 11 12 15 16 Terminal ID Numbers Terminal ID 1 Terminal ID 20 ramets ttt aha Base Station 1 Figure B 2 In this system we will define the ranges In the CommServer s General Host Options screen for Host 1 Terminals 1to9 a range of 9 terminals or host emulations for Host 1 Since this range starts at 1 the offset for this host is zero In the CommServer s Configure Existing Base Station screen for Base Station 1 First Terminal 1 no offset on the Base Station B 6 Psion Teklogix 9500 Communications Server User Manual Appendix B Setting Terminal Numbers On The CommServer Systems With Multiple Hosts In our diagram we align the first terminal on Host with host emulation 1 Host Emulations on CommServer 123456789 1 2 3 4 5 7 8 9 Range of Host 1 begins at host emulation 1 Terminal ID 1 Figure B 3 In the CommSer
199. ressed the 9500 displays a confirmation screen Press OK in this screen to save the changes and exit to the main 3274 SNA Protocol Options screen Validate Button The Validate button allows the user to save the changes to the 9500 s database without exiting from the Terminal Naming screen The changes can also be saved through the Main Screen s validation and saving option Psion Teklogix 9500 Communications Server User Manual C 105 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 3274 Emulation SNA Protocol Show Terminals Button Show Terminals The Show Terminals button displays the list of currently configured terminal names When it is pressed the 9500 displays the Terminal Names screen Teklogix 9500 Terminals names 3274 LU LU LU LU LU LU Thum Tnum Tnum Tnum Tnum Tnum Thum Name Name Name Name Name Name Name 1 abce 2 ZYWX ox Copyright 2002 2003 Psion Teklogix Inc This screen displays the configured terminal numbers and names Press OK to return to the Terminal Naming screen The Protocol Options Screen 3274 Emulation SNA Protocol C a S of a Lt Ee c On c 1 2 PTX Communications Server 3274 SNA Protocol Options Eleanor a VA a Psion Teklogix Attention Key ENTER E Use SSCP Sessions v OK Cancel Copyright 2002 Psion Teklogix Inc The CommServer
200. reverse compile or translate the Program c You may not sublicense rent or lease the Program and d If you breach any terms of this Agreement your license may be terminated You must then destroy all copies of the Program 3 DISCLAIMER IBM does not warrant uninterrupted or error free operation of the Program or that IBM will correct all Program defects You are responsible for the results obtained from the use of the Program IBM AND ITS SUPPLIERS DISCLAIM ALL WARRANTIES AND CONDITIONS EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OR CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE SOME STATES OR JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF E 8 Psion Teklogix 9500 Communications Server User Manual Appendix E Software License Agreements For IBM Personal Communications Software EXPRESS OR IMPLIED WARRANTIES SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU YOU MAY HAVE OTHER RIGHTS WHICH VARY FROM STATE TO STATE OR JURISDICTION TO JURISDICTION 4 LIMITATION OF LIABILITY In no event shall IBM or its suppliers be liable for any a loss of or damage to data b special incidental or indirect damages or for any economic consequential damages or c lost profits business revenue goodwill or anticipated savings In any case IBM s entire liability shall be limited to a damages for bodily injury including death and damage to real property and tangible personal property and b the
201. rminals User Manual for information about setting parameters on the terminal for pass through Procedures Checkbox Procedures Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer is allowed to send TESS procedures to the terminals A TESS procedure is a group of TESS commands that can be executed by the TESS execute procedure command Local Checkbox Local Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer is allowed to provide pages to be loaded as local TESS procedures in the terminals The local procedures are selected from a menu at the terminal The terminals can perform these procedures when they are offline Later when the terminals are online they send the results of these functions to the host Note The Procedures parameter also must be enabled for Local to work TSF O Checkbox TSF O Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer uses Psion Teklogix Screen Formatter Optimizer software C 36 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 2392 Emulation Host Print Checkbox Host Print Values lt selected gt lt unselected gt Defa
202. roup Menu has two Configure buttons which are located next to the following text e General Options When the user presses this Configure button the CommServer displays the Configure Existing RRM Group screen Psion Teklogix 9500 Communications Server User Manual C 149 Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens e RRMs RRM Groups V When the user selects the name of an existing RRM from the listbox then presses this Configure button the CommServer displays the RRM Options screen for that RRM RRM Groups listbox on Configuration Main Menu Configure Configure New RRM 1 Example Group V Create New 1 Example RRM RRM Menu The RRM Groups screens of the CommServer are accessible from the RRM Groups listbox and selection button There is also a selection in the listbox Create New for adding a new RRM There is also an Analyze button When the user presses the Analyze button the CommServer displays a screen listing parameters for the RRM system See Analyze RRM Group on page C 156 At the bottom there is a Main Menu button When the user presses the Main Menu button the CommServer displays the Configuration Main Menu C 150 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens
203. rs 1 through 20 In the Configure Existing Base Station screen for Base Station 2 First Terminal 10 creates a range of 11 terminals Host emulation 10 is mapped to RF terminal ID 1 an offset of 9 The upper range of terminals will be host emulation 20 RF terminal ID 11 Thus the result of this setup is Terminal ID 1 9 can communicate to Host 1 only if communicating via Base Station 1 or to Host 2 only if communicating via Base Station 2 Host Emulations on CommServer 123 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 2 3 4 5 6 7 8 9 Hostl 1 2 3 ATS Base Station 1 sen 000000900 Base Station 2 Terminal ID 1 Figure B 12 B 16 Psion Teklogix 9500 Communications Server User Manual Appendix B Setting Terminal Numbers On The CommServer Setting The Terminal Range Base Stations Terminal ID 10 11 can communicate to Host 2 only using host emulation 1 amp 2 if communicating via Base Station or using host emulation 10 amp 11 if communicating via Base Station 2 Host Emulations on CommServer 123 4 5 67 8 9 10 11 12 13 14 15 16 17 18 19 20 10 11 10711 Base Station 2 Terminal ID 1 Terminal ID 11 Terminal ID Numbers Figure B 13 Terminal ID 12 20 can only communicate with Host 2 via Base Station 1 Host Emulations on CommServer 123 4 5 67 8 9 10 11 12 13 14 15 16 17 18 19
204. ry Attributes supported ACCESSKEY FKEYO NENTER FKEY HREF NAME SIZE TEK FLAGS TYPE VALUE Terminal and console Attributes supported ER loput omms iied ACTION and METHOD support The image is not printed it Terminal and is replaced with the text of Ses tings console the ALT attribute l limited Ifthere is no ALT attribute support the image is replaced with the text IMG D 6 Psion Teklogix 9500 Communications Server User Manual Appendix D Developing HTML For The CommServer Text Attribute Tags D 2 2 Text Attribute Tags Tag Meaning Support Tag Specific Information Terminal and This tag is mapped to the ere PUIK console TESS blinking attribute Terminaland This tag is mapped to the ee Pole console TESS bold attribute There is no support in TESS i for this tag Text using it is lt STRONG gt Strong text Console only rendered faa different colaue on the Windows console Terminal and This tag is mapped to the aad Vanerne console TESS underline attribute Strikeout There is no support in TESS lt S gt Place li c le onl for this tag Text using it is lt STRIKE gt ee oo onsols onY rendered in a different colour en on the Windows console Terminal and These tags are treated as para lt H1 gt lt H2 gt console graph markers lt P gt because lt H3 gt lt H4 gt Heading es eae limited there is no support for fonts STRESO support in TESS
205. s e For 3274 emulations see page C 50 e For 5250 emulations see page C 67 Only 3274 and 5250 emulations may be configured to use this option Psion Teklogix 9500 Communications Server User Manual C 3 Appendix C The 9500 CommServer s Web Interface The CommServer s Host Application Screens If no host application is configured to present screens through HTML HTTP the CommServer displays the following screen to browsers connecting at port 80 E Psion Teklogix Host Selection Screen Microsoft Internet Explorer provided by Psion Teklogix File Edit View Favorites Tools Help Back gt i Al address ja http 10 128 5 58 cqi bin host_sel exe ERROR No HTML enabled hosts found If one host application is configured to present screens through HTML HTTP the CommServer briefly displays a redirect screen to browsers connecting at port 80 then displays the opening screen of the host application If a host application is present but misconfigured so that the CommServer cannot connect to the host the CommServer displays the following screen E Psion Teklogix Host Communications Error Page Microsoft Internet Explorer provided by Psion Teklogix File Edit View Favorites Tools Help Bak gt Q Ai address 4 http 10 128 5 58 cqi binfhost_com exe tek_select_host 1 Failed to open a connection to host emulator The host emulator may be misconfigured or is
206. s 10 20 fall within the ranges of both Host 1 and Host 2 and will therefore be able to communicate with both of them For instance Psion Teklogix RF terminal 13 corresponds to terminal 13 on Host 1 and to terminal 4 on Host 2 and will be given a choice of hosts with which to communicate assuming they are both TESS hosts RF terminals and host emulations 1 9 fall within the range of Host 1 only and will therefore only be able to communicate with Host 1 These terminals will not be given a choice of hosts with which to communicate In other words when the user sets the terminal ID to a number between 1 and 9 the 9500 CommServer finds only one match for that host emulation and knows which host terminal to associate with this ID number However when the user sets the terminal ID to a number between 10 and 20 the CommServer can find two matches for that host emulation and will present the user with the choice between them If for instance the terminal ID number is set to 13 the user can choose to be either terminal 13 on Host 1 or terminal 4 on Host 2 B 3 Setting The Terminal Range Base Stations The terminal ranges in the Configure Existing Base Station screens also act as offsets However these offsets are in the opposite sense to those of the offsets in the General Host Options screens The range specified in the Configure Existing Base Station screens maps the host emulations to the terminal ID numbers
207. s the port number can range from 1024 to 32767 E Note The 9150 must be in RRM mode and must have the same port number config ured It listens to this port for incoming data from the CommServer which includes the CommServer s IP address Psion Teklogix 9500 Communications Server User Manual C 153 Appendix C The 9500 CommServer s Web Interface CommsServer Configuration The RRM Groups Screens 2 4 5 Configure Existing RRM Ds Ei i mo ce mo m 1 2 PTX Communications Server Configure RRM Name Sport IP Address 0 0 0 0 116132 OK Cancel Delete Copyright 1999 2000 Teklogix Inc The CommServer displays this Configure Existing RRM screen after the user has selected an existing RRM from the listbox and pressed the Configure button Name Textbox Values lt see text gt Default Unnamed RRM This textbox allows the user to enter a name for the RRM IP Address And Port Textboxes IP Address Values lt see text gt Default IP Address lt none gt Port 16132 These textboxes allow the user to enter the IP address and port number of the RRM The IP address may be any valid IP address the port number can range from 1024 to 32767 E Note The 9150 must be in RRM mode and must have the same port number config ured It listens to this port for incoming data from the CommServer which includes the CommServer s IP address C 154 Psion Teklogix 950
208. send the appropriate TESS Change Font command to the terminal Psion Teklogix terminals use the font code to specify what font to use See Fonts And Font Codes on page E 45 for a listing of fonts and font codes Enable Colour Support Checkbox Enable Colour Support Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer uses coloured text in the host screens it sends to the terminals Foreground Colour Listbox Foreground Colour V Values Aqua Black Blue Fuschia Gray Green Lime Maroon Navy Olive Purple Red Silver Teal White Yellow Psion Teklogix 9500 Communications Server User Manual C 79 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation Default Black This listbox allows the user to select the foreground colour the colour of the text that the CommServer s HTTP server will send to terminals connecting via HTTP The choices are the 16 predefined HTML colour names Background Colour Listbox Background Colour V Values Aqua Black Blue Fuschia Gray Green Lime Maroon Navy Olive Purple Red Silver Teal White Yellow Default Silver This listbox allows the user to select the background colour the colour of the HTML page that the CommServer s HTTP server will send to terminals connecti
209. sent on the network for the feature to operate properly Preferred Primary Checkbox Preferred Primary Values lt selected gt lt unselected gt Default lt selected gt Psion Teklogix 9500 Communications Server User Manual C 169 Appendix C The 9500 CommServer s Web Interface Redundancy Options 802 1Q v2 Features This checkbox indicates whether this CommServer is the preferred primary CommServer Backup IP Address Checkbox Backup IP Address Values lt any valid IP address gt Default 0 0 0 0 This parameter contains the address of the other CommServer with which this CommServer communicates Alias IP Address Textbox Alias IP Address Values lt any valid IP address gt Default 0 0 0 0 This parameter contains the alias IP address for this CommServer and the other CommServer in the redundancy system This address must be the same on both the primary and secondary CommServers Devices on the network may have more than one IP address corresponding to their network interface and hardware address The primary CommServer presents the alias address to the network as well as its own unique IP address The secondary CommServer only presents its own unique IP address to the network When the secondary CommServer becomes the primary it starts to use the alias IP address The old primary CommServer which becomes the secondary stops using the alias IP address Devices on the networ
210. ssion on terminal number 2 receives a virtual device name of TLX0002A The prefix must use the SNA Type A character set which includes uppercase letters A Z numbers 0 9 and the special characters and Lower case letters are accepted and translated to uppercase characters An SNA Type A character string must not begin with a number Psion Teklogix 9500 Communications Server User Manual C 113 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 5250 Emulation SNA Protocol The Protocol Options Screen 5250 Emulation SNA Protocol PTX Communications Server 5250 SNA Protocol Options 5250 SNA Psion Teklogix Host Name TLXLCPN User Name and Password TEKUSER pm Enable Connect Screen d Reconnection Timeout seconds Bo Maximum Reconnection Attempts BO Mode 1 Name LU Prefix Number of First and Last Terminals fapcsupe fixe fi fa _ Mode 2 LC TC 1P IP Mode 3 IC Jb Jb_ Mode 4 C TC Ilb IP _ Mode 5 C JTC Ib Ib _ Mode 6 C JTC Ib IP _ Mode 7 C JTC Ib Ib _ Mode 8 C TC Ib JIP _ OK Cancel Copyright 2002 Psion Teklogix Inc The CommServer displays this version of the Protocol Options screen after the user has selected the 5250 SNA emulation protocol combination for this host connection E Note The screen shown here gives the protocol options for a host named 5250 SNA Host Name Textbox HostName
211. t Line Print Form Length Barcode Entry Line Field Overhead a yy Command Region HTML HTTP Options Enable Colour Support OH Foreground Colour Black x Background Colour Silver z User Data Font Size 3g Function Key Font Size 8pt 7 TSF O K _OK Cancel Psion Teklogix 9500 Communications Server User Manual C 65 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation The CommServer displays this version of the Emulation Options screen after the user has selected the 5250 Telnet or 5250 TESS emulation protocol combinations for this host connection E Note The screen shown here gives the emulation options for a host named Fred With IBM 3274 or IBM 5250 emulation the CommServer converts the application datastream from the host to TESS TEklogix Screen Subsystem or HTML HyperText Markup language data Some of the options in this screen govern this conversion of the host screens to TESS or HTML Write Error Code Listbox Write Error Code V Values advisory text screen text Default advisory text If advisory text is selected here the CommServer sends error codes to the terminal screen as advisory text which is written at the bottom of the screen If screen text is chosen the CommServer sends the error codes as regular screen text Field Underline Remapping Listbox Field Underline
212. tables are unsupported by the emulator When the emulator encounters an unsupported tag it removes the tag and its corresponding end tag from the TESS datastream sent to the terminal but does not remove any text surrounded by the tags Thus HTML source text containing the unsupported tag lt UNKNOWN gt such as text lt UNKNOWNsmore text lt UNKNOWN gt still more text would be rendered on the terminal as text more text still more text Ignored Tags The CommServer s HTML emulator ignores two tags lt SCRIPT gt and lt STYLE gt When it encounters one of these tags it removes the tag and its associated end tag from the TESS datastream sent to the terminal and it also removes the text and any other tags surrounded by the lt SCRIPT gt and lt STYLE gt tags Thus HTML source text containing the ignored tag lt SCRIPTs gt such as text lt SCRIPTsmore text lt SCRIPT gt still more text would be rendered by TekHTML on the terminal as text still more text In this way TekHTML prevents the text of embedded Javascript and stylesheet information from being passed to the terminals and displayed on their screens D 4 Psion Teklogix 9500 Communications Server User Manual Appendix D Developing HTML For The CommServer Link Miscellaneous And Input Tags D 2 1 Link Miscellaneous And Input Tags Tag Meaning Support Tag Specific Information lt HEAD gt Information about page Terminal and conso
213. tart button causes the CommServer to display a warning screen asking for confirmation of the request to restart If confirmation is given to reboot the CommServer displays a last Restarting screen then is offline while it reboots See Restart The CommServer Software on page C 180 for details Validate And Save Current Configuration Validate Pressing the Validate button causes the CommServer to check the contents of its configuration cache where recent changes are stored The CommServer then displays a screen listing any errors then offers the choice to commit to the new configuration revert to the last saved configuration or cancel and return to the main screen See Validate and Save Database Contents on page C 181 for details C 18 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens C 2 2 Controller Configuration The Host Screens Hosts listbox on Configuration Main Menu 1 Example Host V Create New ar 1 Example Host Configure New Host J The host screens of the CommServer are accessible from the Hosts listbox and selection button 2 2 1 Configure New Host LJ a Sco i a A mm 1 2 ve PTX Communications Server Configure New Host gt Psion Teklogix Name Unnamed Host Enabled
214. tation 1 First Terminal 1 since this will map host emulation 1 to RF terminal ID 1 the offset for this Base Station is zero Thus host emulations 1 20 will match terminal ID numbers 1 through 20 B 12 Psion Teklogix 9500 Communications Server User Manual Appendix B Setting Terminal Numbers On The CommServer Setting The Terminal Range Base Stations In the Configure Existing Base Station screen for Base Station 2 First Terminal 10 creates a range of 11 terminals Host emulation 10 is mapped to RF terminal ID 1 an offset of 9 The upper range of terminals will be host emulation 20 RF terminal ID 11 Thus the result of this setup is Terminal ID 1 9 have two matching host emulations one via Base Station 1 the other via Base Station 2 For example terminal ID 4 is mapped both to host emulation 4 via Base Station 1 and to host emulation 13 via Base Station 2 Host Emulations on CommServer 12 3 4 5 67 8 9 10 11 12 13 14 15 16 17 18 19 20 Host 1 1 2 3 4 5 7 8 9 10 1122 13 14 25 16 17 18 Base Station 1 OO0Q0d20C0CC0Ce8 A Terminal ID Numbers Terminal ID 1 Base Station 2 OCO OCOOOSGO A Terminal ID Numbers Terminal ID 1 Figure B 8 Psion Teklogix 9500 Communications Server User Manual B 13 Appendix B Setting Terminal Numbers On The CommServer Setting The Terminal Range Base Stations Terminal ID 10
215. tbox Barcode Values 0 127 Default lt none gt Barcode input only fields are special entry fields that only accept input from a bar code reader The application program distinguishes an entry field as barcode input only by preceding the field with a special character This textbox contains the decimal representation of the ASCII character code of this special character A value of 0 zero disables this feature Entry Line Textbox Entry Line Values 0 24 Default lt none gt This textbox contains the number of the first line displayed if there is no entry field in the upper left portion of the screen and if an entry field is at or below this line The Entry Line parameter allows an automatic offset within the host screen so that the area displayed by the terminal includes an entry field that would normally be out of bounds Normally Psion Teklogix terminals only display the upper left corner of the application screen because of their smaller display size Psion Teklogix 9500 Communications Server User Manual C 61 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 3274 Emulation Field Overhead Textbox Field Overhead _ Values 0 80 Default 5 This textbox contains the maximum number of characters allowed between two fixed fields which still allows the CommServer to join them into one field Sometimes the
216. terface CT IntroductOti s s i ene a on ee eg ce ee Ba ee a C 3 C 1 1 About The 9500 CommServer s Web Interface C 3 C 1 2 The CommServer s Host Application Screens C 3 C 1 2 1 The Host Application Screens C 3 C 1 2 2 Limitations Of The Host Application Screens C 5 C 1 3 The CommServer s Web Configuration Screens C 5 C 1 3 1 Items Common To Many Screens C 8 C 1 3 2 Finding Screens 2204 C 9 C 1 3 3 Maps Of The CommServer s Web Interface C 12 C 2 The Web Configuration Screens 2404 C 14 C 2 1 The Configuration Main Menu Screen C 14 C 2 1 1 Controller Configuration C 15 C 2 1 2 Redundancy Configuration C 16 Psion Teklogix 9500 Communications Server User Manual Contents C 2 1 3 SNA Protocol Configuration C 16 C 2 1 4 System Configuration C 17 C 2 1 5 MiscellaneousCommands C 18 C 2 2 Controller Configuration The Host Screens C 19 C 2 2 1 Configure New Host C 19 C 2 2 2 TheHostMenu C 22 C 2 2 3 General Host Options C 23 C 2 2 4 Emulation Options C 26 C 2 2 5 Protocol Options C 87 C 2 2 6 Function Key Mapping C 123 C 2 3 CommServer Configuration The Base Station Screens C 132 C 2 3 1 Configure New Base Station C 133 C 2 3 2 The Base Station Menu C 135 C
217. the Configure New RRM Group screen page C 140 1 Select the Create New option from the RRM Groups dropdown menu 2 Press the Configure button The Configure New RRM Group screen page C 142 appears 3 Fill in the parameters for the new RRM group 4 Press the OK button The Confirmation screen appears 5 Press the OK button The Main Menu screen appears again Next add individual RRMs to the newly created group 6 Select the RRM group from the RRM Groups dropdown menu Press the Configure button The Configure New RRM Group screen page C 142 appears C 140 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface CommServer Configuration The RRM Groups Screens 7 Press the Configure button The RRM Group Menu screen page C 149 appears 8 Select the Create New option from the RRMs dropdown menu 9 Press the Configure button The Configure New RRM screen page C 153 appears 10 Fill in the parameters for the new RRM 11 Press the OK button The Confirmation screen appears 12 Press the OK button The RRM Group Menu screen appears again At this point more RRMs can be added to the group To add another RRM group return to the main menu and select the Create New option from the RRM Groups dropdown menu again RRM groups and RRMs use narrowband FM radio The performance of such groups depends critically on the radio parameters and these interact complexly Psion
218. the Register button depending on whether you have previously registered for Teknet or the Partner Program Your UserID and password are the same for TekNet and the Partner Program Once you have logged in search for the Support Request Form F 2 Product Repairs International For product repairs please contact your local Psion Teklogix office listed on our worldwide website http www psionteklogix com Click on the heading labelled Contacts to choose a Psion Teklogix technical support representative closest to you Canada U S A Canadian and U S customers can receive access to repair services by calling the toll free number below or via our secure website see Technical Support above A amp L Note Customers calling the toll free number should have their Psion Teklogix customer number or trouble ticket number available Voice 1 800 387 8898 press option 2 Fax 1 905 812 6304 Web Site _http service psionteklogix com Psion Teklogix 9500 Communications Server User Guide F 1 F 3 Worldwide Offices COMPANY HEADQUARTERS And Canadian Service Centre Psion Teklogix Inc 2100 Meadowvale Blvd Mississauga Ontario Canada L5N 7J9 Tel 1 905 813 9900 Fax 1905 812 6300 E mail salescdn psion com NORTH AMERICAN HEADQUARTERS AND U S SERVICE CENTRE Psion Teklogix Corp 1810 Airport Exchange Boulevard Suite 500 Erlanger Kentucky USA 41018 Tel 1 859 371 6006 Fax 1 859 371 6422 E mail
219. the example below the Users listbox on the CommServer s Configuration Main Menu has a listbox containing the names of the users along with a Create New selection There are at least two screens accessible by pressing the Configure button C 10 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface The CommServer s Web Configuration Screens One screen the New User screen allows the addition of a new user The other screens the User screens give the details of the existing users There is one User screen for each user All of these screens however are represented as one in the screen key The Users listbox on the Configuration Main Menu 1 Create New Vv the New User screen 1 Create New 2 Sue H Set up new user Change settings for user Sue a User screen The screen key for the User and New User screens Psion Teklogix 9500 Communications Server User Manual C 11 Appendix C The 9500 CommServer s Web Interface The CommServer s Web Configuration Screens C 1 3 3 Maps Of The CommServer s Web Interface 9500 Communications Server Main Configuration Screen Controller Configuration Hosts Base Stations RRM Groups Radio Link Features 802 1Q v1 And v2 Features General Options
220. the last terminal for this host emulation e The LU prefix The PU name for this host emulation s LUs C 108 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 3274 Emulation SNA Protocol The PU name is optional and may be specified in this screen It is only needed if the administrator is connecting to a host that has multiple PUs configured and wishes to specify which PU is to be used by the CommServer When the Update button is pressed the CommServer changes the configuration file and displays a confirmation screen similar to this screen PTX Communications Server Update Results Psion Teklogix C IBMPCOMM private dummy acg was successfully updated for terminal range 1 32 Boe Copyright 2002 Psion Teklogix Inc Press OK in this screen to return to the Main Menu Psion Teklogix 9500 Communications Server User Manual C 109 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 5250 Emulation Telnet Protocol The Protocol Options Screen 5250 Emulation Telnet Protocol J L E e I CAC We U OOU000 1 2 PTX Communications Server ve 5250 Telnet Protocol Options Unnamed Host Psion Teklogix Terminal Type fiBM 5251 11 gt Host Port 23 Maximum Sessions per Terminal fa
221. the screen buffer An attribute placed between column 2 and the end of the word PASSTHRU will push all following characters one position to the right Therefore any required attributes should occupy column 1 of the first line Gust preceding the word PASSTHRU For example column 12345678 9 line 1 PAS STHRU line 2 PART 12345 where is an attribute When the CommServer is finished sending the data to the terminal s printer it will send an ENTER key to the host The host must wait for the ENTER key before sending any more screens including other PASSTHRU screens to this terminal E Note Refer to the Terminals User Manual for information about setting parameters on the terminal for pass through Psion Teklogix 9500 Communications Server User Manual C 53 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 3274 Emulation Procedures Checkbox Procedures Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer is allowed to send TESS procedures to the terminals A TESS procedure is a group of TESS commands that can be executed by the TESS execute procedure command Local Checkbox Local Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer is allowed to provide p
222. tion The Host Screens The Protocol Options Screen 2392 Emulation Telnet Protocol Default 10000 This textbox specifies the first port number at which the CommServer will listen for telnet connection requests to the terminals EL Note Entering a value of 0 disables this option Auto telnet login Enable Listbox Auto telnet login enable V7 Values DISABLE AUTO TELNET Default DISABLE This listbox allows the user to choose whether auto telnet sessions are allowed to connect to this host Auto telnet Host Textbox Auto telnet Host Values lt any host ID gt Default lt none gt This parameter specifies a host ID to which auto telnet requests will be directed Auto Telnet Without User Action Checkbox Auto Telnet Without User Action V Values lt selected gt lt unselected gt Default lt selected gt If this checkbox is selected the CommServer will attempt to connect to a configured Auto Telnet host by auto telnet whenever that host is available Psion Teklogix 9500 Communications Server User Manual C 99 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 3274 Emulation Telnet Protocol The Protocol Options Screen 3274 Emulation Telnet Protocol J E C4 L E Mia co L A COO co oo 1 2 PTX Communications Server ve 3274 Telnet Protocol Options 3274 Psion Teklogix Termin
223. tion Options Screen ANSI Emulation Available character sets include ASCII DEC Multi DEC Graphical British DEC Danish DEC Dutch DEC Finnish DEC French DEC French CDN DEC German DEC Italian DEC Portuagal DEC Spanish DEC Swedish DEC Swiss DEC Arabic Thai and a Not Listed selection Upper Character Set GR Listbox Upper Character Set GR V Values lt see text gt Default DEC Multi This listbox allows the user to select the character set to be used for the second 128 character codes decimal 128 to 255 hex 80 to FF Available character sets include ASCII DEC Multi DEC Graphical British DEC Danish DEC Dutch DEC Finnish DEC French DEC French CDN DEC German DEC Italian DEC Portuagal DEC Spanish DEC Swedish DEC Swiss DEC Arabic Thai Latin 1 Latin 2 Latin 3 Latin 4 Latin 5 Latin 6 Cyrillic ISO Arabic ISO Greek ISO Hebrew ISO and Thai ISO C 32 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 2392 Emulation The Emulation Options Screen 2392 Emulation Ece E L s 4 _ fee l m om e 1 2 PTX Communications Server 2392 Emulation Options Elaine Psion Teklogix 2392 Options Send CR with FKEY O TESS Options Alarm Clear Passthru Procedures Local TSF O Host Print
224. tion protocol combinations See page C 132 Psion Teklogix 9500 Communications Server User Manual C 123 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The ANSI Function And Arrow Key Mapping Screen The ANSI Function And Arrow Key Mapping Screen PTX Communications YY ae Server ANSI Function and Arrow Key Mappings ANSI L_ Psion Teklogix Fi fib4iso0000000000 F2 fib4ts1 0000000000 1 F3 fib 4652 00 00000000 0 F4 1b 453 00 00 00 00 00 oo te FS fibsb 31367e000000 F6 Mesenas mm F7 fibsb31387e 000000 F8 b 5b 31 39 7e 00 00 00 F9 1b 5b 32 30 7e 00 00 00 2 F10 fibsb 3231 7e000000 Fil fibSb 32337e000000 F12 ib 5b 32 34 7e 00 00 00 F13 ib 5b 32 35 7e 00 00 00 F14 fib5b 32367e000000 F15 fibSb 32387e000000 F16 fib5b 32397e000000 F17 ib 5b 33 31 7e 00 00 00 Fis fibsb 33327e 000000 Fig fib5b 33337e000000 F20 fib b 33347e000000 F21 ib 5b 31 7e 00 00 00 00 F22 fibSb 32 7e00000000 F23 fibSb 337e00000000 F24 fibSb 347e00000000 F25 1b 5b 35 7e 00 00 00 00 F26 ib 5b 36 7e 00 00 00 00 F27 fibSb 3431 7e 000000 F28 fibSb 34327e000000 F29 ib 5b 34 33 7e 00 00 00 F30 ib 5b 34 34 7e 00 00 00 Up fibsb 410000000000 Down fibSb 42 0000 000000 Right fib5b 43 00 00 000000 Left ib 5b 44 00 00 00 00 00 ok Cancel Copyright
225. tions for this host connection E Note The screen shown here gives the emulation options for a host named Cecil Refrain From Sending Online amp Offline Messages Checkbox Refrain from sending Online amp Offline messages Values lt enabled gt lt disabled gt Default lt disabled gt If this checkbox is enabled the CommServer does not send terminal offline and terminal online messages to the host Psion Teklogix 9500 Communications Server User Manual C 81 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen RF Modem Emulation The Emulation Options Screen RF Modem Emulation S paol OOO PTX Communications Server ve RF Modem Emulation Options Greg Psion Teklogix These parameters are not applicable to the RF Modem emulation Cancel Copyright 2002 Psion Teklogix Inc The CommServer displays this version of the Emulation Options screen after the user has selected the RF Modem Telnet emulation protocol combinations for this host connection ELA Note The screen shown here gives the emulation options for a host named Greg This emulation is intended for a CommServer communicating with a Psion Teklogix Model 6040 RF Modem since the 6040 simply passes serial data through to connected serial devices there are no emulation options C 82 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9
226. tions rely on the video attributes of displayed characters to highlight fields particularly entry fields For example the application screen may define all entry fields with reverse video and fill the field with spaces This is effective on terminals that support reverse video but on terminals that do not it can make the field invisible since it is made up entirely of spaces By default all empty entry fields displayed at the Psion Teklogix terminal are highlighted by the entry character chosen in the terminal s configuration not all Psion Teklogix terminals support video attributes The Clear feature creates an empty entry field in place of an entry field filled with spaces Note This operation is only performed on screens received from the host Data sent to the host remains unaffected Passthru Checkbox Passthru Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer allows the host to send data directly to the RF terminal s serial port This is most commonly used for printing Preparing Host Screens for Pass Through On the screen to be sent through the terminal serial port the word PASSTHRU in capital letters must appear on the first line starting on the second column The actual data to be sent to the terminal may start anywhere below the first line With 5250 or 3274 emulations attributes occupy a position in the screen buffer An attr
227. to connect to the host if the first attempt fails The Mode Parameters Each SNA mode has four associated parameters Name LU Prefix First terminal number and Last terminal number Name Textbox Name Values lt see text gt Default QPCSUPP This listbox contains the name of the mode on the host to use The name must use the SNA Type A character set which includes uppercase letters A Z numbers 0 9 and the special characters and Lower case letters are accepted and translated to uppercase characters An SNA Type A character string must not begin with a number C 116 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Protocol Options Screen 5250 Emulation SNA Protocol LU Prefix Textbox LU Prefix Values lt see text gt Default TLX This textbox contains the exchange identifier for this host connection This is the prefix attached to the terminal number to form the LU name The prefix may be 1 to 5 characters long and the terminal number may be 1 to 4 characters long The maximum length of the LU name formed from these is eight characters First Terminal Textbox First Terminal Values lt see text gt Default 1 This textbox contains the number of the first terminal which uses this mode and this host connection Last Terminal Textbox Last Terminal Values
228. to Host Print where the host makes the initial print request E Note Support for printing must be enabled at the terminal refer to the appropriate terminal user manual for more information Pages Textbox Pages Values 0 79 Default 8 The number of host screens or pages stored at the terminal The CommServer reduces data transmitted to the terminals by using the terminal s capability to store a page of data for each screen it displays The CommServer maintains an image of each page stored at the terminal After receiving an application screen the CommServer tries to match the screen with a stored page If a similar page is already in the terminal s memory the CommServer simply instructs the terminal to re display its copy of the page only the necessary changes are sent from the CommServer If no match is found the complete page is sent to the terminal over the radio link E Note There is a corresponding parameter on the terminal itself and the actual number of saved pages will be the smaller of the two values C 56 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 3274 Emulation Transmit Line Textbox Transmit Line fal Values 0 24 Default lt none gt When this feature is enabled all modified data at the terminal will be automatically transmitted when the operator
229. to Startup Checkbox Auto Startup Values lt selected gt lt unselected gt Default lt unselected gt Psion Teklogix 9500 Communications Server User Manual C 165 Appendix C The 9500 CommServer s Web Interface CommServer Configuration 802 1Q v1 And v2 Features When checked this parameter enables the Psion Teklogix 802 IQ protocol v1 or v2 to start automatically when the CommServer is rebooted Terminal Offline Timeout Textbox Terminal Offline Timeout Values 1 240 Default 5 This parameter sets the time in minutes before the 9500 will declare an 802 IQ terminal offline Beacon Period Textbox Beacon Period Values 1 20 Default 2 This parameter sets the duration in seconds of a beacon 802 10 vl Features Enabled Checkbox Enabled Values lt selected gt lt unselected gt Default lt unselected gt When checked this parameter enables 802 IQ v1 Beacon Gateway Interface Listbox Beacon Gateway Interface Configured 0 Ethernet V Values lt index gt Ethernet lt MAC address gt Default 0 Ethernet lt MAC address gt This parameter specifies the physical network interface through which the CommServer will send 802 IQ v1 beacon packets The CommServer may have up to two Ethernet interfaces The interface is identified by its index number and MAC address C 166 Psion Teklogix 9500 Communications Server User Manual
230. to respond automatically to requests The autoresponse feature is only enabled if a valid file is specified and if a valid range of terminals is enabled for autoresponse If the screen capture option av lt filename gt is also enabled TeKHTML terminates after one pass through the URL list D 18 Psion Teklogix 9500 Communications Server User Manual Appendix D Developing HTML For The CommServer Cookies D 6 Cookies The following material is provided for Web developers who want to use cookies for state tracking It is assumed that the developer is already familiar with the basic concepts of cookies D 6 1 Overview Of Cookie Transfer The cookie is always generated at the Web server The cookie is sent to the browser as part of the server response along with the requested page The cookie is sent as a special header Set Cookie UserName John Doe Version 1 Path cgi bin Max Age 120 Here is the formal grammar of the Set Cookie header Set Cookie NAME VALUE Expires dateValue Domain domainName Path pathName Secure The web server can send more than one cookie in the response The browser accepts all of them This Perl script can be a starting point for a Web developer usr local bin perl maxage SENV QUERY_ STRING Sage Max Age Smaxage Sexp Expires m_exp path Path cgi bin Sver Version 1 print Set Cookie UserName John Doe Sver Sage path e
231. ton causes the CommServer to display the Configuration Main Menu C 8 Psion Teklogix 9500 Communications Server User Manual 2 Appendix C The 9500 CommServer s Web Interface The CommServer s Web Configuration Screens To make changes permanent validate them by pressing the Validate button on the CommServer 5 Configuration Main Menu The CommServer then checks the changes for errors The changes may be saved by pressing the Commit button on the Database Validation Results screen Cancel Button This button discards any changes that have been made to the values in this screen and displays the Main Configuration screen From some screens this button may display the Hosts menu the Base Stations menu the RRM Groups Menu or the Database Backup menu From any of these menus pressing the Main Menu button causes the CommServer to display the Configuration Main Menu Main Menu Button Main Menu This button displays the Configuration Main Menu when it is pressed in the Hosts Menu the Base Stations Menu the RRM Groups Menu or the Database Backup Menu C 1 3 2 Finding Screens Two pages of maps starting on page C 12 show the relations of the various screens of the 9500 Communications Server s web interface Psion Teklogix 9500 Communications Server User Manual C 9 Appendix C The 9500 CommServer s Web Interface The CommServer s Web Configuration Screens In the lower right corner of each map is a screen key showing t
232. tons as dark rectangles with white text C 6 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface The CommServer s Web Configuration Screens e Checkboxes A checkbox allows the user to CRC MW select or deselect an item indepen dently of other items similarly to checking offitems on a list The selected item is indicated by a dot an X a check mark Y or some other mark filling the centre of the checkbox Checkboxes are usually rendered by the browser as squares This manual will indicate check boxes as squares Selected checkboxes are shown as squares containing checkmarks checkbox text V checkbox text e Radiobuttons Like checkboxes radiobuttons P We nines allow the user to select an item However radiobuttons occur in groups and they are mutu ally exclusive when one of the buttons is selected all of the other associated buttons are forcibly deselected This mimics the action of push button station selectors on old fashioned car radios hence the name Radiobuttons are usually rendered by the browser as circular this manual will indicate them as circles Selected radiobuttons are indicated as circles containing dots O Even None e Textboxes A textbox allows the Tnit string JATEOQOLO user to type text into an area of the screen Some textboxes may contain default text This manual indi cates textboxes as rectangles e
233. ts fit the space available Mixing cells with and without width specifications is possible The results may look unusual depending on the amount of data in the cells without a width specification D 10 Psion Teklogix 9500 Communications Server User Manual Appendix D Developing HTML For The CommServer Function Keys D 3 Function Keys D 3 1 Mapping The Function Keys Psion Teklogix terminals have function keys labeled F1 F2 etc These keys may be linked or mapped to the anchor tag lt A gt and the input tag lt INPUT gt within HTML pages When pages using these mappings are accepted by TekHTML and rendered on a Psion Teklogix terminal s screen the user can press the function key referenced by a link or control The terminal then performs the appropriate action requesting a web page or submitting a form Mapping is done on a per link basis and different links can use different mappings There is no global application wide mapping The FKEY attribute within a link tag specifies the number of the function key to be used Currently only the lt A gt and lt INPUT gt tags may contain the FKEY attribute The FKEY attribute may also be expressed as ACCESSKEY These two names may be used interchangeably D 3 1 1 Mapping A Function Key To A Hyperlink Use the following syntax lt A HREF lt URL gt FKEY n gt where lt URL gt is the desired URL and n is the number from 1 to 30 of the desired key For exampl
234. tware E 8 Appendix F Support Services And Worldwide Offices F 1 TechnicalSupport 0 0 eee ee F 1 EZ Product Repairs i oi e wba Sock Pd ee ae She ek oe hs F 1 F 3 Worldwide Offices oaoa aaa a F 2 Psion Teklogix 9500 Communications Server User Manual iii APPENDIX A Ports PinouTs AND CABLE DIAGRAMS A 1 RJ 45 Connector Pinout oaoa A 3 A 2 Serial Connector Pinout 9 pin 24 A 4 A 3 Cable Descriptions DTE DCE Modem Cable for 9400 P N 19680 A 6 DTE DTE Null Modem Cable for 9400 P N 19687 A 6 DTE DTE Null Modem Cable for 9500 P N 3002186 A 7 Psion Teklogix 9500 Communications Server User Manual A 1 Appendix A Ports Pinouts And Cable Diagrams RJ 45 Connector Pinout A I RJ 45 Connector Pinout 1 2 3 4 5 6 7 8 Pin Signal j TD TD RD Not used Not used RD Not used oj y DA MY A w N Not used A amp L Note Usually a straight through connection is needed to connect Twisted Pair 10 BaseT to the hub In some situations a cable that crosses TD and RD may be needed for example when connecting together two network controllers Psion Teklogix 9500 Communications Server User Manual A 3 Appendix A Ports Pinouts And Cable Diagrams Serial Connector Pinout 9 pin A 2 Serial Connector Pinout 9 pin 5 l End view of female connector on cable Pin RS 232 Signal
235. tware will be Used By Actions You May Not Take Under this License You agree not to do any of the following a copy the Software or the Documentation in whole or in part except as otherwise permitted by this Agreement E 4 Psion Teklogix 9500 Communications Server User Manual Appendix E Software License Agreements For Psion Teklogix Software b sell license sub license assign or transfer the Software or Documentation c distribute the Software or the Documentation in whole or in part to any third party or provide processing services to third parties on a time sharing rental or any other basis d reverse assemble reverse compile disassemble or otherwise translate the Software in whole or in part e write or develop any derivative software based on the Software or any Proprietary Information or f export the Software or any party thereof from the country in which its Use is authorized unless you have our written consent and all required governmental export licenses and approvals 6 Disclaimer of Warranty We do not warrant uninterrupted or error free operation of the Software nor do we warrant that the Software will meet your requirements We do not assume any responsibility whatsoever for Third Party Software THE SOFTWARE AND DOCUMENTATION ARE PROVIDED AS IS WITHOUT ANY WARRANTY WHATSOEVER WE DISCLAIM ANY AND ALL REPRESENTATIONS WARRANTIES AND CONDITIONS WHETHER EXPRESS OR IMPLIED INCLUDING BUT NOT LI
236. ty labour disputes or strikes transportation delays shipping or manufacturing delays by third parties earthquakes storms wars government or state regulations or acts of God 8 Copyrights All title and copyrights in and to the Software and Documentation and any copies thereof are owned by Psion Teklogix Inc or its suppliers The Software and Documentation is protected by copyright laws and international treaty provisions The Software also contains copyright material licensed from our suppliers and all rights to such copyright material rest with such suppliers You may not remove the copyright notice s from any copy of the Software or Documentation WE DISCLAIM ALL WARRANTIES AND INDEMNITIES EXPRESS IMPLIED OR STATUTORY FOR PATENT OR COPYRIGHT INFRINGEMENT 9 Proprietary Rights and Confidentiality This Agreement does not grant you any right to use our name trade mark intellectual property or other rights without our consent We grant you a non transferable non exclusive license to use our intellectual property solely to operate the Software You agree not to use or disclose any Proprietary Information provided by us except for the purposes of this Agreement You agree not to reproduce any of the copyrighted materials unless expressly permitted by this Agreement 10 Ending this Agreement We may terminate this Agreement and your license to Use the Software without notice if i you are in material breach of any of t
237. ult lt unselected gt When this parameter is enabled the host can send extra data to the terminal s screens and instruct the terminal to print it This is in contrast to the Local Print feature where the terminal makes the initial print request The text that is passed to the printer is formatted into the 24 x 80 application screen If the host can initiate the print operation the text is printed The CommServer identifies the additional text as a print page by the presence of the word PRINT in capital letters beginning in the 2nd column of line 13 on the 24 x 80 screen The word PRINT should be defined as display only text The print page is positioned below the terminal s display page see the following figure The size of the print page is always the same as the terminal s display page assuming that in the terminal s configuration the page length is less than 12 lines When Host Print is enabled the CommServer passes the print page to the terminal after receiving the application screen from the host Display Page 8 x 40 WDINHNPWNEH 14 PRINT Print Page 8 x 40 Figure C 1 Application Screen With Print Page E Notes Psion Teklogix 9500 Communications Server User Manual C 37 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 2392 Emulation e Unlike with the Passthru option when using Host Pr
238. uration SNA Protocol Configuration System Configuration and Miscellaneous Commands These parts are described in the following sections C 14 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface The Configuration Main Menu Screen C 2 1 1 Controller Configuration From this part of the Configuration Main Menu the links from the CommServer to hosts and to Psion Teklogix bases can be configured There are four items in this section Hosts Base Stations RRM Groups and Radio Link Features Hosts 1 Don 5250 Configure The Hosts listbox allows the user to select a host connection Choices include host connections already configured for this CommServer and a special Create New choice Pressing the Configure button displays the configuration screen for the selected host connection If Create New is selected the user may choose a new host to add to the listbox the new host connection can then be configured in the same way as previously existing choices See Controller Configuration The Host Screens on page C 19 for details Base Stations E Base Station 1 gt Configure The Base Stations listbox allows the user to select a base station connection Choices include base station connections already configured for this CommServer and a special Create New choice Pressing the Configure button displays the configuration screen for the selected base station conn
239. ver s General Host Options screen for Host 2 Terminal Range 10 to 20 a range of 11 terminals or host emulations The lower number in the range host emulation 10 in this case is mapped to the first terminal on Host 2 and the higher number host emulation 20 in this case is mapped to the 11th terminal on Host 2 In our diagram we align the first terminal on Host 2 with host emulation 10 Host Emulations on CommServer 10 11 12 13 14 15 16 17 18 19 20 1 2 3 4 5 6 7 8 9 10 11 Host 2 A Range of Host 2 begins at host emulation 10 Terminal ID 1 Figure B 4 If for instance you assign the ID number of 13 to an RF terminal it would correspond to the 4th terminal on Host 2 In this example no RF terminals fall within the ranges of both Host 1 and Host 2 Thus no RF terminal can communicate with both hosts Psion Teklogix 9500 Communications Server User Manual B 7 Appendix B Setting Terminal Numbers On The CommServer Systems With Multiple Hosts E Note If one host is a TESS host and the other an ANSI host the terminal parameters will have to be set so that the ANST terminal number indeed falls within the range defined on the 9500 CommServer for the ANSI host and the TESS terminal number within the range defined on the CommServer for the TESS host refer to the appropriate terminal user manuals for information about how to set these parameters Two hosts with o
240. ver s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation Connecting Through HTTP PTX Host Application Emulation __ Software Web 3274 HTTP Browser Base Terminal PTX CommServer Host Computer Terminals connectig through HTTP make use of an HTTP server in the CommServer s emulation software The web browser on the terminal should be directed to the standard HTTP port port 80 on the CommServer Alarm Checkbox Alarm L Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected terminals will beep when the word ALARM in capital letters appears on the application screen in the location specified by the Command Region parameter see page C 62 The word ALARM should be a display only field E Note The Command Region parameter must be enabled for this parameter to work C 68 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation Clear Checkbox Clear Values lt selected gt lt unselected gt Default lt unselected gt If this checkbox is selected the CommServer creates an empty entry field for an entry field that is filled with spaces Some host applica
241. ver s Web Interface Controller Configuration The Host Screens The Emulation Options Screen HTML Emulation Screen Size Textboxes Screen Size X Values 1 x 1 40 x 132 Default 24 x 80 These textboxes contain the number of lines on the terminal screen and the number of characters in each line If you enter an invalid range an error message results Changes are not written to the database and you can enter a valid range Start Page Textbox Start Page Values lt any valid web address gt Default http This textbox contains the web address or URL of the HTML emulator s start page The CommServer retrieves this page parses it into TESS and sends the TESS datastream by default to each terminal If the CommServer cannot retrieve the start page it sends a simple page to the terminal containing a link to the start page The user can then request the start page later by following the link display size The scheme the http part must be provided with the start page s web address The TekHTML emulator expects it and does not provide it if it is not specified The terminal requests the start page when the user presses the Home function key see page C 130 for information on selecting the Home function key Character Width on the Terminal Textbox Character Width on the Terminal Values 1 10 Default 8 This textbox specifies the width in pixels of a single
242. verlap in terminal numbers A N Important YOU CANNOT OVERLAP AN ANSI HOST WITH EITHER ANOTHER ANSI HOST OR WITH A TESS HOST All examples with overlapping host terminal ranges assume both hosts to be TESS hosts Host Emulations on CommServer 12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 2 34 5 6 7 8 9 10 11 12 13 14 15 16 18 19 20 1 273 4 5 e 7 8 9 10 Yanni ERS Base Station 1 Terminal ID Numbers Terminal ID 1 Terminal ID 20 Figure B 5 In this system we will define the ranges In the General Host Options screen for Host 1 Terminal Range 1 to 20 a range of 20 terminals or host emulations Since this range starts at 1 the offset for this host is zero In the General Host Options screen for Host 2 Terminal Range 10 to 20 range of 11 terminals or host emulations The lower number in the range host emulation 10 in this case is mapped to the first terminal on Host 2 and the higher number host emulation 20 in this case is mapped to the 11th terminal on Host 2 B 8 Psion Teklogix 9500 Communications Server User Manual Appendix B Setting Terminal Numbers On The CommServer Setting The Terminal Range Base Stations In the Configure Existing Base Station screen for Base Station 1 First Terminal 1 no offset on the Base Station In this example RF terminals and host emulation
243. verse video and fill the field with spaces This is effective on terminals that support reverse video but on terminals that do not it can make the field invisible since it is made up entirely of spaces By default all empty entry fields displayed at the Psion Teklogix terminal are highlighted by the entry character chosen in the terminal s configuration not all Psion Teklogix terminals support video attributes The Clear feature creates an empty entry field in place of an entry field filled with spaces E Note This operation is only performed on screens received from the host Data sent to the host remains unaffected Passthru Checkbox Passthru Values lt selected gt lt unselected gt Default lt unselected gt C 52 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 3274 Emulation If this checkbox is selected the CommServer allows the host to send data directly to the RF terminal s serial port This is most commonly used for printing Preparing Host Screens for Pass Through On the screen to be sent through the terminal serial port the word PASSTHRU in capital letters has to appear on the first line starting on the second column The actual data to be sent to the terminal may start anywhere below the first line With 5250 or 3274 emulations attributes occupy a position in
244. when the operator enters data into a transmit upon entry field The value in this textbox specifies the line on the screen which is designated the transmit line The last entry field above or on the transmit line on the screen will be identified as the transmit upon entry field If any entry fields exist on lines below the transmit line no entry field will be designated as the transmit upon entry field A value of 0 zero disables this feature A value of 24 will cause the ast entry field on each application screen to be defined as transmit upon entry Psion Teklogix 9500 Communications Server User Manual C 73 Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation AIAG Textbox AIAG O Values 0 127 Default lt none gt This textbox contains the decimal value of the ASCII character code of the AIAG mode character as described below Whenever bar code data is entered at a terminal the terminal searches for AIAG fields on the current page that can accept the bar code data The data preloaded into the AIAG field by the application program determines whether the bar code data is accepted The format of the preloaded data is lt mode gt lt AIAG prefix gt The application program distinguishes an entry field as AIAG by preceding the field with a special mode character which denotes the existence of AIAG fields on the host screen This
245. wo adjacent fixed fields and then send them as one field This reduces the overhead on the radio link For example if two fields were 4 characters apart and this parameter was 5 then these fields would be joined into one This feature affects fields with the Normal display attribute only C 78 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 5250 Emulation Command Region Textboxes Command Region A Values row values 0 24 column values 0 80 Default lt none gt These two pairs of textboxes define a region of the host screen which the CommServer will examine for the presence of reserved commands The first textbox of each pair contains the row number the second contains the column number These four numbers represent the row and column addresses of the upper left corner and the lower right corner of the command region To define the last two lines of the host screen as the command region for example enter the values 23 7 and 24 80 Currently the only commands supported in the command region are ALARM and FONT e When the word ALARM is placed anywhere within the command region the CommServer will send a TESS beep command to the terminal e When the word FONT is placed anywhere within the command region and followed by a number the font code the CommServer will
246. xp n print Set Cookie UserPassword Warp Speed Sver Sage Spath n print Content Type text html n n n print lt html gt lt body gt n print Cookies have been set to expire in maxage seconds or on m exp n print lt a href printenv gt Test this cookie now lt a gt lt body gt lt html gt n Psion Teklogix 9500 Communications Server User Manual D 19 Appendix D Developing HTML For The CommServer Implementation Of Cookies This script can be called with query cookie age in seconds to alter the Max Age nnn parameter The Expires header is more complicated see page 21 and its generation is not shown When the browser is going to make another request to the same or a similar host it looks at available cookies and sends the appropriate cookies to the Web server Criterion of such filtering is fully described in RFC 2109 in brief Path and Domain attributes must match to the URL being requested The browser combines NAME VALUE pairs from applicable cookies if any are applicable and sends them to the Web server in a special Cookie header as illustrated below for two cookies GET cgi bin myRequest HTTP 1 0 Cookie UserName John Doe UserPassword Warp Speed The Web server receives the Cookie header and sets up an environment variable HTTP COOKIE HTTP COOKIE UserName John Doe UserPassword Warp Speed Now the CGI script uses this cookie Here is a t
247. xtbox allows the user to enter the decimal representation of the ASCH character code of this special character A value of 0 zero disables this feature Serial 1 0 Textbox Serial I O Cd Values 0 127 Default lt none gt Serial I O fields are special entry and fixed fields that accept input from and output to a serial port The application program distinguishes this field as Serial I O by preceding the field with a special character If this character precedes a fixed field the data will be sent to the terminal s serial port If it precedes an entry field the field accepts data from the terminal s serial port This textbox contains the decimal representation of the ASCII character code of this special character A value of 0 zero disables this feature Print Line Textbox Print Line Values 0 24 Default lt none gt This textbox allows the user to enter the starting line number of the print page in the application screen C 60 Psion Teklogix 9500 Communications Server User Manual Appendix C The 9500 CommServer s Web Interface Controller Configuration The Host Screens The Emulation Options Screen 3274 Emulation A value of 1 one causes the display page to be printed A value of 0 zero disables this feature Print Form Length Textbox Print Line Values 0 24 Default lt none gt This textbox allows the user to enter the printer s form length in lines Barcode Tex
248. y pressing the Refresh button or submitting the page e Web browsers receive a terminal ID from a pool There is no way to map a ter minal number to an IP or specific web browser session e By default the cursor mode is set to Insert and every time a new page is received the cursor mode is set to Insert If there is pre filled data in a field the Insert key must be pressed to overwrite it e The function keys on the PC or terminal do not function as application function keys The HTML function key buttons provided at the bottom of the host appli cation screen must be pressed to provide the proper function key operation C 1 3 The CommServer s Web Configuration Screens To connect to the web based configuration screens for the 9500 CommServer direct a browser to http lt IP Address gt 8008 where IP Address represents the CommServer s IP address and 8008 is TCP Port 8008 The CommServer s web interface uses a number of the standard web control elements such as text links buttons and listboxes In graphical browsers these elements are manipulated using the cursor and a pointing device such as a mouse text mode browsers may use different controls Consult your browser documentation for details The following pictures present several of the CommServer s web interface screens as displayed by Netscape 4 03 running on a Windows 95 system Each browser renders the parts of the screen in its own way other browsers or other

Download Pdf Manuals

image

Related Search

Related Contents

HeartSine® HeartSine®    Video Web Server - US Security Solutions  Mazda MX-5 Smart Start Guide  EMIKO®SAN Bio  SERVICE MANUAL MODEL WPP-531-X MODEL SSP-511- X  "取扱説明書"  Cisco 2811  - Permobil  Télécharger le PDF complet N°2 Année 2013  

Copyright © All rights reserved.
Failed to retrieve file