Home

TeemTalk for Unix User's Guide v 5.0

1. Keysyms KEY FUNCTION KEYSYM Uppercase O with tilde Otilde Uppercase O with diaeresis Odiaeresis x Multiplication sign multiply Uppercase O with oblique stroke Ooblique Uppercase U with grave accent Ugrave Uppercase U with acute accent Uacute Uppercase U with circumflex accent Ucircumflex U Uppercase U with diaeresis Udiaeresis Y Uppercase Y with acute accent Yacute b Uppercase Icelandic thorn Thorn B German small sharp s ssharp Lowercase a with grave accent agrave Lowercase a with acute accent aacute Lowercase a with circumflex accent acircumflex a Lowercase a with tilde atilde a Lowercase a with diaeresis adiaeresis a Lowercase a with ring above aring Lowercase diphthong ae ae Lowercase c with cedilla ccedilla Lowercase e with grave accent egrave Lowercase e with acute accent eacute Lowercase e with circumflex accent ecircumflex Lowercase e with diaeresis ediaeresis i Lowercase i with grave accent igrave i Lowercase i with acute accent iacute 1 Lowercase i with circumflex accent icircumflex Y Lowercase i with diaeresis idiaeresis Lowercase Icelandic eth eth f Lowercase n with tilde ntilde B 12 Keysyms Keysyms KEY FUNCTION KEYSYM Lowercase o with grave accent ograve Lowercase o with acute accent oacute Lowercase o with
2. Keysyms KEY FUNCTION KEYSYM Right square bracket bracketright Circumflex accent asciicircum Low line underscore Grave accent quoteleft a Lowercase a a b Lowercase b b c Lowercase c c d Lowercase d d e Lowercase e e f Lowercase f f g Lowercase g g h Lowercase h h i Lowercase i i j Lowercase j j k Lowercase k k 1 Lowercase 1 Lowercase m m n Lowercase n n Lowercase Lowercase 9 Lowercase q q r Lowercase r r s Lowercase s S t Lowercase t t u Lowercase u u Lowercase w Lowercase w w x Lowercase x x y Lowercase y y Keysyms Keysyms KEY FUNCTION KEYSYM 7 Lowercase 2 7 Left brace braceleft Vertical line bar Right brace braceright Tilde asciitilde No break space nobreakspace i Inverted exclamation mark exclamdown Cent sign cent Pound sign sterling a Currency sign currency Yen sign yen i Broken vertical bar brokenbar Paragraph sign section sign section Diaeresis diaeresis Copyright sign copyright A Feminine ordinal indicator ordfeminine Left angle quotation mark guillemotleft a Not sign notsign Short horizontal hyphen hyphen Registered trademark sign registered E Macron macron x Degree sign ring above degree Plus minus sign plusminus 2 Super
3. Keysyms KEY FUNCTION KEYSYM Number sign numbersign Dollar sign dollar Percent sign percent amp Ampersand ampersand Apostrophe qouteright Left parenthesis parenleft Right parenthesis parenright Asterisk asterisk t Plus sign plus Comma comma Hyphen minus sign minus Full stop period Solidus slash 0 Zero 0 1 One 1 2 Two 2 3 Three 3 4 Four 4 5 Five 5 6 Six 6 7 Seven 7 8 Eight 8 9 Nine 9 Colon colon Semicolon semicolon Less than sign less Equals sign equal gt Greater than sign greater Question mark question Keysyms Keysyms 2 cpl lt FUNCTION KEYSYM Commercial at ppercase A ppercase B ppercase C ppercase D ppercase E ppercase F ppercase G ppercase H ppercase I ppercase J ppercase K ppercase L ppercase N ppercase O ppercase P ppercase Q ppercase R ppercase S ppercase T ppercase U ppercase V ppercase W ppercase X ppercase Y U U U U U U U U U U U U Uppercase M U U U U U U U U U U U U U Nx RK Sl a AO SR eS a S Sal ee ppercase Z Left square bracket bracketleft 21 1 Sl lt le elal ols olz Slr Al Back slash backslash Keysyms
4. Legend RSP required space SHY syllable hyphen SP space D 5 Character Sets IBM 5250 GERMAN amp AUSTRIAN CHARACTER SET gt m rig mmo ou gt m A 2 zir x ece c NI lt x ciao OONO 9 AJOIN za e c Legend RSP required space SHY syllable hyphen SP space Character Sets IBM 5250 ITALIAN CHARACTER SET Legend RSP required space SHY syllable hyphen SP space D 7 Character Sets IBM 5250 SPANISH CHARACTER SET Legend RSP required space SHY syllable hyphen SP space D 8 Character Sets IBM 5250 SWEDISH amp FINNISH CHARACTER SET gt gt uU gt Q Ir 8 Oo 5 7 A cm lt x z lt o o m N o 2 3 4 5 6 7 8 9 N I A B C D E F Q Legend RSP required space SHY syllable hyphen SP space Character Sets IBM 5250 BELGIAN amp SWISS FRENCH GERMAN CHARACTER SET gt gt xx gt A Do
5. Keysyms Keysyms KEY FUNCTION KEYSYM 0 Keypad 0 KP_0 1 Keypad 1 KP_1 2 Keypad 2 KP_2 3 Keypad 3 KP_3 4 Keypad 4 KP_4 5 Keypad 5 KP 5 6 Keypad 6 KP 6 7 Keypad 7 KP 7 8 Keypad 8 KP 8 9 Keypad 9 KP 9 F1 Function key 1 F1 F2 Function key 2 F2 Function key 3 F4 Function key 4 F4 FS Function key 5 FS F6 Function key 6 F6 F7 Function key 7 F7 F8 Function key 8 F8 F9 Function key 9 F9 F10 Function key 10 F10 F11 Function key 11 F11 F12 Function key 12 F12 F13 Function key 13 F13 F14 Function key 14 F14 F15 Function key 15 F15 F16 Function key 16 F16 F17 Function key 17 F17 F18 Function key 18 F18 F19 Function key 19 F19 Keysyms Keysyms KEY FUNCTION KEYSYM F20 Function key 20 F20 F21 Function key 21 F21 F22 Function key 22 F22 F23 Function key 23 F23 F24 Function key 24 F24 F25 Function key 25 F25 F26 Function key 26 F26 F27 Function key 27 F27 F28 Function key 28 F28 F29 Function key 29 F29 F30 Function key 30 F30 F31 Function key 31 F31 F32 Function key 32 F32 F33 Function key 33 F33 F34 Function key 34 F34 F35 Function key 35 F35 Left function key 1 F11 equivalent L1 Left function key 2 F12 equivalent L2 Left function key 3 F13 equivalent L3 Left function key 4 F14 equivalent L4 Left f
6. IBM 5250 Emulation Notes 7 8 Resources amp Command Line Options Resources amp Command Line Options This chapter describes how to use resources and command line options to specify how TeemTalk is run and displayed by the X Window System Introduction Resources are used to specify how TeemTalk is run and displayed by the X Window System The resource configurations are stored in user preference files which are asserted when TeemTalk is loaded This means for example that you do not have to specify how the TeemTalk window is to be displayed each time it is loaded There are so many options which you could specify that including them on the command line for loading TeemTalk would be impractical Once the normal resource specification for TeemTalk has been defined in a user preference file the resource specifications for a particular instance of TeemTalk may be overridden using command line options Note The default settings of functions relating to terminal emulation are specified via pop up menus in the TeemTalk window These are described in the Setup Menus chapter The following sections provide a brief introduction to using resources and command line options For a more detailed discussion and information on resource debugging refer to the section at the end of this chapter entitled Understanding X Resources Resources amp Command Line Options Resource Format There are a number of
7. Font Selection Resource foreground colour background colour cursorIndex index Command Line fg colour bg colour ci index Command Function Default font index on startup Load all fonts on startup Load fonts only as required Resource defaultFontindex preloadFont on preloadFont off Command Line df fnpreload fnpreload Resources amp Command Line Options General Operation amp Setup Server For TeemTalk Display amp Input Resource xteemx320 display host server screen Command Line display host server screen Default Setting Determined by the DISPLAY environment variable These commands specify which X server is to be used to display data and take input when TeemTalk is being run on a remote system The host argument specifies the machine which will display the TeemTalk window This is immediately followed by a colon then the server number then the screen number preceded by a period The host and screen arguments may be omitted in which case host will be the local machine and screen will be 0 by default The server option must always be preceded by a colon Command line example xteemx320 d your node 0 1 This will select your node server 0 and screen 1 for TeemTalk display and input Synchronization Signal Frequency Resource xteemx320 pollTime seconds Command Line poll seconds Default Setting 5 These commands determine how often TeemTalk sends a synchr
8. The Cursor Select function does the same as Move Cursor but also performs a cursor select For more information on these special functions refer to the Mouse Functions chapter You can also enter a definition of your own in the text box associated with each button and key combination Definitions are entered in the same way as for keyboard macros and soft buttons The setting of the Highlight When Actioned option determines whether or not a visual indication is given that a function has been actioned when a hotspot is clicked 6 24 Setup Menus Help Menu Help p fibout TeemTalk Clicking the About TeemTalk button in the Help menu will display information on this version of TeemTalk 6 25 Setup Menus Notes 6 26 IBM 5250 Emulation IBM 5250 Emulation This chapter describes features of the IBM 5250 terminal emulation Introduction The IBM 5250 emulator provides emulation of 5250 type alphanumeric terminals both monochrome green white plus attributes and colour Colours may be modified using the Attribute Settings dialog box This emulation can be used for connection to an IBM AS 400 System 36 or System 38 A typeahead capability is provided so that you can continue to enter data without waiting for a prompt from the host All communication to the IBM mainframe is achieved over the TCP IP Telnet interface using the inbuilt telnet interface provided with TeemTalk Running The Emu
9. uuu A 1 Introduction ke ein 1 Standard Virtual Key Names esses enne 1 IBM 5250 Virtual Key Names 2 A 2 TeemTalk Virtual Key Name Functions sese A 3 Sending Text A File eee eet hte A 3 Sending Text To The Serial Port 00 ee ee ceeeeeceeeeeeeeeeeeeeees A 3 Reading Text From A File sees A 4 Insert Delay ar Dein Ess A 4 KOVSVINS eint etatis B 1 Virtual KeySyrhs edere 1 Keysyms COP UNCTIONS o sea Barren 2 Key Reference Numbers C 1 Character Sets D 1 Product Specification E 1 Contents 3 Contents Notes Contents 4 Introduction Introduction This chapter introduces the TeemTalk for Unix terminal emulation software and describes the scope of this User s Guide TeemTalk amp The X Window System TeemTalk for Unix is the essential connectivity tool for enabling non X based applications to be run in the X environment TeemTalk provides precise emulation of a wide range of industry standard terminals with impressive additional features formu lated to increase productivity and reduce network loading These include dynamic window sizing hotspots soft buttons keyboard mapping mouse button definition and customising capabilities TeemTalk for Unix integrates seamlessly into the X Window sy
10. OKIS9IIBM OKI400 OKI800 OKI810 OKI820 OKI3410 PANII23EP PANII24EP PANII24IEP PANIISOEP PANIISOIEP PANI191EP PAN1624EP PANI654EP PANI695EP PAN2123EP PAN2124EP PAN2180EP PAN2624EP 410 PAN4420HP PAN4430HP PAN4450IHP PAN4451HP MSGQ Name Specifies the name of the message queue to which operational messages for the printer are to be sent MSGQ Library Specifies the message queue library Font Specifies the font identifier and point size used by the single byte printer e g 11 Setup Menus Formfeed This is always set to Don t Report The Paper Source 1 option is used to specify the paper format to be used Paper Source 1 amp 2 These options specify the paper format to be used The possible settings are Don t Report NONE MFR LET LEGL EXEC 4 5 5 C80 C132 A3 B4 LEDG Envelope Hopper No value returned No paper source is defined The system determines the paper type used based on the manufacturer type and model of the printer Letter sized paper 8 5 x 11 inches Legal sized paper 8 5 x 14 inches Executive sized paper 7 25 x 10 5 inches A4 sized paper 210 mm x 297 mm A5 sized paper 148 mm x 210 mm B5 sized paper 182 mm x 257 mm Continuous form paper 8 0 inches wide Paper Source 1 only Continuous form paper 13 2 inches wide Paper Source 1 only A3 sized paper 297 mm x 420 mm B4 sized paper 257 mm x
11. appendix provides a complete list of virtual key names and their associated functions Clicking a key name in this list box will cause it to appear on the key definition line The function associated with the key name will be attributed to the key being defined 3 4 Keyboard Configuration Note An escape sequence will be sent across a network as a single packet The Key Expansion Character is a special toggle character that can be inserted into key macro strings to cause subsequent characters to be redirected from the host to the terminal and vice versa By default all characters in the macro are directed to the host When a key expansion character is detected for the first time characters will be redirected to the terminal until the character is detected a second time in the current or another string The key execute character is specified as the control key character equivalent For example the default value P represents the keys Ctrl P which would generate the ASCII control character DLE when pressed When the definition is complete decide if you wish the key contents to be saved so that it will be asserted each time TeemTalk is reset or loaded then click the Program Volatile or Program NonVolatile button Clicking the Program Volatile button will cause TeemTalk to only remember the definition until it is reset or exited Clicking the Program NonVolatile button will enable the definition to be saved when you select the Save S
12. if the X server supports this The loudness is indicated by a numeric value in the range 0 off to 100 full volume IBM Reply Mode Resource xteemx320 ibmReplymode on off Command Line ibmreply on ibmreply off Default Setting Off When you switch from one application to another the current contents of the screen is saved before the new application is displayed Enabling IBM reply mode will prevent the colour information from being sent in a reply to the IBM host forcing the reply mode to be always set to Field mode not Extended Field or Character mode Resources amp Command Line Options Send String To Host On Exit Resource xteemx320 exitString string Command Line es string Default Setting Not applicable These commands enable you to specify a string which will automatically be sent to the host when the TeemTalk window is closed Resources amp Command Line Options Telnet Session Telnet Dialog Not Displayed On Startup Resource xteemx320 tnStartup off Command Line tnstartup prevents dialog display tnstartup enables dialog display Default Setting Telnet dialog displayed These commands will prevent the Open Telnet dialog box being displayed on startup Initiate Telnet Session With Host Resource xteemx320 tnHost hostname Command Line tnhost hostname Default Setting Not applicable These commands enable you to cause TeemTalk to initiate a telnet session with the
13. Cancel This dialog box is displayed by selecting Attributes in the Settings menu This enables you to specify the colours used in the window and how text with attributes is displayed To change the way a screen element is displayed select the relevant item from the Screen Element list box for example Bold for characters with the bold attribute The settings of the other options in the dialog box will change to reflect the settings currently assigned to the screen element Text with attributes can be displayed in various ways For example characters with the underline attribute can be displayed as standard e g underlined only as a particular colour only e g green without the underline or with both attribute and a specific colour e g underlined and green The With Attribute options allow you to enable or disable any of the attributes normally associated with the currently selected screen element The setting of the Displayed As option determines whether or not a specific colour is assigned to the text attribute The colour of the screen element can be changed by setting the Displayed As option to Colour and clicking on the required colour block in the palette of Foreground and or Background colours The two palettes enable you to specify a different colour for text foreground and text cell background and dashed and or dotted graphics line styles foreground and the gaps between the dashes or dots backgro
14. Function Of A nen 3 2 Programming Keys han 3 4 Entering Control Characters uesunseensenseesnensennnenseennennnenseenennn 3 5 Mouse FUNCTIONS 4 1 Introd ctlOn aee ticket tpe seh Pa deena ERE e RI adie 4 1 Selecting amp Copying Text esce 4 Graphic Copy amp Paste esses ener nennen 4 2 Moving The Cursor In Block Mode seen 4 2 Show amp Action Hotspots esses eene 4 2 Contents 1 Contents Send Keyword iei ii e o I i 4 3 Redefining The Mouse Buttons esses 4 3 HotSpots ii cot Enni Del USINE FIOTSPOUS 5 1 Defining Hotspots eioi na aE 5 2 Setup Menus 0 1 Selecting amp Closing Menus sess 6 1 Using Ihe Men s isti siete Eee P ee eee S sheaves coe 6 1 Dialog Boxes nn RAS Hee Des 6 2 Default Settihgs ne sn ernennen ai e repe enn 6 3 Saving The Setups uns 6 3 Menu Descriptions 6 3 c drerit UR Ri E WERE sen 6 4 Telnet Options ee ameet e EE Me ees iren 6 7 23250 OptlOns u een cem Pigs 6 8 23250 Printer Options detto ees 6 10 Settings Menu iuo rare 6 14 Emulation Setings petere Het e ee e Hen 6 15 IBM 5250 Settings seen peccet
15. Key Names This appendix lists all the virtual key names supported by TeemTalk Introduction Virtual key names enable you to include a specific key function in a user definition for key macros soft buttons hotspots etc The following sections list the virtual key names applicable to each terminal emulation mode Standard Virtual Key Names Key Function Alt Backspace Break Control Cursor Down Cursor Left Cursor Right Cursor Up Del Key Delete End Escape Fl F12 Find Home Insert Keypad 0 9 Virtual Key Name VK_ALT VK_BACK VK_BREAK VK_CONTROL VK_DOWN VK_LEFT VK_RIGHT VK_UP VK_DELKEY VK_DELETE VK_END VK_ESCAPE VK_FI VK_F12 VK_FIND VK_HOME VK INSERT VK NUMPADO0 9 Key Function Keypad Add Keypad Divide Keypad Decimal Keypad Multiply Keypad Subtract Line Feed Num Lock Page Down Page Up Pause Print Screen Remove Return Scroll Lock Separator Shift Tab Virtual Key Name VK ADD VK DIVIDE VK DECIMAL VK MULTIPLY VK SUBTRACT VK LINEFEED VK NUMLOCK VK NEXT VK PRIOR VK PAUSE VK SNAPSHOT VK REMOVE VK RETURN VK OEM SCROLL VK SEPARATOR VK SHIFT VK TAB A 1 Virtual Key Names IBM 5250 Virtual Key Names Key Function Attention Back Tab Backspace Clear Cursor Down Cursor Left Cursor Right Cursor Fast Left Cursor Fast Right Cursor Select Cursor Up Delete Character Duplicate Enter Erase End Of Field
16. Shows the supported character set code tables Introduction Appendix E Product Specification Describes the level of support provided by each terminal emulation Terms amp Conventions This User s Guide uses the following terms and conventions 1 When referring to mouse buttons it will be assumed that the Left button is configured as button 1 the Middle button is configured as button 2 and the Right button is configured as button 3 Click means quickly press then release the specified mouse button Double click means quickly press then release the specified mouse button twice in quick succession Drag the pointer means hold down the left mouse button or button assigned with the select function and slide the mouse so that a selection box is displayed When references to keys are shown linked by a plus sign this means that two or more keys have to be pressed at the same time For example press Ctrl M means press and hold down the Ctrl key press the M key then release both keys Introduction Notes 1 4 Getting Started Getting Started This chapter describes how to configure TeemTalk for compatibility with your hardware and the application Initiating A Telnet Session TeemTalk has its own inbuilt telnet driver so that precise control can be exercised over the information that TeemTalk receives and transmits A telnet session can be initiated from a dialog
17. Telnet Options Host Port Number 2 Telnet Name mesure Suppress Force Negotiation 1 Echo Binary rm 4 5250E 5250 Options EOR A connection on startup Break Settings with Break CR with Break OK Cancel E This dialog box is displayed when you click the Options button in the Open Connec tion dialog box Host Port Number This enables you to specify the Telnet port number The default Telnet port number 23 can be substituted with any valid 16 bit port number Specifying a number outside the valid range will cause the setting to default to 1 Telnet Name This enables you to override the name that will be reported for the terminal type over Telnet Suppress Echo When selected this will will prevent the emulator from generating the Telnet echo option on connection Suppress TN5250E The setting of this option determines whether or not support of TN5250E is sup pressed When this option is not selected 1 e TN5250E is not suppressed additional options are available by clicking the 5250 Options button These are described in the 5250 Options section Force Negotiation These settings determine whether or not the Telnet Binary or EOR options are sup ported Both are set to no by default Setup Menus No Will not force any negotiations It will leave it up to the host to decide what to do DO Will force negotiation The host wi
18. The Title Bar The title bar displays the name of your version of TeemTalk software by default You may change the title displayed by using the title resource or title command line option followed by a space then the title to be assigned This is useful for identifying each window when more than one instance of TeemTalk is being run Refer to the Resources amp Command Line Options chapter for more details The Menu Bar The menu bar provides access to a series of commands and dialog boxes which enable you to perform various functions and configure TeemTalk for compatibility with your hardware and the application Three menus may be displayed from the menu bar To display a menu click on its title File Settings 1 Factory Default Language About TeenTalk Reset Terminal Emulation IBM 5250 Keyboard Macros Attributes Mouse Button Action Save Settings Startup Options Open Connection Printer Setup Print Screen Quit Getting Started To select an option in the menu just click the pointer over it To close the menu without selecting an option move the pointer outside the menu and click the left mouse button All the options listed in the menus are described in the Setup Menus chapter Window Resize Commands The menu bar includes two commands labelled lt and gt which enable the window size to be decreased or increased respectively When the lt command is click
19. an excla mation mark Command Line Option Format The command line for loading TeemTalk can be extended by options that control its display and operation overriding resource file default settings Options and associated values must be separated from the TeemTalk loading name and each other by a space The following command line example will load TeemTalk 320 set the window border colour to red and border width to 60 pixels xteemx320 bd red bw 60 Arguments that include white space space tab etc must be quoted Resources amp Command Line Options Command Summary General Operation amp Setup Command Function X server for display amp input Sync signal to X server freq Resource information file Resource in command line Setup settings file Terminal setting keywords etc Debug mode Input queue size Prevent message display Cut amp paste EOL character Mouse button multi click time 3 clicks selects line from cursor 3 clicks selects all cursor line Bell volume not all servers IBM reply field mode only String sent to host on exit Telnet Session Resource display host server screen pollTime seconds none none settingsFile filename ttyModes keyword key debugMode on off inputQueue 0 4096 quiet on off lineDelimiter char multiClickTime ms cutToBeginningOfL ine off cutToBeginningOfLine on bellVolume 0 100 ibmReplymode on off exitString string Comm
20. available in all the menus and associated dialog boxes The descriptions begin by showing the menu or dialog box as it is displayed on the screen The factory default setting is shown below each option title where applicable Setup Menus File Menu File Factory Default Reset Terminal Save Settings Startup Options Open Connection Printer Setup Print Screen Quit Factory Default This will cause TeemTalk to reassert all the original settings that it had when you first installed it Reset Terminal This will reset the current terminal emulation mode Save Settings This will save the current setup configuration so that it is reasserted when TeemTalk is subsequently reset or loaded overriding any changes which have been made but not saved Startup Options This displays a dialog box which enables you to specify how the TeemTalk window is displayed on startup Startup Options Startup Options I Maximised Window F Menubar F Scrollbar 2 Softbuttons Visible Cancel E 6 4 Setup Menus Selecting Maximised Window will cause the TeemTalk window to fill the screen when it is started The other options toggle visibility of the menu bar scroll bar and soft buttons on or off Open Connection This will display a dialog box which enables you to make a connection to a remote host TeemTalk Telnet Hosts Telnet Hosts localhost
21. box while TeemTalk is running or by using resources or command line options Note that TeemTalk must be configured so that it is running the required terminal emulation before initiating a telnet session The TeemTalk window will be in Network Virtual Terminal mode until a successful host connection is made 1 Display the IBM 5250 Settings dialog box from the Settings menu and select the particular terminal Model then click OK TeemTalk IBM 5250 Settings Model Ruler Line Style P Follows Cursor l Ignore host cursor style Include Euro Character Field Minus Justification Cancel Getting Started The Model option specifies what is reported back to the host in response to a terminal identification request Note that not all features of the specified terminal may be supported It also allows you to specify whether the display is treated as monochrome green for normal characters white for intense attribute or colour for attributes The terminal types currently supported and their display characteristics are listed below Type 5291 1 5292 2 5251 11 3179 2 3196 A1 3180 2 3477 FC 3477 FG 3486 BA 3487 HA 3487 HC The printer types supported are listed below 3812 1 Display Rows x Columns Monochrome 24 x 80 Colour 24 x 80 Monochrome 24 x 80 Colour 24 x 80 default Monochrome 24 x 80 Monochrome 24 x 80 and 27 x 132 Colou
22. circumflex accent ocircumflex 6 Lowercase o with tilde otilde 6 Lowercase o with diaeresis odiaeresis Division sign division Lowercase o with oblique stroke oslash Lowercase u with grave accent ugrave Lowercase u with acute accent uacute Lowercase u with circumflex accent ucircumflex Lowercase u with diaeresis udiaeresis Lowercase y with acute accent yacute p Lowercase Icelandic thorn thorn y Lowercase y with diaeresis ydiaeresis B 13 Keysyms Notes B 14 Key Reference Numbers Key Reference Numbers This appendix lists the reference numbers assigned to keys on the British keyboard National 8 bit Key Reference Numbers KEY NORMAL SHIFT KEY NORMAL SHIFT 163 n a i 244 212 223 n a I 245 213 A 224 192 N 238 206 A 225 193 239 207 226 194 241 209 A 227 195 242 210 228 196 0 243 211 A 229 197 246 214 230 198 247 215 231 199 248 216 E 232 200 U 249 217 E 233 201 250 218 E 234 202 251 219 E 235 203 252 220 I 236 204 Y 253 221 237 205 Key Reference Numbers British Keyboard Key Reference Numbers KEY NORMAL SHIFT CTRL CT SH COMPOSE 166 166 166 166 DELETE 127 34 35 36 DO 232 234 236 238 ENTER 68 82 96 110 ESCAPE 27 37 38 39 FIND 255 261 267 273 HELP 231 233 235 237 INSERT HERE 256 262 268 274 NEXT 260 266 272 278 PREVIOUS 259 265
23. command group headed Separators specifies the displayed characters which delimit the hotspot keyword Delimiters include SPACE and NULL as well as the characters shown in the example by default The end delimiter does not need to be the same as the first Delimiters are necessary to prevent hotspots occuring within words that happen to contain the same formation of characters as the keywords The following command groups specify the keywords used in each terminal emula tion mode Keyword definitions that can apply to all modes are specified under the heading Definitions Keyword definitions that apply to a specific mode are specified under the heading Definitions lt emulation gt where lt emulation gt must be the name of the terminal emulation mode as already specified in the default hotspot definitions file Note that a keyword definition under a Definitions lt emulation gt heading will override the definition given to the same keyword in any other defini tions group when that particular emulation is running Each keyword definition line consists of the keyword immediately followed by an equals sign then the function that it will perform The keyword can consist of any characters except those specified as delimiters in the Separators line TeemTalk will search for the keyword on a case insensitive basis The function that will be performed when the keyword is selected is specified in the same way as for key macros soft button
24. elements of an application the resource preference string should be considered to be a heirarchy of objects and sub objects of the form object subobject attribute value where each object and sub object corresponds to various major components of an application There is no limit on the number of object name or sub objects that may be specified For example the following allows different components of the TeemTalk window to have different colours xteemx320 vt220 background black xteemx320 scrollbar background red Note The vt220 background can be specified as the single resource vtBackground The object names are hard coded into the application and therefore fixed With the level of application configurability offered by this technique careless use of re sources can seriously affect the operation of the application For this reason only a subset of all the object names and attributes are made available by the manufacturer to the end user 8 18 Resources amp Command Line Options Object Names Available In TeemTalk The following object names are available in TeemTalk vt220 scrollbar menubar File Settings lt gt TelnetControl TelnetOptionsControl TelnetOpt5250Control TextPrinterControl PrintScreenControl ModeControl IBM5250Control MacrosControl AttributeControl MouseControl the main emulation window the scrollbar on the right hand side of the window the menubar at the top of the windo
25. files in which resources are specified Generally they are specified in the user s Xdefaults file or the system wide application defaults file The Xdefaults file resides in the user s home directory and resources specified in it only affect invocations of TeemTalk made by the owning user Note Changes made to the Xdefaults file will not take effect until the X server has been restarted or the database freshened by the program xrdb The applications resource file contains resources specified in exactly the same way as those in the Xdefaults file except that they affect all users The environment variable XAPPLRESDIR will normally be set to point to the app defaults directory The name of the file to create in the app defaults directory is xteemx320 which should be placed in the directory specified by XAPPLRESDIR Each line in the resource file consists of the name of the client e g xteemx320 followed by an asterisk then the name of the resource e g maXimized The resource name is separated from its definition or value by a colon and whitespace Example xteemx320 maXimized on xteemx320 buttonLevels 3 Resources are case sensitive on UNIX based systems so pay particular attention to the upper or lowercase form of characters in the resources described in this chapter A backslash V at the end of a line enables the current resource definition to continue on the next line Comment lines can be inserted by starting each line with
26. from the menu bar by clicking on the relevant buttons A menu is closed by moving the pointer away from the menu then clicking the left mouse button File Factory Default Reset Terminal Save Settings Startup ptions Open Connection Printer Setup Print Screen Quit Settings Help Language r About TeenTalk Emulation IBM 5250 Keyboard Macros Attributes Mouse Button Action Using The Menus Option Selection There are several ways of selecting or actioning the various options displayed in the menus The quickest way is to click the option required Another way is to place the pointer over the button on the first option hold down the left mouse button then move the Setup Menus pointer up or down the menu until the button rests over the option required then release the left mouse button Options that are displayed dimmed are not applicable to the current mode of operation and cannot be selected An example of this is the Close Connection option in the File menu This can only be selected after a host connectionhas been made Options that are not followed by an ellipsis perform a particular function when selected For example selecting Factory Default in the File menu will cause TeemTalk to assert the factory default settings Options that are followed by an ellipsis indicate that a dialog box will be displayed with all the selections applicable to that opt
27. locis loc gov tnserver di3270 com Hostname OK Cancel Options Most emulations work quite well in the standard TeemTalk environment when the telnet process provided with the workstation is used to make the connection to the remote host However in some block mode emulations the telnet process does not pass all the necessary information to TeemTalk To overcome this TeemTalk has its own inbuilt telnet driver so that precise control can be exercised over the information that TeemTalk receives and transmits You must use the telnet facility provided by TeemTalk when using block mode emulations Note that TeemTalk must be configured so that it is running the required terminal emulation before initiating a telnet session A list of hosts currently available for connection will be displayed in the Telnet Hosts Available list box To make a connection either click on the name in the list box or type it in the Hostname text box then click OK Clicking the Options button will display another dialog box with additional telnet options These are described in the next section Note that you can use resources or command line options to initiate a telnet session specify the telnet port number and force TeemTalk to exit when the connection closes Refer to the Resources amp Command Line Options chapter for details Close Connection This will close the current telnet connection 6 5 Setup Menus Printer Setup This
28. report Bytes 0 thru 5 which are 0x7f 0x11 0x4e 0x00 0x03 0x80 for Display Sessions IBM 3151 Native Emulation Model 11 amp 31 Specification IBM 3151 Ascii Display Station Reference Manual GA18 2634 01 1989 ICL 7561 Specification ICL DRS300 manual R15722 001 Appendix 1 September 1986 Limitations Some field validation checks are not supported Load templates are not supported Host print protocol is not supported Product Specification Stratus V102 Specification V102 Display Terminal Operator s Manual TVI 131974 00 June 1985 Limitations Page print flip mode not supported Serial configuration commands not supported Select character set commands not supported Tandem 6526 6530 Emulation Specification Tandem 653x Multi Page Terminal Programmer s Guide 82310 B00 December 1983 Limitations Telnet Line Mode is not supported Ansi media copy commands are not supported No support for auxiliary port No support for extended buffer and cursor commands String configuration machine and directory commands not supported Data table re definition commands not supported Remote termination not supported I O device and file commands not supported Set colour configuration commands not supported Product Specification Televideo 955 Specification Televideo 955 Display Terminal Operator s Manual 131969 00 B Sept 1985 Limitations Page print flip mode not sup
29. that can be assigned Mouse Functions Unassigned Select Extend Selection Edit Paste Show Hotspots Action Hotspots Move Cursor Send CR Send Keyword Select Graphics Paste Graphics Select Rectangle Cursor Select You can also enter a definition of your own in the text box associated with each button and key combination Definitions are entered in the same way as for keyboard macros and soft buttons as described in the Setup Menus chapter The setting of the Highlight When Actioned option determines whether or not a visual indication is given that a function has been actioned when a hotspot is clicked 4 4 Hotspots Hotspots This chapter describes the hotspot facility which enables functions to be performed by clicking on keywords displayed on the screen Using Hotspots TeemTalk incorporates a user definable hotspot facility which enables you to invoke a function by clicking the mouse pointer over a keyword displayed on the screen For example an application may display information relating to keys you can press to perform a particular function Instead of pressing the key on the keyboard you could invoke the function by moving the mouse pointer over the displayed key name holding down the Control key and clicking the Middle mouse button Hotspots are supported in ALL terminal emulation modes TeemTalk provides a set of default keywords for each mode These keywords relate to key functions specif
30. the target Fn key that has erasable data then enter the new data b Press the Record key and the target Fn key that has erasable data then press the Delete key to erase the recorded data for that key IBM 5250 Emulation 9003 You pressed an invalid Fn key while performing the Record or Play function Remedy Press the Reset key 9007 You pressed an invalid sequence key e g Play while performing the Record function Remedy Press the Reset key 9010 While performing the Play function you pressed an Fn key that does not have a keystroke assigned to it Remedy Press the Reset key 9015 In communication mode you pressed either the Quit or Pause key Remedy Press the Reset key 9019 In Record or Play mode While the Record play pause indicator was displayed on the status line you pressed an invalid key e g Play key in Record mode or Record key in Play mode Remedy Press the Reset key Fax Image Support Fax images in Tiff PCX and G3 format are supported The following display facilities are supported if the host provides them Scrollbars These are displayed if the image is larger than the screen area allocated to it EasyScroll IBM term for scrolling by dragging the image with the mouse Zoom Enables you to highlight an area of the image to magnify it so that it fills the allocated space the aspect ratio is preserved Additional functions such as rotation and colouring are controlled by the host
31. therefore report the keysym as normal The following list provides a cross reference from actual keysym to the virtual keysym which should be used in the translation table Actual Keysym Escape Left Up Right Down End Home Prior Next BackSpace Delete Virtual Keysym osfCancel osfLeft osfUp osfRight osfDown osfEndLine osfBeginLine osfPageUp osfPageDown osfBackSpace osfDelete Actual Keysym Insert ShiftF8 Fl F4 F7 F10 Select KP Enter Clear Undo Virtual Keysym osfInsert osfAddMode osfHelp osfMenu osfEndLine osfMenuBar osfSelect osfActivate osfClear osfUndo Keysyms Keysyms amp Functions This section lists all the actual keysyms and their functions The first column in the following tables provides an example of a legend which may be printed on the cap of a key which relates to the function performed or character displayed as described in the second column Note The legend on a keycap may not necessarily indicate the actual function of that key hence the need to be able to remap the keyboard as required The second column describes a function which may be attributed to a key and the third column shows the keysym for that function Keysyms KEY FUNCTION KEYSYM Back Space Back space back character BackSpace Tab Tab Tab Line Feed Line Feed LF Linefeed Clear Clear Clear Return Return enter Return Paus
32. transform function to generate ASCII printer data This is always set to Yes The Mfg Model option must specify the printer manufacturer type and model 6 10 Setup Menus Mfg Type and Model Specifies the manufacturer type and model of the printer The entry must exactly match an AS400 printer type string including the asterisk character The following valid entries are for the IBM AS 400 V3R1 Note that the list can change according to AS 400 settings BM2380 BM2381 BM2390 BM2391 BM3812 BM3816 BM3912HP IBM3916HP IBM39302 BM39303 BMA019 IBM4019HP IBM4029 TBM4029HP IBM4037 BMA039HP IBM4070 IBM4070EP IBM4072 IBM4076 IBM42011 IBM42012 IBM42013 IBM42021 IBM42022 IBM42023 IBM42071 IBM42072 IBM42081 IBM42082 IBM4212 IBM4216 IBM4226 IBM4230 IBM4232 IBM47121 IBM47122 IBM47221 IBM47222 IBM4770 IBM5152 IBM5201 IBM5202 IBM5204 IBM5216 BM6404 BM6404EP IBM6408 BM6408EP IBM6412 BM6412bEP HPII HPIID HPIIP HPIII HPIIID HPIIIP HPIIISI HP4 HP310 HP500 HP520 HP550C HP560C HPPAINT CPQPM15 CPQPM20 EPAP2250 EPAP3250 EPAP5000 EPAP5500 EPDFX5000 EPDFX8000 EPFX850 EPFX870 EPFX1170 EPLX810 EPLQS10 EPLQ570 EPLQ860 EPLQ870 EPLQ1070 EPLQ1170 EPLQ2550 EPSQ870 EPSQ1170 EPEPL7000 EPEPL8000 NECP2 NECP2200 NECP2200XE NECP5200 NECP5300 NECP6200 NECP6300 OKI184IBM OKI320IBM OKI321IBM OKI390IBM OKI391IBM OKI393IBM OKIS90IBM
33. 2 Chapter 3 Chapter 4 Chapter 5 Chapter 6 Chapter 7 Chapter 8 Appendix A Appendix B Appendix C Appendix D Introduction Introduces TeemTalk and describes various conventions used Getting Started Describes how to use TeemTalk and configure it for compatibility with your hardware and the application Keyboard Configuration Describes how to configure the keyboard remap key functions and compose special characters Mouse Functions Describes the special functions assigned to the mouse buttons by TeemTalk and how to redefine the buttons Hotspots Describes the hotspot facility which enables functions to be performed by clicking on keywords displayed on the screen Setup Menus Describes all the commands and setup dialog boxes that can be accessed via pop up menus in the menu bar IBM 5250 Emulation Describes features of the IBM 5250 emulation Resources amp Command Line Options Describes how to use resources and command line options to specify the loading configuration of TeemTalk Virtual Key Names Lists all the virtual key names that enable you to include a specific key function in a user definition for key macros soft buttons hotspots etc Keysyms Describes the use of virtual keysyms and lists all the valid keysyms that may be used to define the function of keys Key Reference Numbers Lists the reference numbers assigned to keys on the British keyboard Character Sets
34. 271 277 REMOVE 257 263 269 275 RETURN 13 49 50 51 SELECT 258 264 270 276 SPACE 32 52 53 54 TAB 9 46 47 48 PF1 239 243 247 251 PF2 240 244 248 252 PF3 241 245 249 253 PF4 242 246 250 254 Keypad 0 55 69 83 97 Keypad 1 56 70 84 98 Keypad 2 57 71 85 99 Keypad 3 58 72 86 100 Keypad 4 59 73 87 101 Keypad 5 60 74 88 102 Keypad 6 61 75 89 103 Keypad 7 62 76 90 104 Keypad 8 63 77 91 105 Keypad 9 64 78 92 106 Keypad 65 79 93 107 Keypad 43 43 43 43 Keypad 66 80 94 108 Keypad 67 81 95 109 Key Reference Numbers British Keyboard Key Reference Numbers KEY NORMAL SHIFT CTRL CT SH gt 135 139 143 147 T 136 140 144 148 lt 137 141 145 149 138 142 146 150 F6 128 136 29 10 F7 129 137 3 11 F8 130 138 4 12 F9 131 139 5 13 F10 132 140 6 14 F11 133 141 27 15 12 134 142 8 16 F13 135 143 9 17 F14 144 151 18 25 F17 145 152 19 26 F18 146 153 20 27 F19 147 154 21 28 F20 148 155 22 29 0 48 41 n a n a 1 49 33 n a n a 2 50 34 0 0 3 51 35 27 27 4 52 36 28 28 5 53 37 29 29 6 54 94 30 30 7 55 38 31 31 8 56 42 127 127 9 57 40 n a n a 35 126 28 28 39 64 39 64 lt 44 60 44 60 45 95 gt 46 62 46 62 Key Reference Numbers British Keyboard Key Reference Numbers KEY NORMAL SHIFT CTRL CT SH 47 63 31 31 ss 5
35. 3 Selecting amp using 2 3 Soft buttons 2 4 Status line IBM 5250 emulation 7 3 Title bar 2 3 Window Resize 2 4 Window Title 8 12 Wyse 60 Native Emulation Specification E 6 Wyse Emulations Specification E 7 Index 5 Index Notes Index 6
36. 364 mm Ledger sized paper 11 inches x 17 inches This specifies the envelope format to be used The possible settings are Don t Report NONE MFR B5 MON N9 N10 C5 DL No value returned No envelope source is defined The system determines the envelope type used based on the manufacturer type and model of the printer B5 sized envelopes 176mm x 250mm Monarch sized envelopes 3 875 x 7 5 inches Number 9 sized envelopes 3 875 x 8 875 inches Number 10 sized envelopes 4 125 x 9 5 inches C5 sized envelopes 162mm x 229mm DL sized envelopes 110mm x 220mm Setup Menus ASCII 899 Support Specifies whether the single byte printer has ASCII code page 899 installed Selecting Don t Report will cause no value to be returned WSCST Name Specifies the name of the object containing pointers to the work station customizing tables WSCST Library Specifies the library name of the object containing pointers to the work station custom izing tabes Setup Menus Settings Menu Settings Language r Emulation 5250 Keyboard Macros Attributes Mouse Button Action The Language option enables you to select the language that will be used in all menus and dialog boxes The following dialog boxes can be displayed from this menu Note that the dialog boxes used to configure specific emulations can only be displayed when the relevant emulation is runni
37. 7 1 Keyboard mapping 7 3 Record playbackkeystrokes 7 5 Selecting 7 1 Setup 6 16 Specification E 4 Statusline 7 3 Virtualkeynames A 2 IBM 5250 Printer Options 6 10 ICL 7561 Emulation Specification E 4 Icon Title 8 12 Introduction Terms amp conventions 1 3 K Key Mapping Changing key function 3 2 Referencenumbers 1 Translationresourceexamples 3 2 Key Programming Macros 6 18 Keyboard Changing key functions 3 2 Enhanced AT mapping IBM 5250 functions 7 4 Entering control characters D 1 Key reference numbers 1 Macros 3 4 6 18 Nationality 6 15 Operation 3 1 Programming keys 3 4 Remapping 3 1 Virtual key names A 1 Keysyms B 1 Keywords 4 3 L Language Selection 6 14 Macro Settings 6 18 Menu Bar 2 3 lt and gt commands 2 4 Enable disable 8 14 Pop up menus 2 3 Mouse Button multi click time 8 7 Cursor style 8 15 Mouse Functions Action hotspots 4 2 Default 4 1 Graphic select amp paste 4 2 Movecursor 4 2 Rectselecttext 4 1 Selecting text for copy 4 1 Send keyword 4 3 Show hotspots 4 2 O Operating Language 6 14 P PrintScreen 6 6 Printer Setup 6 6 Printing Printscreen 6 6 Printer setup 6 6 To file or device 6 6 Product Specification E 1 R Reset Terminal 6 4 Resizing The Window Menu lt amp gt 2 4 Resource File Selection 8 5 Resources Background colour 8 16 Bell volume 8 8 Closed telnet exits TeemTalk 8 11 Index 3 Index Cursor line sele
38. 9 58 59 58 61 43 n a n a 91 123 27 27 93 125 29 29 96 126 30 30 A 97 65 1 1 B 98 66 2 2 C 99 67 3 3 D 100 68 4 4 E 101 69 5 5 F 102 70 6 6 G 103 71 7 7 H 104 72 8 8 I 105 73 9 9 J 106 74 10 10 K 107 75 11 11 L 108 76 12 12 M 109 TI 13 13 N 110 78 14 14 111 79 15 15 112 80 16 16 Q 113 81 17 17 R 114 82 18 18 S 115 83 19 19 T 116 84 20 20 U 117 85 21 21 V 118 86 22 22 119 87 23 23 X 120 88 24 24 Y 121 89 25 25 Z 122 90 26 26 Character Sets Character Sets This appendix shows the tables of characters that are supported by TeemTalk Introduction Each character set consists of a series of control characters and displayable characters Displayable characters are alphanumeric symbolic or graphic characters that can be displayed on the screen or printed by a hardcopy device Control characters enable the terminal emulation or the printer to perform specific tasks such as a line feed or carriage return These will be actioned when received from the host or when TeemTalk is in local mode and they are entered using the keyboard To enter a control character from the keyboard first find the displayable character equivalent by adding 64 to the decimal value of the control character in the relevant character set table For example the control character CR carriage return has a decimal value of 13 Adding 64 makes 77 which is the decimal value of the displayable character M Whe
39. Erase Input F1 F24 Field Exit Field Mark Field Minus Virtual Key Name AS_ATTN AS_BACKTAB AS_BACKSPACE AS_CLEAR AS_DOWN AS_LEFT AS_RIGHT AS_FASTLEFT AS_FASTRIGHT AS_CURSORSEL AS_UP AS_DELCHAR AS_DUP AS_ENTER AS_ERASEEOF AS_ERASEINPUT AS F1 AS_F24 AS FIELDEXIT AS FIELDMARK FIELDMINUS Key Function Field Plus Help Home Insert Mode Monochrome New Line PAI Pause Play Keystrokes Print Local Print Quit Record Keystrokes Reset Roll Down Roll Up Rule Display System Request Tab Test Virtual Key Name AS FIELDPLUS AS HELP AS HOME AS INSERT AS AS NEWLINE AS PA1 AS AS PAUSE AS PLAY AS PRINTLOCAL AS PRINT AS QUIT AS RECORD AS RESET AS ROLLDOWN AS ROLLUP AS AS SYSREQ TAB AS TEST A 2 Virtual Key Names TeemTalk Virtual Key Name Functions TeemTalk provides additional virtual key name functions for special tasks such as sending text to a file or the serial port and reading text from a file to place in the keyboard buffer as if typed Key Function Virtual Key Name Start Send Text sequence VK FILE O Start Read Text sequence VK FILE I End Send Read Text sequence VK FEND Delay nnn tenths of a second VK_SLEEPnnn Note that these virtual key names are not displayed in the dialog box lists of macro keys they must be typed manually The following sections describe how to use these virtual key n
40. Setup Menus Closing A Dialog Box To close a dialog box without actioning any changes that have been made to the settings click the Cancel button This will cause all the settings in that dialog box to revert back to the state they were in when it was first displayed To close a dialog box and cause TeemTalk to assert the new settings click the OK button Default Settings TeemTalk is supplied with the setup options set to factory default If these have been altered since and you wish to reassert the original settings of all the options display the File menu and select the Factory Default option If you have modified any setup settings since you last saved the setup you can cause TeemTalk to reassert the last saved settings by selecting the Reset Terminal option in the File menu Saving The Setup The current setup configuration can be saved so that TeemTalk will automatically reassert the settings when it is subsequently reset or loaded To save the current setup configuration display the File menu and select the Save Settings option Settings are saved in the file teemx320 nv by default You can specify a different file for saving and loading settings by using the following resource or command line option Resource xteemx320 settingsFile filename Command Line sf filename Refer to the Resources amp Command Line Options chapter for more details Menu Descriptions The following pages describe the options
41. TeemTalk will print characters received from the host on stderr as well as actioning them and you can display information on particular keys or key combinations when you press them The format of the information displayed when a key or key combination is pressed is as follows Keycode 13 State 0 Keysym 65471 Resources amp Command Line Options where the Keycode is the hardware code assigned to the physical key State indicates whether the key was pressed in conjunction with a modifier key e g caps lock shift and Keysym is the unique keysym value assigned to the key or key combination This is useful for finding keysym values which can be directly used in Translation tables as shown in the following example where 65471 is the keysym value for F2 on the Sun 4 keyboard xteemx320 vt220 Translations override n lt Key gt 65471 string This is the F2 key Input Queue Size Resource xteemx320 inputQueue 0 4096 Command Line q or Q 0 4096 Default Setting 255 These commands enable you to set the input queue size for network data The size of the input queue will determine how quickly an interrupt command takes effect Prevent Message Display Resource xteemx320 quiet on off Command Line qt messages displayed qt messages displayed Default Setting off messages displayed These commands enable you to stop messages being sent to the console Mouse Button Multi Click Time Resource xte
42. The setting of this option determines whether it is displayed as a horizontal rule vertical rule or both cross Follows Cursor Factory default Unselected When the rule is displayed in the emulation workspace the setting of this option deter mines whether or not the rule follows the cursor when it moves Monochrome Factory default Depends on terminal model By default the setting of this option will match the normal display characteristic of the Model selected as shown in the terminal model list earlier In TeemTalk all terminal models support both monochrome and colour display When monochrome is selected characters will be displayed in green and intense fields will be displayed in white When monochrome is not selected the settings specified in the Attributes dialog box will be used for the display Ignore Host Cursor Style Factory default Unselected Selecting this option will cause TeemTalk to ignore any commands from the host to change the cursor style Include Euro Character Factory default Unselected When this option is selected the International Currency symbol will be replaced by the Euro symbol Field Minus Justification Factory default Unselected The setting of this option determines whether pressing the Field Minus key affects the last digit unselected or the space following the last digit selected Setup Menus Keyboard Macros TeemTalk Keyboard Macros Key Expansion Enabl
43. VK_FILE_I gt lt c file txt gt 20 5 13 lt VK_FEND gt There is normally a 100 millisecond delay between retries however many Unix systems will round this up to one second Insert Delay The following command can be used to insert a delay of nnn tenths of a second lt VK_SLEEPnnn gt For example to insert a delay of 10 seconds you would enter lt VK_SLEEP100 gt The delay can be interrupted by pressing any key Note that if you want characters to be processed before the delay insert any other VK virtual key name immediately before lt VK_SLEEPnnn gt For example 123 lt VK_TAB gt lt VK_SLEEP100 gt 456 If you do not include the additional virtual key name the lt VK_SLEEPnnn gt delay will be executed before any preceding characters are processed Keysyms Keysyms This appendix describes the use of virtual keysyms and lists all the valid keysyms that may be used to define the function of keys Virtual Keysyms The standard X translation tables may be used to redefine the function of most keys on the keyboard However certain keys such as Insert and F4 for example cannot be redefined in this way To overcome this problem OSF Motif enables you to use virtual keysyms to change the name of the keysym to be used in the translation table Programs like xev are not subject to the virtual keysym translation because they are not based on OSF Motif and
44. Y m fa Teemlalk TeemTalk 5 0 for Unix User s Guide Trademarks TeemTalk is a registered trademark of Neoware UK Ltd IBM is a registered trademark of International Business Machines Corporation X Window System is a trademark of the Massachusetts Institute of Technology All other product names are trademarks of their respective manufacturers Copyright 2004 by Neoware UK Ltd All rights reserved Before reproduction of this material in part or in whole obtain written consent from Neoware UK Ltd Neoware UK Ltd The Stables Cosgrove Milton Keynes MK19 7JJ UK Tel 44 0 1908 267111 Fax 44 0 1908 267112 Contents Contents ODU CU ON mtu MEN OC 1 1 TeemTalk amp The X Window System sese 1 1 User s Guide Overview iri ek ener 1 2 Terms amp Conventions eese eene tenente tenete enne 1 3 Getting Started 2 1 Initiating A Telnet Session essent 2 1 Selecting amp Using Window Elements esee 2 3 The Title B r ss no a ear eres erro fe ERSTER PURIS 2 3 The Ment Bar eie eher nre e tirer nete N 2 3 Window Resize Commands eese 2 4 The Soft BUttODs erre eee eor teet 2 4 Keyboard Configuration 3 1 Introductlom inet eO ENSE eat PEE eens 3 1 Remapping The Keyboard sese 3 1 Changing The
45. ames Sending Text To A File VK FILE O filename data string VK FEND will write the data string to filename Ifthe file already exists it is replaced For example lt VK_FILE_O gt lt c file txt gt text to enter to file 013 010next line of file lt VK_FEND gt will create a file called file txt containing the following two lines of text text to enter to file next line of file Sending Text To The Serial Port The following command will send text to the serial port VK FILE O dev ttySl text to send to serial port 013 010next line lt VK_FEND gt which will result in the following being sent text to send to serial port lt CR gt lt LF gt next line A 3 Virtual Key Names Reading Text From A File The following command format is used to read a string from a file and push it into the keyboard buffer as if typed lt VK_FILE_I gt lt filename gt max length retries termination char acter lt VK_FEND gt The string is terminated when the maximum length is read or the maximum number of retries is reached or the termination character is read Each can be defaulted by entering 0 so entering 0 0 0 will result in a maximum length of 1024 a single retry and a termination character of 26 EOF If the file does not exist an error will be displayed For example the following command will read up to 20 characters retry 5 times and end at the first lt CR gt lt
46. and Line display h sv sn poll seconds name filename xrm resource sf filename ttyModes kw k debug on q or Q 0 4096 qt on qt off ld character mct milliseconds cb cb bv 0 100 ibmreply on es string Command Function No telnet dialog on startup Initiate telnet session with host Host telnet port number Telnet keepalive messages Closed telnet exits TeemTalk Resource tnStartup off tnHost hostname tnPort number tnKeepalive on off tnExit on off Command Line tnstartup tnhost name tnport number tnkeepalive on tnexit on Telnet close option tnClose 0 3 tnclose 0 3 Display Format Command Function Resource Command Line Window maximized on loading Title for window amp icon Window border width in pixels Text window size amp location Text window size in lines maXimized on title title internalBorder geometry wxhtx y defaultLines ma title title bw g wxhtx ty dl Resources amp Command Line Options Window Elements Command Function Menu bar enabled disabled Menus enabled disabled Soft button levels displayed Mouse cursor style Colour Selection Resource topmenuBar on off settingsItem on off buttonLevels 0 4 mouseCursor integer value Command Line mb on Hnb off si on si off bl 0 4 mc integer value Command Function Text window foreground Text window background Text cursor colour
47. attributable to incorrect syntax or the resource file not being read by the resource manager Resource files require 100 accuracy in specification every thing is case sensitive the position of white space characters are critical and non printable characters inserted in the file causes absolute havoc Here are a few hints 1 Command line options will only work on plain files For example xteemx320 sun fg red will not work because of the file type suffix sun and all command line options will be ignored If the application name is specified as part of the resource preference string then this must be the same name by which the program is called One of the simplest tests for checking correct positioning reading of a resource file is xteemx320 title Test It which should set the window title to Test It If this doesn t work nothing else will If some of the resource file works and some doesn t then there are probably non printable characters in the resource file Check that general resources specified for other applications are not also affecting TeemTalk If they don t contain a specific name in the resource string then they will affect all applications There are many quirks to the X Window system Many basic resources e g foreground background are common to all X Applications If it doesn t work on TeemTalk try the same resource on for example xterm 8 22 Virtual Key Names Virtual
48. be tried by each session This should not cause a problem unless the separate sessions use different modulo values for example session one device name TEST 44 and session two device name ANOTHER 41009 or are connecting to different hosts Note There are separate counters for the IBM 3270 and IBM 5250 emulations User Password Library Menu These options enable you to specify the initial entries required on the standard startup screen so that it can be bypassed Each entry can be a maximum of ten characters Program This enables you to specify the name of the initial program to run The entry can be a maximum of ten characters 6 9 Setup Menus 5250 Printer Options 5250 Printer Options Printer Environment Device Name puppe tt ypo gt Mfg Type and Model 560 MSCO Library Font Paper Source 1 Don t Report E Paper Source 2 Don t Report E Envelope Hopper nont Report E ASCII 899 Support Don t Report WSCST Name uei WSCST Library This dialog box is displayed by clicking the 5250 Options button in the Telnet Options dialog box when TN5250 is not suppressed and the Model option in the IBM 5250 Settings dialog box is set to 3812 1 a printer Device Name Specifies the name of the printer device IGC Feature This is always set to Don t Report Transform Specifies whether the printer will use the host print
49. ction extent 8 8 Cut pasteEOL character 8 8 Debug mode 8 6 Debugging 8 22 Font selection 8 17 Foreground text colour 8 16 Host telnet port number 8 10 reply mode 8 8 Initiatetelnetsession 8 10 Input queue size 8 7 Introduction 8 1 Maximize window on loading 8 12 Menu bar display 8 14 Menuenable disable 8 14 Mouse button multi clicktime 8 7 Mouse cursor style 8 15 Preventmessage display 8 7 Server for display amp input 8 5 Setup file selection 8 6 Soft button display 8 15 Specifying on command line 8 6 String senton exit 8 9 Summary 8 3 Sync signal frequency 8 5 Telnet close option 8 11 Telnet dialog not displayed on startup 8 10 Telnetkeepalive messages 8 11 Textcursorcolour 8 16 Text lines displayed 8 13 Title for window amp icon 8 12 Window border width 8 12 Window size amp location 8 12 S Saving the Setup 6 3 6 4 Serial Port Sending textto 3 Virtual key names 3 Server For display amp input 8 5 Settings Menu 6 14 Setup File For loading amp storing settings 8 6 Setup Menus Attribute settings 6 21 Defaultsettings 6 3 Displaying 6 1 Emulation settings 6 15 Enable disable 8 14 Help menu 6 25 IBM 5250 settings 6 16 KeyboardMacros 6 18 Menudescriptions 6 3 Mouse Button Actions 6 23 Option selection 6 1 Saving settings 6 3 Settings menu 6 14 Startup options 6 4 Using dialog boxes 6 2 Soft Buttons 2 4 Number displayed 8 15 Programming 6 18 Specificatio
50. e Pause hold Pause Scroll Lock Scroll lock Scroll_Lock Escape Escape Escape Delete Delete rubout Delete Compose Multi key character compose Multi_key Home Home cursor Home lt Move cursor left left arrow Left T Move cursor up up arrow Up gt Move cursor right right arrow Right Move cursor down down arrow Down Previous Prior previous Prior Next Next Next End Move cursor to end of line EOL End Keysyms Keysyms KEY FUNCTION KEYSYM Begin Move cursor to beginning of line BOL Begin Select Select mark Select Print Print Print Execute Execute run do Execute Insert Insert insert here Insert Undo Undo oops Undo Redo Redo again Redo Menu Menu Menu Find Find search Find Cancel Cancel abort exit stop Cancel Help Help Help Break Break Break Character set switch mode switch Mode_switch Alias for Mode_switch Script_switch Num Lock Lock keypad in numeric mode Num_Lock Keypad space KP Space Tab Keypad Tab KP Tab Enter Keypad Enter KP Enter F1 Keypad PFl a KP F1 F2 Keypad F2 PF2 b KP_F2 F3 Keypad F3 PF3 c KP_F3 F4 Keypad F4 PF4 d KP_F4 Keypad equals sign KP_Equal Keypad multiplication sign asterisk KP Multiply Keypad plus sign KP_Add 5 Keypad separator comma KP Separator Keypad minus sign hyphen KP Subtract Keypad decimal point period KP Decimal Keypad division sign solidus KP Divide
51. e accessible even if not all are displayed Levels stored off screen can be scrolled into view by clicking the Level button A maximum of 8 rows 48 programmable buttons can be displayed by specifying 4 Specifying 0 will cause no soft buttons to be displayed Mouse Cursor Style Resource xteemx320 mouseCursor integer value Command Line mc integer value Default Setting Depends on the UNIX system These commands enable you to specify the style of the mouse cursor displayed by default in the TeemTalk window The integer value depends on the UNIX system 8 15 Resources amp Command Line Options Colour Selection Foreground Text Colour Resource xteemx320 foreground colour all areas xteemx320 vt220 foreground colour emulation Command Line fg colour Default Setting black These commands select the colour of the foreground which includes all menus window borders as well as the emulation workspace In the emulation workspace the foreground is considered to be any colour which is white The colour value must be a valid colour name a list of which can be found in the rgb txt file which is supplied with the X server When the foreground resource is preceded by vt220 only the foreground colour of the emulation workspace is affected Background Colour Resource xteemx320 background colour all areas xteemx320 vt220 background colour emulation Command Line bg colour Default Setting white T
52. e beginning of the standard translation table The effect is to define the keyboard s rightmost Meta key as the Compose Character key Note The override directive following the Translations resource name ensures that if the translation table already assigns a function to a keysym specified by the resource the new function will replace the old More than one key definition can be included in the Translations resource as shown in the following example xteemx320 vt220 Translations override n lt Key gt F1 string This is the F1 key n lt Key gt KP_4 string This is the keypad 4 key n Key Backspace value 127 Note By convention each translation is specified on a separate line The n at the end of each line except the last causes the program to interpret the next line as a continuation of the same string Redefining the shifted function of a key can be achieved by inserting the word Shift at the beginning of the key translation line as shown in the following example xteemx320 vt220 Translations foverride WV Shift lt Key gt keysym value reference number Actions can also be mixed The following example will cause ESC H to be sent when the F7 key is pressed xteemx320 vt220 Translations override n lt Key gt F7 value 27 string H Keyboard Configuration Programming Keys The Macros Settings dialog box is displayed by selecting Macros in the Settings menu This enables you to program
53. e next time TeemTalk is started unless you issue a Save Settings command after deleting the definitions When you have finished click the Finished button and the dialog box will close If you have specified that definitions are to be programmed as non volatile display the File menu and select the Save Settings option Entering Control Characters You can enter a control character in a definition either as the control key character equivalent or the decimal value of the ASCII or 8 bit character For example the control character for the Return key function CR carriage return can be entered by typing the characters and M without a space in between representing the keys Ctrl M which when pressed together would generate the CR code Decimal values are entered as three digit numbers immediately preceded by an underscore character Values with only two digits must be preceded by a zero For example the decimal value of CR is 13 so this would be entered as 013 6 20 Setup Menus Attribute Settings TeemTalk Attribute Settings Screen Element Foreground Set Color Normal AY Bold BD vo Underline lt UL Flashing FL Ce 3 BD UL c BD FL v2 v e UL FL 4 E Ea Displayed As With Attribute Background Aco artemis o vs GG b e vid 1 Auto color mode p vi wt ii F Colors Cleared with Attribute 1 fittrs Use Normal Background
54. ecific user s home directory and is processed for all applications and is not therefore specific to a particular application Since it is located in the user s home directory it only affects instances of the applications started by users whose home directory it is Unlike the Application Defaults and Command Line options which are merged into the resource database when an application is started the entries in the Xdefaults file are only read once when the X server is started Therefore changes made to the 8 20 Resources amp Command Line Options Xdefaults file will not affect applications until the next time the X Server is started and the Xdefaults file re read Controlling The Resource Database The X utility xrdb is a useful tool for maintaining and debugging the resource database Whilst full details can be found in all good X guides a few uses are presented below xrdb lt Xdefaults Loads the contents of Xdefaults into the database In practice Xdefaults can be replaced with any file that contains resource information xrdb q Displays the current contents of the database and is therefore useful for checking what resource preference strings are de fined The contents of the Application defaults and command line options are not included 8 21 Resources amp Command Line Options Debugging Resources Problems with resource management are seldom attributable to TeemTalk and are more commonly
55. ed TeemTalk will scan a list of known fonts and select the next smallest font to that currently being used The window size is then decreased so that it contains exactly the same number of rows and columns as before When the gt command is clicked TeemTalk will scan a list of known fonts and select the next largest font to that currently being used The window size is then increased so that it contains exactly the same number of rows and columns as before You can achieve the same effect using the keyboard by pressing the Meta and lt keys together to decrease the window size or Meta and gt to increase the window size Note The action names for these functions are decrease font and increase font They can be reassigned using the Translation tables as described in the Keyboard Operation chapter The window resize commands may be disabled using resources as described in the Resources amp Command Line Options chapter The Soft Buttons A series of buttons is displayed at the bottom of the window by default when TeemTalk is loaded These can be programmed so that they perform various functions when clicked Level 1 Attn ErInp SysRq Field Help Reset Clear ErEOF NeuLine Field FId Exit Enter There are four levels of soft buttons Each level consists of two rows with six programmable buttons on each row This provides a combined total of 48 program mable buttons AII levels are accessible even if not all are displayed Level
56. ed Keu Expansion Character E Soft Button 1 Level 1 lt AS_ATTN gt Soft Button 2 Level 1 lt AS_ERASEINPUT gt Soft Button 3 Level 1 lt AS_SYSREQ gt Soft Button 4 Level 1 lt AS_FIELDMINUS gt Soft Button 5 Level 1 RS HELP Soft Button 6 Level 1 RS RESET Soft Button 7 Level 1 lt AS_CLEAR gt Soft Button 8 Level 1 lt AS_ERASEEOF gt ri Program Key L ai VK_ESCAPE Program NonVolatile Program Volatile Delete All Macros Finished This dialog box is displayed by selecting Keyboard Macros in the Settings menu Key Expansion Enabled Factory default Selected This option specifies whether programmed keys on the keyboard can be expanded i e transmit their programmed contents to the host when pressed When selected a pro grammed key will send its programmed string instead of its normal character Key Expansion Character Factory default P i e DLE The key execute character is a special toggle character that can be inserted into key macro strings to cause subsequent characters to be redirected from the host to the ter minal and vice versa By default all characters in the macro are directed to the host When a key expansion character is detected for the first time characters will be redirected to the terminal until the character is detected a second time in the current or another string The key execute character is s
57. ed keystrokes may be interrupted so that keystrokes can be entered manually before continuing with the recording or playback Note that local Fn key functions cannot be recorded The keys used to initiate recording and playback are shown below Record Meta F4 see note Pause Shift Pause Quit Meta Escape Play Meta F5 Note On the Enhanced AT keyboard Meta is the Alt key You can assign the Record Pause Quit and Play functions to any key or key combination by using the virtual key names AS_ RECORD AS_PAUSE AS_QUIT and AS_PLAY respectively Recording Keystrokes 1 Press Record to enter Record mode The status line will display RECRD and a number from 0 1500 indicating the number of new keystrokes that may be stored A series of boxes displayed to the right represent the Fn keys A solid box indicates that the Fn key in that position is currently storing recorded keystrokes 2 Press the Fn key which will store the keystrokes The status line will display R F where R indicates you are in Record mode is the number of keystrokes that may be stored and F is the number of the Fn key pressed Note If you press a pre recorded Fn key its contents will be replaced with the following keystrokes You can also remove the contents of the Fn key before recording by pressing the Delete key 3 Enter the keystrokes to be recorded You may pause recording at any time to allow keystrokes to be entered manually wh
58. eed etes 6 16 Keyboard Macros rasen ne nase een 6 18 Attribute enne nennen nennen 6 21 Mouse Button Actions 6 23 6 25 5250 Emulation 7 1 Introduction neuen Em 7 1 Running The Emulation esse eee enne 7 1 Network Virtual Terminal Mode sse 7 2 Tie Stats Eines o tree etre eerte EEG 7 3 Keyboard Mapping nennen dete tete e tee venen 7 3 Record amp Playback Keystrokes Facility esee 7 5 Recording Keystrokes reete 7 5 Playback Keystrokes ps 7 6 Error Codes oae 7 6 Fax Image SupDOrt 7 7 Contents 2 Contents Resources amp Command Line Options 8 1 POITRINE 6 1 Resource Format 8 2 Command Line Option Format 6 2 Command Summary esses eene nennen 6 3 General Operation amp Setup scene 6 5 Telnet EE EE I ee p Leges 6 10 Display FOMA i iei ette seb eR aee 6 12 Window Elements eene tenente etnies 6 14 Colour Selection Ram 6 16 HONE Selection ee teet trt teretes 6 17 Understanding X entente 6 18 Virtual Key Names
59. elect font in graphic rendition No Virtual terminal commands No Set curses fix No Page scroll No Alternate screen buffer No Xwindows capabilities Bull BQ3107 7107 Specification Reference manual Bull Questar 310 Terminal BQ 3107 82 A2 78ST REVO February 1990 Limitations Remote and Line printing are not supported Product Specification Data General D200 D410 Specification Dasher D410 Display Terminals User s Manual 014 000761 02 December 1983 Digital VT Emulation Specification Digital VT 420 Programmer s Manual EK VT420 RM 001 Limitations The DEC Multisession and SSU protocols are not implemented HP 700 92 Emulation Specification HP 2392A Reference Guide 02394 90001 April 1984 IBM 3270 Emulation Specification 3270 Information Display System Data Stream Programmer s Reference GA23 0059 07 Limitations No Right to Left writing mode No double byte support Product Specification IBM 5250 Emulation Specification 5494 Remote Control Unit Functions Reference Release 2 0 SC30 3533 02 Limitations No Right to Left writing mode No double byte support The 3812 1 Non Host Print Transform Non HPT print protocol is not supported No Calculator Hex key No Password encryption No Auxillary port support No Control Unit customisation The specification is also defined by the 5250 Device Capabilities
60. emx320 multiClickTime milliseconds Command Line mct milliseconds Default Setting 250 milliseconds Some functions require a mouse button to be clicked two or more times in quick succession in order for them to be actioned These commands determine the time delay following a button click during which the next button must be clicked in order for the multi click function to be actioned otherwise it is treated as a single button click function Resources amp Command Line Options End Of Line Character For Cut amp Paste Resource xteemx320 lineDelimiter character Command Line Id character Default Setting CR carriage return These commands enable you to specify the character which is used to indicate the end of each line in a block of text during a cut and paste operation Cursor Line Selection Extent Resource xteemx320 cutToBeginningOfLine on off Command Line cb cursor to end of line cb entire cursor line Default Setting Cursor to end of line These commands enable you to specify how much of the cursor line is selected when the mouse button is clicked three times in quick succession You can specify that the entire cursor line is selected or only characters from the current cursor position to the end of the line default Bell Volume Resource xteemx320 bell Volume 0 100 Command Line bv 0 700 Default Setting Depends on the server These commands enable you to specify the loudness of the bell
61. en played back by pressing Pause Pause mode is indicated by RA To continue recording press Pause again IBM 5250 Emulation 4 Note You can cancel the newly recorded keystrokes by pressing the Quit key This cancellation does not affect the previously recorded keystrokes To finish and save the recording press the Record key Playback Keystrokes 1 2 Position the text cursor where the playback is to start Press the Play key to enter Play mode The status line will display PLAY and a series of boxes representing the Fn keys A solid box indicates that the Fn key in that position is currently storing recorded keystrokes Press the Fn key storing the recorded data to play back Playback will begin immediately as indicated by a P on the status line All the recorded keystrokes will be played back automatically When playback is completed the P will disappear If the recorded keystrokes included Pause then playback will halt at that point to allow you to enter keystrokes manually Press Play to resume playback from where you stopped typing If you want to cancel during the playback operation press the Quit key Error Codes The following error codes may appear on the status line if an error occurs during recording or playback 9001 Exceeded the maximum number of allowed keystrokes Remedy Press the Record key to exit Record mode To record a new keystroke sequence either a Press the Record key and
62. ettings option in the File menu The large text box will display the reference numbers of all the currently programmed keys and their definitions and soft button labels and definitions All volatile and non volatile key and soft button definitions can be deleted by clicking the Delete All Macros button Each key will then revert back to sending its default value as shown by the legend on the keycap Note that non volatile macro definitions will be reasserted the next time TeemTalk is started unless you issue a Save Settings command after deleting the definitions When you have finished click the Finished button and the dialog box will close If you have specified that definitions are to be programmed as non volatile display the File menu and select the Save Settings option Entering Control Characters You can enter a control character in a definition either as the control key character equivalent or the decimal value of the ASCII or 8 bit character For example the control character for the Return key function CR carriage return can be entered by typing the characters and M without a space in between representing the keys Ctrl M which when pressed together would generate the CR code Decimal values are entered as three digit numbers immediately preceded by an underscore character Values with only two digits must be preceded by a zero For example the decimal value of CR is 13 so this would be entered as 013 Keyboard Co
63. hese commands select the colour of the background which includes all menus window borders as well as the emulation workspace In the emulation workspace the background is considered to be any colour which is black The colour value must be a valid colour name a list of which can be found in the rgb txt file which is supplied with the X server When the background resource is preceded by vt220 only the background colour of the emulation workspace is affected Text Cursor Colour Resource xteemx320 cursorIndex index Command Line ci index Default Setting 15 black These commands specify the colour of the text cursor The index value is a number in the range 0 through 15 which relates to the colour indices specified in the Attribute Settings dialog box 8 16 Resources amp Command Line Options Font Selection Default Fonts When TeemTalk Started Resource xteemx320 defaultFontindex index Command Line df index Default Setting 6 7th entry in font lists This specifies the font index number which is to be used by default when TeemTalk is started to select fonts for display from the font lists The index number for the first font in each list is 0 and the tenth font is index 9 Load All Fonts Or Only As Required Resource xteemx320 preloadFont on off CommandLine fnpreload all fonts loaded fnpreload fonts loaded only when required Default Setting on These commands determine how TeemTalk loads fo
64. ic to the emulation You can identify hotspots that are currently present in display memory by holding down the Control key and the Right mouse button assuming default mouse configuration All colour attributes will be temporarily removed from the display and the hotspots will be highlighted with a red background Releasing the keys will return the display to its original state In summary the following key and mouse button combinations are used to identify and action hotspot functions by default Identify hotspots Control Right Mouse Button Action hotspot function Control Middle Mouse Button Note These functions may be assigned to different mouse button and key combinations Refer to the Mouse Functions chapter for details Hotspots Defining Hotspots Hotspot keywords and associated functions are specified in a text file which has the same name and is in the same directory as the current save settings file but with the extension hot instead of nv For example the default hotspot definitions supplied with TeemTalk are stored in the file teemx320 hot The format of entries in the hotspot definition file is as follows Each hotspot definition is entered on a separate line and definition lines are grouped under headings which specify the terminal emulation mode in which they will take effect Separators Separators 0 Definitions F1 lt VK_Fl gt F2 lt VK_F2 gt Definitions IBM5250 The first
65. iginal terminals the keyboard nationality does not directly affect the keyboard which is defined instead by the X server configuration Setup Menus IBM 5250 Settings TeemTalk IBM 5250 Settings Ruler Line Style d 4 Follows Cursor Ignore host cursor style Include Euro Character 4 Field Minus Justification This dialog box is displayed by selecting IBM 5250 the Settings menu Model Factory default 3179_2 This specifies what is reported back to the host in response to a terminal identification request Note that not all features of the specified terminal may be supported The terminal types supported and their display characteristics are listed below Type 5291 1 5292 2 5251 11 3179 2 3196 A1 3180 2 3477 FC 3477 FG 3486 BA 3487 HA 3487 HC The printer types supported are listed below 3812 1 Display Rows x Columns Monochrome 24 x 80 Colour 24 x 80 Monochrome 24 x 80 Colour 24 x 80 default Monochrome 24 x 80 Monochrome 24 x 80 and 27 x 132 Colour 24 x 80 and 27 x 132 Monochrome 24 x 80 and 27 x 132 Monochrome 24 x 80 Monochrome 24 x 80 Colour 24 x 80 Single byte printer 6 16 Setup Menus Ruler Line Style Factory default Cross A rule can be displayed across the emulation workspace at the cursor position by holding down the modifier key Alt Meta or Extend Char and pressing Page Down which toggles it on and off
66. ion For example selecting IBM 5250 in the Settings menu will display a dialog box in which you can specify settings for the IBM 5250 emulation Dialog Boxes Selecting an option which is followed by an ellipsis will cause a dialog box to be displayed The dialog box will remain on the display until the OK or Cancel button at the bottom of the dialog box is clicked Option Selection There are several methods for making selections within the dialog boxes Most options have a small square or diamond button next to them An option is selected or true when the button is pressed in and false or unselected when the button is popped out Buttons are toggled in and out by clicking the pointer on them Some options have all their applicable settings listed in a box with diamond buttons next to them In this case the buttons behave just like radio buttons in that clicking one will cause the previously depressed button to pop out Some options require you to enter information in a text box To do this click the pointer in the text box delete the previous value then enter the new value from the keyboard When there are more options that can be comfortably displayed in the dialog box these will be shown in a list box with a scroll bar The scroll bar functions in the same way as the scroll bar in the main window To make a selection display the required option in the list box then click the pointer on it so that it is highlighted
67. is ready Keyboard Mapping The following illustration shows where IBM 5250 keyboard functions are mapped to keys on the Enhanced AT keyboard layout rZ RECRD F13 14 F15 ani F18 F19 F20 ro F22 F23 F24 TEST PAUSE NONO Monochrome Cursor Select RESET Fi F2 F3 r4 Es F6 F7 F8 Fg F10 F11 F12 PRINT CLEAR ERSEL UE F MRK Field Mark EOL End Of Line Pat pag F MRK HELP FIELD INSERT HOME ROLL D FR FLD RULE puse NEWLINE DEL EOL d ERFLD Erase Field FIELD ER EOF Erase EOF EXIT Meta key usage Normal key usage All unmarked keys function as indicated by the legends on the keycaps Functions in round brackets are generated when the keys are shifted Functions in square brackets are generated when used with Ctrl Meta is on the Sun 5 keyboard and Alt on the Enhanced AT keyboard 1no e Ly pooueuu3 uogejnurj 0925 Wal IBM 5250 Emulation Record amp Playback Keystrokes Facility The record playback keystrokes facility enables you to eliminate repetitive operations by using the Fn keys to store retrieve and display data The Fn keys can store a total of 1500 keystrokes A sequence of record
68. itive true false Menu Items Resource xteemx320 settingsItem on off Command Line si enables the File and Settings menu items 51 disables the File and Settings menu items Default Setting on These commands determine whether or not the File and Settings menu items are enabled When disabled only the window resize buttons will be displayed in the menu bar You can enable disable individual menu items by using the following resources File Menu xteemx320 File Factory Sensitive true false xteemx320 File Reset Sensitive true false xteemx320 File Save Sensitive true false xteemx320 File Open Sensitive true false Telnet xteemx320 File Close Sensitive true false Telnet xteemx320 File PrinterSettings Sensitive true false 8 14 Resources amp Command Line Options xteemx320 File Print Sensitive true false xteemx320 File Quit Sensitive true false Settings Menu xteemx320 Settings Emulation Sensitive true false xteemx320 Settings IBM5250 Sensitive true false xteemx320 Settings Macros Sensitive true false xteemx320 Settings A ttributes Sensitive true false xteemx320 Settings Mouse Sensitive true false Soft Buttons Resource xteemx320 buttonLevels 0 4 Command Line bl 0 4 Default Setting 1 These commands specify how many levels of soft buttons are displayed at the bottom of the TeemTalk window A level consists of two rows of soft buttons with six programmable buttons on each row All levels ar
69. l perform the same function as the Insert key found on the IBM keyboard enter the following line in the relevant Definitions command group Insert lt IB_INSERT gt To define a keyword so that it will perform the same function as pressing two or more other keys together type the lt character followed by the virtual key names linked together with characters and ending with the gt character For example to define the keyword Help so that when it is clicked it performs the same function as pressing the keys Alt F4 together enter the following line in the relevant Definitions command group Help lt ALT F4 gt To define a keyword so that it will perform the same function as pressing a sequence of keys one after the other enter each virtual key name in the order required enclosing each name with the lt and gt characters Each enclosed virtual key name must immediately follow the previous enclosed virtual key name with no spaces For example to define the keyword Command so that when it is clicked it performs the same function as pressing the keys F2 then F3 then F4 enter the following line in the relevant Definitions command group Command lt F2 gt lt F3 gt lt F4 gt Hotspots Notes 5 4 Setup Menus Setup Menus This chapter describes the options available in the setup menus and dialog boxes Selecting amp Closing Menus Three menus labelled File Settings and Help can be displayed
70. lation The TeemTalk window will be in Network Virtual Terminal mode until a successful host connection is made 1 Display the IBM 5250 Settings dialog box from the Settings menu and select the Model This specifies what is reported back to the host in response to a terminal identification request Note that not all features of the specified terminal may be supported It also allows you to specify whether the display is treated as monochrome green for normal characters white for intense attribute or colour for attributes The terminal types currently supported and their display characteristics are listed below Type Display Rows x Columns 5291 1 Monochrome 24 x 80 5292 2 Colour 24 x 80 525 11 Monochrome 24 x 80 3179 2 Colour 24 x 80 default 3196 A1 Monochrome 24 x 80 IBM 5250 Emulation 3180_2 3477_FC 3477_FG 3486_BA 3487_HA 3487_HC The printer types supported are listed below 3812 1 Monochrome 24 x 80 and 27 x 132 Colour 24 x 80 and 27 x 132 Monochrome 24 x 80 and 27 x 132 Monochrome 24 x 80 Monochrome 24 x 80 Colour 24 x 80 Single byte printer 2 Select Open Connection in the File menu Specify the name of the host to which connection is to be made then click Ok Refer to the Setup Menus chapter for a description of the New Connection dialog box 3 Ifnecessary enter the appropriate information to establish an IBM host session in the Network Virtual Terminal mode screen 4 When an IBM ho
71. le the leftmost Shift key has the keysym Shift_L and the rightmost Shift key has the keysym Shift_R A list of valid keysyms defined by the X Window System can be found in the Keysyms appendix The keysym of a key is used to identify it for reconfiguration To find out the keysym for a particular key you should consult the documentation supplied with the workstation On some workstations a program called xev is provided which enables interactive interrogation of a key s keysym You can find the keysym value of a key by placing TeemTalk in debug mode using the debug command line option or debugMode resource then pressing a key or key combination The following information will be displayed when the F2 key on a Sun 4 keyboard is pressed Keyboard Configuration Keycode 13 State 0 Keysym 65471 The Keysym value can be directly used in Translation tables as shown in the following example xteemx320 vt220 Translations override n lt Key gt 65471 string This is the F2 key Changing The Function Of A Key Once the keysym of a particular key is known you can change the function of that key by using the Translations resource This modifies a specified translation table within the TeemTalk program which is used to assign events to actions This table should be placed in the Xdefaults or application defaults file as described in the Resources amp Command Line Options chapter TeemTalk supports two action functions rela
72. ll be informed that the option is supported DONT Will force negotiation A negotiation packet will be sent to the host telling it that the option is not supported Break Settings The setting of these options determine whether or not a timing mark TM and or carriage return CR is sent with a Telnet break packet A timing mark is sent by de fault Make connection on startup If you select Save Settings in the File menu when this option is selected the next time you open the session it will automatically make the host connection 5250 Options 5250 Options Environment Device Name User Password Library I Henuz Program Cancel This dialog box is displayed by clicking the 5250 Options button in the Telnet Options dialog box when TN5250 is not suppressed and the Model option in the IBM 5250 Settings dialog box is not set to 3812 1 a printer Refer to the next section for 5250 Printer Options Setup Menus Device Name This enables you to enter the name of the device which the server will be requested to assign to this Telnet session You can return the local host name by entering s after the device name To return the user name enter u after the device name You can specify how many characters of the name is returned in each case For example 3s will return the first three characters of the local host name and 3s will return the last three cha
73. most keys with up to four definitions macros each Keys that cannot be redefined include Shift Caps Lock and Print Screen The programmed contents of a key or key combination can be transmitted to the host when pressed by selecting the Key Expansion Enabled option in this dialog box TeemTalk Keyboard Macros Key Expansion Enabled Key Expansion Character Soft Button 1 Level 773 lt AS_ATTN gt Soft Button 2 Level 1 lt AS_ERASEINPUT gt Soft Button 3 Level 1 lt AS_SYSREQ gt Soft Button 4 Level 773 lt AS_FIELDMINUS gt Soft Button 5 Level 1 RS HELP Soft Button 6 Level RS RESET Soft Button 7 Level lt AS_CLEAR gt Soft Button 8 Level lt AS_ERASEEOF gt WK ESCRPE Program NonVolatile Program Volatile Delete All Macros Finished To program a key click the pointer in the Program Key text box then press the key or key combination that is to be programmed The key combination can be any of the following Key Alt Key Ctrl Key Alt Ctrl Key Shift Key Alt Shift Key Ctrl Shift Key Alt Ctrl Shift Key Pressing a key will cause the key legend or a reference number that uniquely identifies the key to be displayed Press Tab or click the pointer in the with text box and enter the new definition This can include specific functions associated with a particular terminal emulation as listed in the Predefined Virtual Key Names list box The Virtual Key Names
74. n E 1 AIXTerm E 2 Bull BQ 3107 7107 E 2 Data General D200 D410 E 3 Digital VT emulation E 3 General E 1 HP 700 92 E 3 3151 4 3270 3 5250 4 7561 E 4 Stratus 102 E 5 Tandem 6526 6530 E 5 Televideo 955 6 Telnet E 2 Unisys 27 E 6 Wyse 60 Native E 6 Wyseemulations E 7 Startup Options 6 4 Status Line IBM 5250 emulation 7 3 Stratus V102 Emulation Specification E 5 String Sent To Host On Exit 8 9 Support Level E 1 Index 4 Index T TA6530 Emulation Specification E 5 Telnet Close option 8 11 Closed session exits TeemTalk 8 11 Dialog not displayed on startup 8 10 Host portnumber 8 10 Initiate host session 8 10 Initiating asession 2 1 Keepalive messages 8 11 Open Connection dialog box 6 5 Specification E 2 Telnet Options 6 7 5250 6 8 5250 Printer Options 6 10 Terminal Emulation Level of support E 1 Terminal Reset 6 4 Terms Used In Manual 1 3 Text Attributes 6 21 Text Lines Displayed on loading 8 13 TitleBar 2 3 Title For Window amp Icon 8 12 TVI 955 Emulation Specification E 6 U Unisys T27 Emulation Specification E 6 V Virtual Key Names 1 IBM 5250 emulation 2 Insertdelay A 4 Reading text from a file 4 Serial port functions 3 Standard 1 Writing text toafile 3 Virtual Keysyms B 1 W Window Border width 8 12 Menu bar display 8 14 Size amp location 8 12 Window Elements lt and gt 2 4 Hotspots 4 2 Menu bar 2
75. n Ele ment selection are defined by clicking one of the 16 coloured buttons in each palette You can change the colour assigned to any of the colour selection buttons by clicking the button so that the large box to the right displays the current colour for that button then use the Red Green and Blue adjustment slides to modify the colour displayed Auto color Mode Factory default Unselected This option is not supported by this version of TeemTalk Colours Cleared With Attribute Factory default Selected The setting of this option determines whether or not the foreground and background colours are cleared to the default colours when an ANSI clear attributes command is received Attributes Use Normal Background Factory default Unselected This option is not supported by this version of TeemTalk 6 22 Setup Menus Mouse Button Actions TeemTalk Mouse Button Actions Normal Edit Paste Extena Selection gt Shift Select Rectangle Edit Paste Extena Selection 2 Control 7r Rein Hotspots Brow Hotspots gt Ctrl Shift Betect Graphics Paste Graphics Bena Keyword 2 Alt Unassigned E Unassigned Bl Unassigned gt Highlight When Actioned 0K Cancel This dialog box is displayed by selecting Mouse Button Action in the Settings menu This enables you to specify the function of mouse buttons 1 2 and 3 when they are pressed on their o
76. n the Ctrl control key is held down and Shift M is pressed or M alone if Caps Lock is on this will generate a CR code when in local mode Some setup options require you to specify one or more control characters A control character is specified by typing to represent the Ctrl key immediately followed by the displayable character equivalent of the control character as described in the previous paragraph So M represents Ctrl M which generates the control character CR Character Sets IBM 5250 ENGLISH U S CANADIAN BILINGUAL amp NETHERLANDS CHARACTER SET gt gt xx gt A Dovoz al r Acs N lt x lt cino OI 19 Oi AJOJN za Legend RSP required space SHY syllable SP space D 2 Character Sets IBM 5250 ENGLISH U K CHARACTER SET Legend RSP required space SHY syllable hyphen SP space D 3 Character Sets IBM 5250 DANISH amp NORWEGIAN CHARACTER SET B A C D E F G H 9 Oo zz rnm Al c m N lt lt 9 WO za Legend RSP required space SHY syllable hyphen SP space Character Sets IBM 5250 FRENCH CHARACTER SET
77. nfiguration Notes 3 6 Mouse Functions Mouse Functions This chapter describes the special functions assigned to the mouse buttons by TeemTalk and how to redefine the buttons Introduction TeemTalk assigns a variety of special functions to the mouse buttons Each button can be used to action up to five functions when pressed in conjunction with modifier keys The following table lists the functions assigned to each button and key combination by default Button 1 Button 2 Button 3 Normal Select Text Edit Paste Extend Selection Shift Rect Select Text Edit Paste Extend Selection Control Move Cursor Action Hotspots Show Hotspots Control Shift Graphic Select Graphic Paste Send Keyword Alt Unassigned Unassigned Unassigned Note that usually Button 1 is the leftmost button Button 2 is the middle button and Button 3 is the rightmost button References to mouse buttons throughout this User s Guide will assume that they are configured in this way Selecting amp Copying Text You can use the mouse buttons to copy and paste text The region of the display that will be selected for copying depends on whether you use the Select or Select Rect angle function The Select function will select all text from the start position to the finish position working left to right across the entire width of the display whereas the Select Rectangle function will only select text con
78. ng Emulation Settings IBM 5250 Settings Keyboard Macros Attribute Settings Mouse Button Action for specifying the terminal emulation keyboard nationality and displayable characters for configuring the IBM 5250 emulation for defining the function of keys and soft buttons for assigning colours and specifying how characters with attributes are displayed for specifying mouse button functions 6 14 Setup Menus Emulation Settings TeemTalk Emulation Settings Alpha Emulation This dialog box is displayed by selecting Emulation in the Settings menu Alpha Emulation Factory default IBM 5250 The IBM 5250 emulation provides compatibility with software designed to drive IBM 5250 type alphanumeric terminals This emulation can be used for connection to an IBM AS 400 System 36 or System 38 Note that the initial display will be an ASCII text screen known as the Network Virtual Terminal Mode You are required to make a host connection using the Telnet facility supplied with TeemTalk in order to display the IBM 5250 screen and enable the emulation to function correctly Refer to the JBM 5250 Emulation chapter for more information Keyboard Language Factory default North American This option enables you to specify the nationality of the keyboard being used It is important that this is correct otherwise the characters displayed may not match the key legends Unlike the or
79. nts When preload font is enabled TeemTalk will load all fonts standard bold double width etc when it is started or when the window is resized When preload font is disabled TeemTalk will only load fonts when they are required 8 17 Resources amp Command Line Options Understanding X Resources Most X clients now implement a simple mechanism of specifying application prefer ences using preference strings These preference strings comprise the name of the X client followed by the name of the resource to be set A colon and then the value to be assigned to the resource follow The following example specifies that the TeemTalk background colour should be set to blue xteemx320 background blue Note that if the X client name xteemx320 is omitted then the resource entry will match all applications that recognise the background resource name Consequently the resource entry background blue will set the background colour of all X clients to blue Since most applications are now object orientated they comprise of many sub objects and hence many windows TeemTalk for example comprises a main applica tion window a scroll bar a menu bar and many pull down menus When the back ground resource for TeemTalk is used it changes the background colour of all objects That is in our example the main window scroll bar background and menu bar background all become blue In order to have more precise control over specific
80. onization signal to the X server to check that it is still alive Resource File Selection Resource None Command Line name filename Default Setting xteemx320 This command line option specifies the file name that is used when searching the default files for resource information Command line examples xteemx320 name TeemTalk1 xteemx320 name TeemTalk2 Resources amp Command Line Options These will select the following files from the Xdefaults file TeemTalk1 title johns TeemTalk TeemTalk2 title stuarts TeemTalk Specify Resource On Command Line Resource None Command Line xrm resource string Default Setting Not applicable This allows a resource specification to be included on the command line as an argument This is especially useful for setting resources that do not have equivalent command line options The resource string can be any valid resource specification Command line example xteemx320 xrm title New Project This uses the title resource to specify the text that is to be displayed in the TeemTalk window title bar in this case New Project Setup File Selection Resource xteemx320 settingsFile filename Command Line sf filename Default Setting teemx320 nv These commands specify the path and name of the file to be used to load and store saved setup settings Debug Mode Resource xteemx320 debugMode Command Line debug Default Setting Not applicable In debug mode
81. option will display the Text Printer Settings dialog box which enables you to specify the destination of print data To select a printer just click on the name in the Printers Available list box then click the OK button Further print requests e g Autoprint or Print Screen will be directed towards that printer TeemTalk Text Printer Settings Printers Available aL a Current System Printer Driver fy apr Use Printer With options Cancel Options Clicking the Options button will display another dialog box with additional print options The Printed Data Type options enable you to restrict the character sets used for printing so that they match those supported by your printer You can select from one of three different Printer Modes Selecting Normal default will enable you to print a page of text or text in the scrolling region depending on the Printer Extent selection Selecting Auto will cause the current display line to be sent to the printer when the cursor moves to the next line Auto print mode lets you print each line as it is received from the host Selecting Controller will enable the host to to send text directly to the printer without displaying it on the screen Print Screen Clicking this option cause a fast print of text displayed in the TeemTalk window using ASCII text codes Quit This will cause TeemTalk to shut down Setup Menus Telnet Options
82. ouse cursor where you wish the top left corner of the copied data to be positioned then hold down the keys Control Shift and click the Middle mouse button Refer to the description of the Graphics Copy Mode option in the Setup Menus chapter for ways in which you can modify the display of copied data Moving The Cursor In Block Mode When TeemTalk is in any of the local block modes you can use the mouse instead of the cursor keys to position the text cursor Move the mouse cursor to the required position then hold down the Control key and click the Left mouse button The text cursor will then jump to that position Show amp Action Hotspots TeemTalk incorporates a user definable hotspot facility which enables you to invoke a function by clicking the mouse cursor over a keyword displayed on the screen For example an application may display information relating to keys you can press to perform a particular function Instead of pressing the key on the keyboard you could invoke the function by moving the mouse cursor over the displayed key name holding down the Control key and clicking the Middle mouse button Mouse Functions Hotspots are supported in ALL terminal emulation modes TeemTalk provides a set of default hotspot keywords for each mode These relate to key functions specific to the emulation You can identify hotspots that are currently present in display memory by holding down the Control key and the Right mouse b
83. pecified as the control key character equivalent For example the default value P represents the keys Ctrl P which would generate the ASCII control character DLE when pressed 6 18 Setup Menus Program Key With These options enable you to program most keys with up to four definitions macros each and the soft buttons with one definition each Keys that cannot be redefined include Shift Caps Lock and Print Screen The programmed contents of a key or key combination can be transmitted to the host when pressed by selecting the Key Expansion Enabled option in this dialog box To program a key or soft button click the pointer in the Program Key text box then press the key or key combination or click the soft button that is to be programmed The key combination can be any of the following Key Ctrl Key Shift Key Ctrl Shift Key Alt Key Alt Ctrl Key Alt Shift Key Alt Ctrl Shift Key Pressing a key or soft button will cause the key legend or a reference number that uniquely identifies the key or soft button used to be displayed Press Tab or click the pointer in the with text box and enter the new definition This can include specific functions associated with a particular terminal emulation as listed in the Predefined Virtual Key Names list box The Virtual Key Names appendix provides a complete list of virtual key names and their associated functions Clicking a key name in this list box will cau
84. ported Serial configuration commands not supported Select character set commands not supported Unisys T27 Specification Burroughs T27 Programmer s Reference Manual 1196904 Aug 1986 Limitations Print protocol printer sessions and auxiliary i o are not supported Some local only keyboard ctrl and esc commands are not supported Data sharing and scratchpad functions are not supported Wyse 60 Native Emulation Specification WY 60 Programmer s Guide 880261 01 Rev A Limitations Only 16 colours supported not 64 Some colour commands are not supported No page edit mode Modem and aux port commands not supported No Keyboard scan code mode Character cell size commands not supported Product Specification Function key label save commands not supported Automatic font loading not supported Remote caps lock commands not supported Ignore nulls commands not supported Attribute overwrite mode not supported Disable intensity commands not supported Some select personality commands not supported Wyseword mode not supported Wyse 50 50 TVI 910 925 950 ADDS A2 HZ 1500 Wyse PC Term Specification WY355 ES Reference Manual 883227 01 Rev A Limitations All modes As Wyse 60 above where applicable TVI modes Select Print Line termination characters Wyse PC Term Default unit command not supported Program key with direction not supported Set print terminators not s
85. r 24 x 80 and 27 x 132 Monochrome 24 x 80 and 27 x 132 Monochrome 24 x 80 Monochrome 24 x 80 Colour 24 x 80 Single byte printer 2 Select Open Connection in the File menu to display the Telnet Hosts dialog box A list of hosts currently available for connection will be displayed in the Telnet Hosts list box ES TeemTalk Telnet Hosts Telnet Hosts localhost locis loc gov tnserver di3270 com Hostname 0K Cancel Options Clicking the Options button will display another dialog box with additional telnet options These are described in the Setup Menus chapter To make a connection either click on the name in the list box or type it in the Hostname text box then click OK To save the settings so that they will be Getting Started automatically reasserted when TeemTalk is subsequently reset or loaded display the File menu and select the Save Settings option 3 Ifnecessary enter the appropriate information to establish an IBM host session in the Network Virtual Terminal mode screen 4 When an IBM host session has been established the screen will switch out of Network Virtual Terminal mode and display the IBM 5250 emulation screen Note You will be returned to the Network Virtual Terminal screen when the connection to the IBM host has been closed Selecting amp Using Window Elements The TeemTalk window consists of various elements which are described in the following sections
86. racters To automatically assign a new device name for each successive connection enter after the name where N is a decimal value Each time the host requests the device name a counter will be incremented modulus N and substituted into the device name For example TEST d4 will give TEST1 on first connect TEST2 on second TEST3 on third TESTO on fourth TEST1 on fifth and so on TEST d100 will give TESTI on first connect TEST2 on second TEST99 on 99th TESTO on 100th TESTI on 101st and so on These values are preserved over power off so the first connection of any given power on may not be TEST1 Assume that the start point is random In addition there is a single counter for the unit so concurrent sessions will start from subsequent values For example if session one uses TESTI then session two will use TEST2 Where a device name collision occurs i e the device name is already in use on the host the host will ask again for the device name during the same connection In this case TEST1 TEST2 may all be tried in one connection until the host accepts one or all possibilities have been tried In the latter case the same name is sent twice in succession to indicate to the host all names have been tried If concurrent 5250 sessions are started before a previous session has negotiated an acceptable device name it is possible that the two sessions will access the counter simultaneously and not all possible names will
87. rounding the TeemTalk window Command line example xteemx320 bw 50 This will cause the TeemTalk window border to be 50 pixels wide Window Size amp Location Pixels Resource xteemx320 geometry widthxheighttx y Command Line geometry widthxheight x y Default Setting 640x400 This enables the size and location of the TeemTalk window to be specified 8 12 Resources amp Command Line Options The geometry option may be abbreviated to g Note The effect of these commands is determined by the window manager which may have its own rules for window size and position on the display The command is followed by the size and location arguments which take the following form widthxheight xoffset yoffset The values for each of the four variables are specified as numbers of pixels A positive offset will position the left or top edge of the window a specified pixel distance from the left or top edge of the display while a negative offset will position the right or bottom edge of the window a specified pixel distance from the right or bottom edge of the display If any of the values are omitted TeemTalk will use the resource manager defaults for the missing values If no location defaults are specified by the resource manager the user will have to position the window manually The default size of the initial window is640 x 400 pixels in which 80 columns by 25 lines 24 text lines and 1 status line is displa
88. s and script language programming Entering Control Characters You can enter a control character in a keyword definition either as the control key character equivalent or the decimal value of the ASCII character Hotspots For example the control character for the Return key function CR carriage return can be entered by typing the characters and M representing the keys Ctrl M which when pressed together would generate the CR code This could be used to define the keyword Login to enable you to log on to a host Login hostname M Decimal values are entered as three digit numbers immediately preceded by an underscore character Values with only two digits must be preceded by a zero For example the decimal value of CR is 13 so this would be entered as 013 Key Combinations amp Sequences You can define a keyword to perform the function of a particular key a combination of keys or a sequence of keys For example you can define a keyword to perform the same function as pressing the key F4 or pressing the keys Alt F4 together or pressing the keys F2 then F3 then F4 Keys are identified by their virtual key names as listed in the Virtual Key Names appendix You may omit the VK IB etc parts of the name To define a keyword so that it will perform the function of a particular key type the character followed by the virtual key name then the character For example to define the keyword Insert so that it wil
89. s listed below Region Symbol Colour Column Meaning 1 T Blue 1 Telnet session running 2 Blue 18 On line IBM 5250 mode 3 M Blue 28 Message waiting 4 A Blue 48 Insert mode on 5 X Red 57 Input inhibited 6 rr cc orrr iccc White 75 80 Row column cursor position The meaning of the symbols is as follows T i Indicates that a Telnet session is running Indicates that the current screen is an IBM 5250 screen This screen will be displayed when you have initiated a Telnet session with the host Indicates that the system has one or more messages waiting for you Indicates that the keyboard is in Insert mode Already existing characters to the right of the cursor will move to make room for new characters that are entered Insert mode can be disabled by pressing the Insert key again pressing the Reset key or by performing any action that sends data to the host such as pressing the Enter Clear or PF keys Indicates when input from the keyboard or mouse will not be accepted by the host When this is because an error has occured as shown in the error line pressing the Reset key will remove the error Alternatively more information can be obtained by pressing the Help key The only other keys available are Attn SysReq and Print Note that the emulation includes typeahead capability so that in most cases you can continue to enter data without waiting for the Do Not Enter message to clear as the data will be stored until the host
90. s stored off screen can be scrolled into view by clicking the Level button You can specify how many levels of soft buttons are actually displayed by using a resource or command line option The soft buttons are programmed using the Keyboard Macros dialog box which is displayed by selecting Settings in the menu bar then Keyboard Macros Refer to the Setup Menus chapter for information Keyboard Configuration Keyboard Configuration This chapter describes how to configure TeemTalk for your particular keyboard remap key functions and compose special characters Introduction TeemTalk maps the keyboard to be as near as possible to the terminal being emulated Illustrations showing the mapping of functions are shown in each terminal emulation chapter You can remap the keyboard as required and functions that may not be represented on the keyboard can be assigned to specific keys Remapping The Keyboard As the legends on the keycaps may not correspond to the actual functions of the keys and the legends themselves may change from keyboard to keyboard the X Window System uses keysyms to identify the function of keys Each key has its own unique keysym label which generally matches the function indicated by the legend on the keycap For example the keysym for the Return key is Return When more than one key share the same function the keysym includes an indication of the location of each key on the keyboard For examp
91. script 2 twosuperior 3 Superscript 3 threesuperior 6 Acute accent acute u Micro sign mu q Pilcrow sign paragraph Middle dot periodcentered B 10 Keysyms Keysyms KEY FUNCTION KEYSYM Cedilla cedilla Superscript 1 onesuperior g Masculine ordinal indicator masculine Right angle quotation mark guillemotright 14 Vulgar fraction one quarter onequarter V Vulgar fraction one half onehalf 3A Vulgar fraction three quarters threequarters Inverted question mark questiondown A Uppercase A with grave accent Agrave A Uppercase A with acute accent Aacute A Uppercase A with circumflex accent Acircumflex A Uppercase A with tilde Atilde A Uppercase A with diaeresis Adiaeresis A Uppercase A with ring above Aring Uppercase diphthong AE AE C Uppercase C with cedilla Ccedilla E Uppercase E with grave accent Egrave E Uppercase E with acute accent Eacute Uppercase E with circumflex accent Ecircumflex E Uppercase E with diaeresis Ediaeresis i Uppercase I with grave accent Igrave i Uppercase I with acute accent Iacute i Uppercase I with circumflex accent Icircumflex I Uppercase I with diaeresis Idiaeresis D Uppercase Icelandic eth Eth N Uppercase N with tilde Ntilde Uppercase O with grave accent Ograve Uppercase O with acute accent Oacute Uppercase O with circumflex accent Ocircumflex B 11 Keysyms
92. se it to appear on the key definition line The function associated with the key name will be attributed to the key or soft button being defined You can also enter control characters or specify that a script file is to be run as described in the following sections Note An escape sequence will be sent across a network as a single packet If you are defining a soft button you can give it a label up to ten characters long which is displayed on the soft button in the window by entering it in the Soft Button Label text box When the definition is complete decide if you wish the key or soft button contents to be saved so that it will be asserted each time TeemTalk is reset or loaded then click the Program Volatile or Program NonVolatile button Clicking the Program Volatile button will cause TeemTalk to only remember the definition until it is reset or exited Clicking the Program NonVolatile button will enable the definition to be saved when you select the Save Settings option in the File menu The large text box will display the reference numbers of all the currently programmed keys and their definitions and soft button labels and definitions Setup Menus All volatile and non volatile key and soft button definitions can be deleted by clicking the Delete All Macros button Each key will then revert back to sending its default value as shown by the legend on the keycap Note that non volatile macro definitions will be reasserted th
93. specified host Most emulations work quite well in the standard TeemTalk environment when the telnet process provided with the workstation is used to make the connection to the remote host However in some block mode emulations the telnet process does not pass all the necessary information to TeemTalk To overcome this TeemTalk has its own inbuilt telnet driver so that precise control can be exercised over the information that TeemTalk receives and transmits You must use the telnet facility provided by TeemTalk when using block mode emulations such IBM 3270 Host Telnet Port Number Resource xteemx320 tnPort number Command Line tnport number Default Setting 23 These commands enable you to specify the number of your host s telnet port if it is different from the default port number 23 8 10 Resources amp Command Line Options Telnet Keepalive Messages Resource xteemx320 tnKeepalive on off Command Line tnkeepalive enabled tnkeepalive disabled Default Setting Enabled These commands allow you to enable or disable telnet keepalive messages when using the TeemTalk telnet driver Closed Telnet Session Exits TeemTalk Resource xteemx320 tnExit on Command Line tnexit Default Setting off message box displayed When a telnet session is closed TeemTalk normally displays a message box giving you the option to reconnect cancel or exit These commands enable you to cause TeemTalk to be exited immediatel
94. st session has been established the screen will switch out of Network Virtual Terminal mode and display the IBM 5250 emulation screen Note You will be returned to the Network Virtual Terminal screen when the connection to the IBM host has been closed Network Virtual Terminal Mode Network Virtual Terminal NVT mode allows the operator to communicate with a network gateway in ASCII for routing logon etc before the full IBM terminal emulation protocol is established mode is indicated by the absence of the If symbol in the status line along the bottom of the window NVT mode displays an unformatted screen for data entry allowing basic keyboard functionality as a simple ASCII terminal In addition to data keys other recognized keys are Clear Enter Newline Backspace Tab clears the screen sends a CR to the host sends a CR to the host sends a BS to the host sends an HT to the host Once the appropriate details have been entered to establish an IBM host session which may be automatic the screen is cleared and switched into full IBM 5250 terminal emulation mode as indicated by the ll symbol in the status line IBM 5250 Emulation The Status Line The last line in the window is used to display status information in the form of symbols and alphanumeric characters A coloured line separates status information from the rest of the display Information is displayed in any of six regions within the status line a
95. stem with the same look and feel as other applications The X Window System is a network based windowing system that provides a common graphical interface for application programs It defines how applications create windows and the graphics displayed in them X is based on a client server model in which the client is the application program and the server controls the display and keeps track of user input Communication between client and server can be achieved via networks serial interfaces or internal operating system streams using standard X protocols Since X is both window based and network oriented there can be multiple applications on the network creating individual windows on an individual display The display is therefore providing a service to each application and hence is known as the X display server The basic function of TeemTalk for Unix is to accept IBM command sequences from a host application client and convert them into equivalent X functions which can then be passed on to the X display server This means that current investment in host application software can be retained in the X Windows environment Each window displayed by TeemTalk is in effect a separate terminal Several terminal emulation windows may be displayed simultaneously on the same display server all running different programs but only one window may be active at any one time 1 1 Introduction User s Guide Overview Chapter 1 Chapter
96. tained within the rectangular area defined by the start position top left corner and the finish position bottom right corner 4 1 Mouse Functions The default method for selecting text is as follows Place the cursor at the start of the text to be copied hold down the Left mouse button with Shift if a rectangular area is to be selected then drag the cursor across to the end of the required text Releasing the mouse button will cause the selected text to be saved in the global cut buffer Another method of selecting text is to quickly click the Left mouse button twice to select the word at the current cursor position or three times to select the entire line Clicking four times will revert back to single character selection To extend the selection click the Right mouse button Text that has been saved in the global cut buffer may be pasted at the current cursor position by clicking the Middle mouse button Graphic Copy amp Paste TeemTalk provides a graphic copy facility which enables you to copy text and graphics and paste the information in any TeemTalk window The area to be copied is selected by positioning the mouse cursor at the top left corner of the required area holding down the keys Control Shift and the Left mouse button then dragging the mouse cursor down to the bottom right corner of the required area Releasing the keys will cause the currently selected area to be copied To paste the data position the m
97. ted to keyboard mapping string and value string string This command will cause the specified string to be sent when the key specified in the translation table is activated For example string This is a string action value decimal value of ASCII character This command will map the specified key to send the character corresponding to the ASCII decimal equivalent ADE of the value specified For example value 27 will send the Escape character ESC is ASCII decimal 27 Some of the values that can be specified do not directly cause characters to be transmitted but invoke functions within TeemTalk instead For example value 128 will cause TeemTalk to treat the activated key as F1 function key 1 and value 166 will cause TeemTalk to treat the activated key as the Compose Charac ter key These values are either undefined ADE ASCII decimal equivalent codes or values outside the range of ADE values The values that TeemTalk expects for various keys and functions can be ascertained from the Key Reference Numbers appendix Translation Resource Examples The following example shows how to use the Translations resource to modify the translation table so that the Compose Character function is assigned to the key that has the keysym Meta R Keyboard Configuration xteemx320 vt220 Translations override n lt Key gt Meta_R value 166 This will cause the line lt Key gt Meta_R value 166 to be added to th
98. than one place the priority which exists between duplicate entries is also important The following sections describe the most common sources of resource entries the sections are ordered according to priority e g command line options override duplicate entries in the Xdefaults file Command Line Entries on the command line override any other settings specified in other resource files Whilst most general attributes have equivalent command line arguments heirarichal ones seldom do have direct equivalents For example foreground red has the command line equivalent fg red Settings red does not have a direct equivalent Although the latter does not have a direct command line option equivalent it can still be specified on the command line by using its resource string directly For example xrm Settings red Application Defaults The application defaults file usually exists in either of usr lib X11 app defaults for Motif based systems or 0PENWINHOME lib app defaults on OpenWindows based systems The file in which the resource entries are put is the name of the application with the first two letters capitalised the application name is hard coded by the X client vendor and is unchangeable The application defaults file name is xteemx320 The Application defaults file sets resources globally for applications and therefore sets preferences for all users of the application XDefaults The Xdefaults file is located in a sp
99. unction key 5 F15 equivalent L5 Left function key 6 F16 equivalent L6 Left function key 7 F17 equivalent L7 Left function key 8 F18 equivalent L8 Left function key 9 F19 equivalent L9 Left function key 10 F20 equivalent L10 Right function key 1 F21 equivalent R1 Right function key 2 F22 equivalent R2 Right function key 3 F23 equivalent R3 Keysyms Keysyms KEY FUNCTION KEYSYM Right function key 4 F24 equivalent R4 Right function key 5 F25 equivalent R5 Right function key 6 F26 equivalent R6 Right function key 7 F27 equivalent R7 Right function key 8 F28 equivalent R8 Right function key 9 F29 equivalent R9 Right function key 10 F30 equivalent R10 Right function key 11 F31 equivalent R11 Right function key 12 F32 equivalent R12 Right function key 13 F33 equivalent R13 Right function key 14 F34 equivalent R14 Right function key 15 F35 equivalent R15 Shift Left Shift Shift L Shift Right Shift Shift R Ctrl Left Control Control L Ctrl Right Control Control_R Caps Lock Caps Lock Caps_Lock Shift Lock Shift Lock Shift_Lock Meta Left Meta Meta_L Meta Right Meta Meta_R Alt Left Alt Alt_L Alt Right Alt Alt_R Left Super Super_L Right Super Super_R Left Hyper Hyper_L Right Hyper Hyper_R Space space Exclamation mark exclam Double quotation mark quotedbl Keysyms
100. und To display the actual attribute assigned to the text in the default text colour select Attribute To display text assigned with an attribute in a particular colour only select 6 21 Setup Menus Colour and specify the foreground and background colours on the palettes To display text assigned with an attribute with both attribute and a particular colour select Colour specify the foreground and background colours on the palettes and specify the applicable attribute s from the With Attribute list The following sections describe items in the Attribute Settings dialog box in more detail Attribute Combination This list box enables you to select a specific attribute combination of attributes or Tek line style for defining how they are displayed The options available depends on the current terminal emulation mode When running the IBM 5250 emulation the list of character attributes is extended to include the column separator CS attribute The Ansi Palette option at the top of the list allows you to specify which set of eight Foreground and Background colour indices are used when ANSI colour escape sequences are received Either indices 0 to 7 or 8 to 15 can be selected The unselected set of colours appear greyed To change the current selection just click on one of the unselected colour index buttons Foreground amp Background Colour Palettes The Foreground text and Background cell colours for the current Scree
101. upported Define delimiters not supported Product Specification Notes E 8 Index Index A AIXTerm Emulation Specification E 2 Block Mode Cursor positioning 4 2 Border Width 8 12 BQ 3107 Emulation Specification E 2 Character Sets D 1 Controlcharacters D 1 IBM 5250 D 2 Colour Attributes menu 6 21 Background 6 21 8 16 Foreground text 6 21 8 16 Textattributes 6 21 Textcursor 8 16 Command Line Options Background colour 8 16 Bell volume 8 8 Closed telnet exits TeemTalk 8 11 Cursor line selection extent 8 8 Cut paste EOL character 8 8 Debug mode 8 6 Font selection 8 17 Foreground text colour 8 16 Format 8 2 Host telnet port number 8 10 IBM reply mode 8 8 Initiate telnetsession 8 10 Input queue size 8 7 Introduction 8 1 Maximize window on loading 8 12 Menu bar display 8 14 Menuenable disable 8 14 Mouse button multi click time 8 7 Mouse cursor style 8 15 Prevent message display 8 7 Resource file selection 8 5 Resource specification 8 6 Server for display amp input 8 5 Setup file selection 8 6 Soft button display 8 15 String sent onexit 8 9 Summary 8 3 Sync signal frequency 8 5 Telnet close option 8 11 Telnet dialog not displayed on startup 8 10 Telnetkeepalive messages 8 11 Textcursorcolour 8 16 Text lines displayed 8 13 Title for window amp icon 8 12 Window border width 8 12 Window size amp location 8 12 Control Characters D 1 Ke
102. utton All colour attributes will be temporarily removed from the display and the hotspots will be highlighted with a red background Releasing the keys will return the display to its original state For information on defining hotspots refer to the Hotspots chapter Send Keyword The Send Keyword function enables you to click on any delimited word displayed on the screen and it will be sent to the host as long as the word is not already defined as a hotspot Keyword delimiters are the same as for hotspots that is space NULL Redefining The Mouse Buttons TeemTalk enables you to redefine the functions assigned to the mouse buttons via the Mouse Button Actions dialog box which is displayed from the Settings menu TeemTalk Mouse Button Actions Koraal Select gt Edit Paste El Extend Selection gt Shift Select Rectangle gt Edit Paste Extend Selection gt Control Hove Cursor is fiction Hotspots El Show Hotspots gt Ctrl shift Select Graphics Paste Graphics gt Send Keyword gt Alt Unassigned gt Unassigned ES Unassigned gt 0K Cancel This enables you to specify the function of mouse buttons 1 2 3 when they pressed on their own or in conjunction with modifier keys You can assign up to five functions to each button Clicking one of the arrow buttons will display a drop down list box which lists all the standard functions
103. voz r N lt x lt o Cc NI ND za Legend RSP required space SHY syllable hyphen SP space Product Specification Product Specification This appendix describes the level of support provided by each terminal emulation Introduction The following sections describe the level of support provided by each terminal emulation throughout the product range Note that your product version may not support all the terminal emulations listed here General Limitations Key click not supported Badge and Magnetic Card reader support are supported via Wedged data devices connected to the unit s keyboard No downloadable program module The keyboard layouts may differ but substantially provide the same capabilities as the native terminal No screensavers File Transfer protocols not supported on embedded products thin clients API s not supported on embedded products thin clients Smooth Scroll and Variable Scroll rates not supported No graphics or APA graphics Product Specification Telnet Specification Implements RFC 854 855 856 857 858 860 1091 1408 1571 1572 Implements RFC 1205 2877 for IBM 5250 Implements RFC 2355 1576 1646 1647 for IBM 3270 AixTerm Limitations No Vertical tab stops No Select Alternate presentation variant No Select reversed string No S
104. w the File pulldown menu the Settings pulldown menu the decrease menu button the increase menu button the Telnet dialog box the Telnet Options dialog box the Telnet 5250 Options dialog box the Text Printer dialog box the Print Screen function the Mode Settings dialog box the IBM 5250 Settings dialog box the Macros Settings dialog box the Attributes Settings dialog box the Mouse Button Actions dialog box The following object names correspond to the various buttons in the pulldown menus File Factory File Reset File Save File Open Telnet File Close Telnet File PrinterSettings File Print File Quit Settings Emulation Settings IBM5250 Settings Macros Settings Attributes Settings Mouse As the menus can be uniquely identified total control can be exerted over various attributes within the setup entries For example you can specify the colour font and whether the menus are enabled or disabled Regretably you will need to be armed with an X Window programmer s manual to fully identify the scores of resource names that are available within menu systems 8 19 Resources amp Command Line Options Where To Specify Resource Entries When an X application is started resource preference strings from a variety of places are merged together to create one large resource database for that application which is then processed when it is started Clearly since preferences can be specified in more
105. wn or in conjunction with modifier keys You can assign up to five functions for each button Clicking one of the arrow buttons will display a drop down list box which lists all the standard functions that can be assigned Unassigned Select Extend Selection Edit Paste Show Hotspots Action Hotspots Move Cursor Send CR Send Keyword Select Graphics Paste Graphics Select Rectangle Cursor Select Most of these settings are self explanatory The Select function will select all text from the start position to the finish position working left to right across the entire width of the display whereas the Select Rectangle function will only select text contained within the rectangular area defined by the start position top left corner and the finish position bottom right corner 6 23 Setup Menus The Show Hotspots and Action Hotspots functions are described in the Hotspots chapter The Send Keyword function is very similar to the hotspot feature It enables you to send delimited text displayed on the screen to the host just by clicking on it Delimiters are the same as for hotspots The Move Cursor function can be used in any of the local block modes as a quick way of positioning the text cursor within a block of text Move the mouse cursor to the position where the text cursor is required then click the mouse button and key combination assigned with the Move Cursor function to cause the text cursor to jump to that location
106. y when the telnet session is closed See the Telnet Close Option section also Telnet Close Option Resource xteemx320 tnClose 0 3 Command Line tnclose 0 3 Default Setting 0 This command specifies the action to be taken when a telnet session is closed if tnexit is not specified The possible settings are as follows 0 Display message box for option required 1 Exit TeemTalk 2 Reconnect automatically to the same host 3 Cancel telnet connection only This will also be effective for telnet connection failure 8 11 Resources amp Command Line Options Display Format Window Maximized When Loaded Resource xteemx320 maXimized on Command Line ma These commands will cause the window to be displayed at the maximum size possible when TeemTalk is loaded while retaining the default number of lines and columns and including all window elements if enabled title bar soft buttons etc Window amp Icon Titles Resource xteemx320 title title CommandLine title title Default Setting xteemx320 These commands enable you to specify the title to be displayed by the window manager in the TeemTalk window title bar or icon This is useful for distinguishing each instance of TeemTalk when it is being run multiple times Window Border Width Resource xteemx320 internalBorder width Command Line bw width Default Setting 1 pixel These commands enable you to specify the pixel width of the border sur
107. yboard equivalents D 1 Copy amp Paste EOLcharacter 8 8 Index 1 Index Graphic screen area 4 2 Using mouse 4 1 Cursor Mouse cursor style 8 15 Positioning in block mode 4 2 D Debug Mode 8 6 For key identification 3 1 DEC VT Emulations Specification E 3 Default Setup Settings 6 3 DG 410 412 Emulation Specification E 3 Display Hotspots 5 1 Languageselection 6 14 Maximized on loading 8 12 Menu bar enable disable 8 14 Menuenable disable 8 14 Soft buttons 2 4 Textattributes 6 21 Window size amp location 8 12 E Emulation Settings 6 15 Emulation Support Level E 1 Enhanced AT Keyboard Mapping IBM 5250 functions 7 4 F Factory Default Setup 6 4 File Menu 6 4 Fonts Default 8 17 Loading 8 17 Selecting 8 17 G Getting Started Keyboard operation 3 1 Using window elements 2 3 Graphic Copy amp Paste 4 2 H Help Menu 6 25 Host Communications Telnetconnection 2 1 Hotspots Defining 5 2 Displaying all 5 1 Using 5 1 HP 700 92 96 Emulation Specification E 3 IBM 3151 Emulation Specification E 4 IBM 3270 Emulation Specification E 3 IBM 5250 Emulation Character sets Austrian D 6 Belgian D 10 Canadian bilingual D 2 Danish D 4 English UK D 3 English US D 2 Finnish D 9 French D 5 German D 6 Italian D 7 Netherlands D 2 Norwegian D 4 Spanish D 8 Swedish D 9 Swiss French D 10 Swiss German D 10 Displayrule 6 17 Index 2 Index Fax image support 7 7 Introduction
108. yed Command line example xteemx320 g 320x240 50 75 This will cause a window 320 pixels wide and 240 pixels high to be offset 50 pixels from the left of the display and 75 pixels from the bottom of the display It is recommended that the window size is specified using the Window Size Col umns Lines commands described in the next section rather than geometry Text Lines Displayed When TeemTalk Loaded Resource xteemx320 defaultLines number of lines Command Line dl number of lines Default Setting 24 with status line on 25th line These commands specify the number of text lines displayed in the window when TeemTalk is loaded 8 13 Resources amp Command Line Options Window Elements In addition to the following commands the section entitled Object Names Available In TeemTalk towards the end of this chapter lists the names given to various elements of the window which can be used to specify whether or not they are enabled and how they are displayed using standard X resource commands Menu Bar Resource xteemx320 topmenuBar on off Command Line mb enables the menu bar mb disables the menu bar Default Setting on These commands determine whether or not a menu bar is displayed You can enable disable individual items in the menu bar by using the following resources xteemx320 file sensitive true false xteemx320 settings sensitive true false xteemx320 lt sensitive true false xteemx320 gt sens

TeemTalk for Unix User's Guide v 5.0

Contents

Download Pdf Manuals

Related Search

Related Contents