Page 4
DEC, VT52, VT100, VT131, VT220, VT300, VT320, VT340, VT420, ReGIS, DECnet, LK250 and LK450 are registered trademarks of Digital Equipment Corporation. Ethernet is a registered trademark of Xerox Corporation. Hazeltine is a trademark of Esprit Systems, Inc. HP700/92, HP2392A and HP2622A are trademarks of Hewlett Packard Company.
Introduction Introduction This chapter introduces TeemTalk terminal emulation software for Microsoft Windows and the contents of this User's Guide. What Is TeemTalk? TeemTalk for Windows provides precise emulation of a wide range of industry standard text and graphics terminals on any PC running Microsoft Windows. Multiple concurrent sessions with different hosts can be conducted over serial RS232 lines or local area networks (LANs) including DECnet, TCP/IP and Novell.
Introduction About This User's Guide This User's Guide describes how to use TeemTalk-05W, TeemTalk-07W and TeemTalk-11W version 4.3.1 for Windows 3.1x, 95 and NT. The information contained in the following chapters applies equally to TeemTalk-05W, TeemTalk- 07W and TeemTalk-11W unless indicated otherwise.
Page 13
Chapter 9: ICL FTF File Transfer Describes the ICL FTF file transfer utility supported by TeemTalk for Windows 3.1x in all terminal emulation modes. Chapter 10: FTP File Transfer Describes the FTP interface for file transfer across Windows Sockets based networks. Chapter 11: Initialization Commands Describes commands that can be included in the initialization file and on the command line to specify the loading...
TT07W in filenames and commands apply to TeemTalk-07W and TeemTalk-07W32 and, unless indicated otherwise, should be substituted with TT05W if you are using TeemTalk-05W or TeemTalk-05W32, or TT11W if you are using TeemTalk-11W or TeemTalk-11W32. 3. An asterisk in a filename or directory name must be substituted with the number indicating the version of your TeemTalk software unless specified otherwise.
This chapter describes how to run TeemTalk and configure it for compatibility with your hardware and the application. Running TeemTalk To run TeemTalk, display the TeemTalk group window (or the window you specified when installing the software) and select the icon shown below. Mouse: Double-click the TT05W, TT07W or TT11W icon.
Page 16
Getting Started Quitting using the Control menu: Mouse: If the window is displayed, click the box or icon in the top left corner of the window to display the Control menu, then click the Close option. If the window is iconized, click the icon to display the Control menu then click the Close option.
Host Communications Creating A Communications Session When TeemTalk is loaded for the first time, a dialog box will be displayed which enables you to configure TeemTalk for a serial or network host connection. Note: If you do not wish to make a host connection at this moment, just click the Cancel button to close the dialog box.
Getting Started Note: The options in this dialog box are described in the Serial Settings section in the Setup Menus chapter and only apply when the connection type is set to Serial. The status bar along the bottom of the TeemTalk window displays two LEDs. The first LED indicates whether or not you are connected to the host.
Page 19
Getting Started The Services list box (in the New Connection dialog box) will display the devices on the network which use the currently selected protocol. Click the name of the device required or, in the case of TELAPI, enter an Internet address in the text box (for example, 128.127.126.2).
Getting Started Creating A Connection Template You can save the current session configuration as a connection template. To make TeemTalk automatically attempt to make a host connection using the same settings the next time it is loaded, click the File option in the menu bar to display the File menu, then click the Save Session option.
5. In the Description text box, enter a unique description (up to 132 characters long) which will be used to identify the connection template for future selection. This description will also appear in the Open Session dialog box. 6. Click the OK button to save the template settings. If you specified the names of settings files that already exist, a message box will ask you to confirm whether or not you want to overwrite the existing files with the new settings.
Page 22
Getting Started connection template currently in use is highlighted. The factory default connection template is Untitled. Clicking one of the descriptions then the OK button will cause TeemTalk to use the connection template associated with the chosen description. You can make TeemTalk automatically use a particular connection template when it is loaded or reset by clicking the required description, checking the Save As Default check box, then clicking the OK button.
Selecting The Terminal Emulation When you load TeemTalk for the first time, the DEC VT100 emulation will be running by default. All the terminal emulations supported by TeemTalk can be accessed from the Emulation Settings dialog box. This is displayed by selecting Settings in the menu bar then Emulation...
Getting Started D. Insert/Replace character mode is set to Replace. E. Keys PF1 through PF4 generate ANSI cursor movement se- quences. F. All programmed strings for keys are temporarily disabled. VT220-7 and VT220-8 modes are emulations of the DEC VT220 terminal, the difference is in their treatment of 8-bit control codes.
Bitpad-Plus Calcomp Mouse Click the button next to the Tablet Type required then specify the Serial Port Device to which the Gin device is attached. You can save these settings so that TeemTalk will automatically assert them when loaded or reset by clicking the Save Session option in the File menu.
Getting Started The TeemTalk Display The TeemTalk window incorporates several special facilities in addition to the standard facilities supported by Microsoft Windows. The illustration below shows the various elements of the window which are described in the following sections. The Title Bar The title bar displays the name of your version of TeemTalk software (title), the name of the session currently running (subtitle) in brackets, and an indication of the current host connection (host name, IP address or COM port).
The Minimize & Maximize Buttons These buttons are used by the mouse to shrink the window to an icon or increase the window to the maximum size possible while still displaying the number of lines and columns specified in setup, the default setting being 80 columns by 32 lines. (The equivalent keyboard functions are enabled via the Control menu).
Getting Started When you display a menu and move the cursor over the menu options, the status bar at the bottom of the window will change to display a brief description of the option at the cursor position. Refer to the Setup Menus chapter for a complete discussion on selecting and using the options in these menus.
To resize the window: Mouse: Click the pointer over the << or >> commands. Keyboard: Hold down the Alt key and press the key bearing the underscored character in one of the menu titles, for example, Alt + F. Press the right arrow key to move the highlight over <<...
Getting Started The Scroll Bar The scroll bar enables you to display alphanumeric data that is above or below the view of the dialog area. The dialog area is a 'window' into the dialog buffer which is used to store alphanumeric data. The dialog area may fill the entire emulation workspace or consist of only two lines.
Page 31
Z together.) Refer to the Primary Setup Mode section earlier in this chapter for more details. Zoom (Not supported by TeemTalk-05W.) This will activate the zoom/pan feature. When the pointer is moved into the emulation workspace it will change into the zoom cursor, which appears as a two-way arrow. Click the left mouse button to select that location as the centre of the area to be zoomed.
Page 32
RstView repeatedly will recall these views in sequence. ViewUp (Not supported by TeemTalk-05W.) This will save the state of the current view then make the next higher numbered view the current view. ViewDn (Not supported by TeemTalk-05W.) This will save the state of the current view then make the next lower numbered view the current view.
Dithered fill patterns are numbered 50 to 174, left to right, top to bottom, as follows: Row 1: 50 to 65 Row 2: 66 to 81 Row 3: 82 to 97 Row 4: 98 to 114 Print This will display a dialog box which enables you to produce a hardcopy of data displayed on the screen in a specified format.
Getting Started Field 5: Indicates the status of the printer as follows: None signifies that the printer is not turned on or not connected, or not installed in Microsoft Windows. Not Ready signifies that the printer is not ready to receive data for printing.
Getting Started The Emulation Workspace The emulation workspace is the area which emulates the display of the terminal specified in setup (the VT100 terminal by default) and where work is carried out with an application. Refer to the section entitled Selecting The Terminal Emulation earlier in this chapter for details on how to change the emulation.
Getting Started The Text Cursor The text cursor is a flashing block or underline character which indicates the position at which the next displayable character received from the host or entered by the keyboard will be displayed. The type of text cursor displayed can be selected by the Cursor Style option in the Dialog Settings dialog box.
The Gin Cursor The Gin (Graphics Input) cursor is a small crosshair cursor which is used to make selections and specify locations in the graphics area. The Gin cursor can be steered using the mouse or cursor keys. You can change the size of the cursor by using the following initialization file command or command line option, where size is a numeric value in the range 1 to 4096 (i.e.
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. The illustrations on the following pages show how the 83/84 key AT, 101/102 key Enhanced AT and DEC LK250/450 keyboard layouts are mapped in DEC VT100, VT220, Edit and Tek modes.
Page 40
Keyboard Configuration AT Keyboard Layout DEC VT220 Mode Mapping...
Keyboard Configuration DEC LK250 Keyboard Drivers TeemTalk for Windows 3.1x does not supply its own drivers for the LK250 keyboard, it relies on using the drivers supplied by Digital on the Pathworks PCSA distribution disk. If Pathworks has not been installed with the LK250 option then the following modifications should be made to the SYSTEM.INI file in the WINDOWS directory on the basis that the drivers and associated files are available: SYSTEM.INI:-...
2) Although the alphanumeric area of the keyboard may appear to function, the keypad, function keys and centre key cluster will not operate correctly, giving unpredictable results. Note: The LK250 keyboard for the PC is designed to operate in 2 modes.
Keyboard Configuration To enable the cursor keys permanently so that the Alt key does not have to be held down when you want to use them, press the keys Alt + Num Lock together so that the Num Lock indicator is not lit. To make the cursor keys generate their numeric values again, press Alt + Num Lock.
Page 49
Keyboard Configuration You can show how TeemTalk has mapped your keyboard within the current terminal emulation mode by setting the Keyboard Action option (between the two layouts) to Show Map, then moving the pointer over a key in the lower layout and holding down the left mouse button.
Keyboard Configuration The Predefined Macros option at the bottom of this dialog box enables you to select from a list of standard functions associated with the current terminal emulation. Clicking the arrow button will display a list box in which the names of valid key functions (called virtual key names) are shown.
Keyboard Configuration All keyboard macros can be saved so that TeemTalk will reassert them each time it is loaded or reset by displaying the Save Session As dialog box from the File menu, selecting the Keyboard Macros option, then clicking the OK button. Entering Control Characters You can enter a control character either as the control key character equivalent or the decimal value of the ASCII character.
Keyboard Configuration For example, to program the A key so that when it is pressed it performs the same function as pressing the keys F2 then F3 then F4 enter the following characters in the relevant text box: <F2><F3><F4> Entering Command Lines You can enter a command line in a key definition by enclosing it within the ( and ) characters.
Keyboard Configuration Default Key Definitions The default definition of a specific key may be reasserted by clicking the Default button in the Define Key Macro dialog box for that key. The default definition of the entire keyboard may be reasserted by clicking the Default button in the Keyboard Macros dialog box.
Keyboard Configuration Compose Character Sequences Compose character sequences can be used to generate codes for characters not shown on your keyboard when you are in VT220 mode. The characters that can be composed depend on the setting of the Multinational option in the Emulation Settings dialog box.
Page 55
COMPOSE CHARACTER SEQUENCES " ¨ space quotation mark number sign ' space apostrophe commercial at (Multinational) (National) opening bracket back slash closing bracket circumflex ^ space accent ` space grave accent opening brace vertical line closing brace ~ space tilde ¡...
Page 56
Keyboard Configuration COMPOSE CHARACTER SEQUENCES (continued) Ä A umlaut Å A ring Æ A E diphthong Ç C cedilla È E grave É E acute Ê E circumflex Ë E umlaut Ì I grave Í I acute Î I circumflex Ï...
Page 57
COMPOSE CHARACTER SEQUENCES (continued) ó o acute ô o circumflex õ o tilde ö o " o umlaut o e diphthong œ (DEC Multinat.) (in order) ø o slash ù u grave ú u acute û u circumflex ü ¨ o u umlaut ÿ...
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 six functions when pressed in conjunction with modifier keys. The following table lists the functions assigned to each button and key combination by default.
Page 60
Mouse Functions The following functions can be assigned: Unassigned Select Extend Selection Edit Copy Edit Paste Show Hotspots Action Hotspot Move Cursor 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.
Selecting & 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, Select Rectangle, Select and Copy or Select Word 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 contained within the rectangular area defined...
Mouse Functions 2-Button Mouse Emulating 3-Button You can assign the function of the middle button found on a three button mouse to any button or button and key combination. The Mouse Button Actions dialog box includes a Middle Button setting for this purpose. Show &...
The Toolbar The Toolbar This chapter describes how to use and redefine the toolbar and associ- ated floating button palette. Using The Toolbar The toolbar and associated floating button palette provide a quick way of actioning commands or displaying setup dialog boxes by just clicking a button. TeemTalk displays a toolbar below the menu bar by default.
The Toolbar The floating button palette contains the same buttons as the toolbar. You can move and resize the palette in the same way as any other window. To convert the floating button palette back into the toolbar, click the control menu box at the top left corner of the palette window and select Attach.
Page 65
The Toolbar Displays the Print Screen dialog box for producing a hardcopy of screen data in a particular format. Displays the Attributes dialog box. This enables you to specify the colours used in the dialog area and how text with attributes is displayed.
Page 66
The Toolbar Erases the contents of the dialog area and buffer. Toggles dialog area visibility on and off. Activates the zoom/pan feature (except TeemTalk-05W and TeemTalk-05W32).
The Toolbar Redefining The Toolbar Clicking the last button in the default toolbar, or selecting Button Tools from the Settings menu will display a dialog box which enables you to redefine the toolbar. Up to 64 button tools can be defined, all of which can be displayed in the floating button palette but only one row of buttons can be displayed in the toolbar.
The Toolbar You are not restricted to the set of predefined button bitmaps displayed in the Buttons list box. You can add your own customised buttons to the bottom of the list by clicking the Add Custom... button. This will display the Load Custom Bitmap dialog box which enables you to select a bitmap file from which a button will be automatically generated.
Page 69
The Toolbar Key Combinations & Sequences You can program a button tool to perform the function of a combination or sequence of keys. For example, you can cause a button to perform the same function as 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.
The Toolbar Initiating A Script File You can program a button to run a script file when pressed by enclosing the name of the file and any arguments within the <' (left angle bracket and single quote) and '> (single quote and right angle bracket) characters. For example, to program a button so that it will run the script file myscript.scr and assign the values value1 and value2 to two variables, you would enter the following: <'myscript.scr(value1,value2)'>...
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.
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 workspace file but with the extension .hot instead of .wsp. For example, the default hotspot definitions supplied with TeemTalk-07W32 are stored in the file tt07w.hot.
Page 73
Hotspots definitions file. Note that a keyword definition under a [Definitions,<emulation>] 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.
Page 74
Hotspots together with + characters and ending with the > 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=<ALT+F4>...
Setup Menus Setup Menus This chapter describes the options available in the setup menus and dialog boxes. Selecting & Closing Menus The following menus can be displayed from the menu bar:...
Setup Menus To display a menu: Mouse: Click the title of the menu required. Keyboard: Hold down the Alt key and press the key bearing the underlined character in the menu title. For example, pressing Alt + F will display the File menu.
To select a menu option: Mouse: Click the menu option. Keyboard: Method 1: If the option includes an underlined character, press the key bearing that character. For example, pressing X while the File menu is displayed will cause TeemTalk to shut down. Method 2: Use the up or down arrow keys to highlight the option required then hit Return.
Setup Menus When an option has many possible settings, these will be shown in a list box. The Baud Rate option in the Serial Settings dialog box is an example of this. To make a selection using the mouse, click the arrow button to display a drop-down list box then click on the setting required.
Creating A Connection Template You can save the current session configuration as a connection template. To make TeemTalk automatically attempt to make a host connection using the same settings the next time it is loaded, display the File menu and select the Save Session option. TeemTalk enables you to create multiple connection templates, any one of which can be used either when TeemTalk is loaded or while it is running.
Setup Menus 5. In the Description text box, enter a unique description (up to 132 characters long) which will be used to identify the connection template for future selection. This description will also appear in the Open Session dialog box. 6.
Setup Menus Selecting A Connection Template The Open Session dialog box in the File menu enables you to select a connection template for TeemTalk to use. The Description list box displays the one-line descriptions of connection templates that were created using the Save Session As dialog box. The description of the connection template currently in use is highlighted.
Setup Menus Menu Descriptions The following pages describe the options 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.
Reset Terminal This will reset the current terminal emulation mode. New Connection... Factory default: Serial, Com 1 This will display a dialog box which enables you to make a serial or network host connection. The Type option specifies whether a serial or network connection is to be made. Clicking the arrow button will display a drop-down list box containing all the possible settings.
Page 84
Setup Menus The status line along the bottom of the window displays two LEDs. The first LED indicates whether or not you are connected to the host. It will show red when not connected and green when you are connected. The second LED indicates whether or not data is being sent to or from the host.
Setup Menus The status line along the bottom of the window displays two LEDs. The first LED indicates whether or not you are connected to the host. It will show red when not connected and green when you are connected. The second LED indicates whether or not data is being sent to or from the host.
Setup Menus Save Session Selecting this option will cause the current session configuration to be saved to the connection template specified in the Save Session As dialog box. Save Session As... This will display a dialog box which enables you to save the current session configuration as a connection template.
4. In the Description text box, enter a unique description (up to 132 characters long) which will be used to identify the connection template for future selection. This description will also appear in the Open Session dialog box. 5. Click the OK button to save the template settings. If you specified the names of settings files that already exist, a message box will ask you to confirm whether or not you want to overwrite the existing files with the new settings.
Setup Menus Replay File... Factory default: *.* This option will display a dialog box which enables you to replay the contents of a file previously created by the Capture File... option. Enter the name of the file to be replayed in the Replay File Name text box, or alternatively select a file name in the list box below, specify whether the replay is directed to the emulation (default) or host, then click the OK button.
Page 89
The currently selected printer is the TeemTalk default printer if specified, or the printer specified in the Control panel, when the dialog box is displayed for the first time after TeemTalk is loaded or reset, otherwise it is the printer that was last used. Selecting a printer other than the default printer will enable the Save New Default option.
Page 90
Setup Menus The Text option is selected by default and the printer resolution and scaling options are not accessible. Clicking the OK button with Text selected will cause a fast print of the screen using ASCII text codes, therefore any graphics displayed in the TeemTalk client area will not be printed.
Page 91
Setup Menus These options allow you to print the graphics image as displayed (Normal by default), with black and white reversed, with colour converted to monochrome, or colour converted to monochrome with black and white reversed. Once a screen print is initiated by clicking OK, another dialog box will be displayed while the screen data is being spooled out to the print manager.
Page 92
Setup Menus The Parameters text box enables you to specify the values of ArgV# type variables within the script file, if required. Values are separated from each other by a comma. You must ensure that the values are entered in the right order so that they are assigned to the correct variables.
Telnet Options This dialog box is displayed when you click the Telnet Options button in the New Connection dialog box when any Telnet protocol is selected in the Type list box. Note that the options available and the default settings depend on the current terminal emulation.
Page 94
Setup Menus Force Negotiation These settings determine whether or not the Telnet Binary or EOR options are supported. Both are set to no by default. Will not force any negotiations. It will leave it up to the host to decide what to do. Will force negotiation.
Setup Menus Edit Menu Clipboard Text Clipboard Graphics Selecting one of these options will enable selected text or graphics to be copied to the clipboard when the Copy command is used. The Paste and Select All commands will also be enabled. A tick will be displayed next to the option when it is selected and the DDE commands will be disabled.
Page 96
Setup Menus Copy This command becomes available (ungreyed) when data has been selected. The function of this command is determined by whether the Clipboard Text, Clipboard Graphics, DDE Row Copy or DDE Column Copy option is selected. When the Clipboard Text or Clipboard Graphics option is selected, this command will cause currently selected text or graphics to be copied to the clipboard.
Page 97
current cursor position. The same block of data may be pasted repeatedly as the clipboard stores it until the Copy command is used again. Note: The same function can be performed by clicking the right mouse button on a 3-button mouse, or Shift + Left or Right Button on a 2-button mouse, or by pressing the keys Shift + Insert.
Setup Menus Settings Menu The following dialog boxes can be displayed from this menu: Emulation Settings Serial Settings Terminal Settings Dialog Settings Gin Settings Attributes Keyboard Macros Soft Buttons Mouse Button Actions Button Tools 7-24 - for specifying the terminal emulation, terminal identity and displayable characters.
Emulation Settings This dialog box is displayed by selecting Emulation in the Settings menu. Emulation Factory default: VT100 The setting of this option determines the current terminal emulation mode. VT52 and VT100 modes enable you to run applications written for the DEC VT52 and VT100 terminals, respectively.
Page 100
Setup Menus VT220-7 and VT220-8 modes run emulations of the DEC VT220 terminal, the difference is in their treatment of 8-bit control codes. When VT220-7 is selected, all 8-bit codes are converted to their 7-bit equivalents, whereas VT220-8 leaves 8-bit codes unchanged.
Serial Settings This dialog box is displayed by selecting Serial in the Settings menu, or by clicking the Configure... button in the New Connection dialog box when the connection type is set to Serial or Interrupt 14. Note that the port for serial communications is selected via the New Connection dialog box which is displayed from the File menu.
Page 102
Setup Menus In/Out Hardware - DTR/CTS hardware flow control. Data Bits Factory default: 8 This option specifies the number of data bits sent for each transmitted character. Stop Bits Factory default: 1 This specifies the number of stop bits sent for each transmitted character. Transmit Rate Factory default: Unlimited The setting of this option determines the maximum effective baud rate that TeemTalk...
Setup Menus NCSI Settings This TeemTalk for Windows 3.1x dialog box is displayed by clicking the Configure... button in the New Connection dialog box when the connection type is set to Extended NCSI. Baud Rate Factory default: 9600 This specifies the transmit and receive baud rates in the range 50 to 115200 baud. Parity Factory default: None This option specifies the parity mode for each transmitted character.
Page 104
Setup Menus Data Bits Factory default: 8 This option specifies the number of data bits sent for each transmitted character. Stop Bits Factory default: 1 This specifies the number of stop bits sent for each transmitted character. Show Port Details Factory default: Unselected By default the Services list box will show the server name and general service (e.g.
Setup Menus Terminal Settings This dialog box is displayed by selecting Terminal in the Settings menu. Keyboard Language 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.
Page 106
Setup Menus CR Implies LF Factory default: Unselected When selected, this will cause TeemTalk to interpret each carriage return character it receives as a carriage return and line feed pair. Ignore Deletes Factory default: Unselected The setting of this option determines whether TeemTalk ignores or actions delete characters received from the host.
Setup Menus Report Maximum Line Length Factory default: 0 The setting of this option determines the maximum number of characters per line for reports sent to the host. The numeric value must be in the range 0 through 65535. This feature is disabled if 0 is specified. Bypass Cancel Character Factory default: ^J (LF) This option sets the bypass mode cancellation character.
Setup Menus End Of Message Characters Factory default: ^M (CR) and ^J (LF) This option is used to specify up to two ASCII characters in the decimal range 0 through 127 which are sent by TeemTalk to end a line of data transmission. To change the current definition, delete the definition displayed in the text box and type in the new one, either as the control key character equivalent or the decimal value of the ASCII character.
Setup Menus Dialog Settings This dialog box is displayed by selecting Dialog in the Settings menu. Burst Scroll Factory default: Unselected The setting of this option determines whether data is scrolled one or several lines at a time when the window becomes full. Data will scroll up several lines at a time when this is selected.
Setup Menus Dialog Area Visible Factory default: Selected This option enables you to make the dialog area visible or invisible. Cursor Origin Factory default: Relative The setting of this option defines the relationship between the cursor position and the emulation workspace. When this option is set to Absolute, the cursor position is calculated using the first column and row of the emulation workspace as its origin, so allowing addressing outside the current text scrolling region.
Page 111
Setup Menus window. The window size will be adjusted accordingly. Note that the number of text rows actually used for displaying dialog area text is determined by the setting of the Dialog Area Lines option. Dialog Area Lines Factory default: 32 This option defines how many lines of the dialog buffer are visible on the screen in the dialog area.
Setup Menus Gin Settings This dialog box is displayed by selecting Gin in the Settings menu. Tablet Type Factory default: MM1201 This option specifies the graphics input device that is attached to your system and the data format that TeemTalk uses to communicate with it. TeemTalk incorporates several tablet drivers.
Setup Menus Gin Tablet Characters Factory default: Z123 This option specifies the characters sent by the buttons on the mouse or tablet puck for Gin pick and locate operations. The setting must consist of four characters or no characters. For a mouse which only has three buttons, the first character is ignored and subsequent characters correspond to the left, middle and right buttons.
Setup Menus Attributes This dialog box is displayed by selecting Attributes in the Settings menu. It enables you to specify the colours used in the dialog area 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 (BD) for characters with the bold attribute.
Page 115
Foreground and Background colour palettes. For default display, deselect this option. Swap Black/White Factory default: Unselected This option is not applicable to TeemTalk-05W, -07W or -11W and will therefore be unselectable. Inverse Colours Factory default: Unselected When this option is selected, characters with the inverse attribute will have the text (foreground) colour swapped with that of the text cell (background).
Page 116
Setup Menus Colours Cleared With Attributes Factory default: Unselected This option is not applicable to TeemTalk-05W, -07W or -11W and will therefore be unselectable. Attributes Use Normal BG Factory default: Unselected This option is not applicable to TeemTalk-05W, -07W or -11W and will therefore be unselectable.
Page 117
Setup Menus Visual Method The full range of colours available is displayed in the large colour selection box. A target cursor is positioned over the currently selected colour. To select a new colour you can either click the mouse pointer over the colour required or drag the target cursor over it.
Setup Menus Keyboard Macros This dialog box is displayed by selecting Keyboard Macros in the Settings menu. The Keyboard Macros dialog box enables you to redefine the function of most of the keys on your keyboard and shows the mapping of the keyboard for the current terminal emulation mode.
Page 119
Setup Menus Show Map, then moving the pointer over a key in the lower layout and holding down the left mouse button. The key or key combination which emulate the function of the key you are currently pressing will be displayed in the upper layout as if pressed in. Note: Control key functions are not shown.
Page 120
Setup Menus The Predefined Macros option at the bottom of this dialog box enables you to select from a list of standard functions associated with the current terminal emulation. Clicking the arrow button will display a list box in which the names of valid key functions (called virtual key names) are shown.
Page 121
Setup Menus All keyboard macros can be saved so that TeemTalk will reassert them each time it is loaded or reset by displaying the Save Session As dialog box from the File menu, selecting the Keyboard Macros option, then clicking the OK button. Entering Control Characters You can enter a control character either as the control key character equivalent or the decimal value of the ASCII character.
Page 122
Setup Menus Entering Command Lines You can enter a command line in a key definition by enclosing it within the ( and ) characters. This enables you to launch an application by just pressing a key. For example, to program the F1 key so that another instance of TeemTalk-07W is run when the key is pressed, you would enter the following in the relevant text box: (C:\TEEMTALK\TT07W.EXE) Changing The Window Focus...
Setup Menus Euro Sign TeemTalk enables you to generate the euro sign from the keyboard by pressing the keys Alt + 4 by default. TeemTalk also provides a cross-mapping mechanism to allow any unused character symbols or string to be cross-mapped to display the euro. This means, for instance, that a host application needing to display the euro could be adjusted to send an unused character or character string, which TeemTalk would convert to the euro symbol.
Setup Menus Soft Buttons This dialog box is displayed by selecting Soft Buttons in the Settings menu. A set of soft buttons is displayed at the bottom of the TeemTalk window by default. These can be programmed so that they perform various functions when clicked. The soft button display can be switched on or off using the Visible check box.
Page 125
Getting Started chapter. You can redefine these buttons to perfrom other functions if required. Note that the Tek functions assigned to buttons 6 through 10 by default are not supported by TeemTalk-05W. Programming A Soft Button To program a soft button, first select which level or definition set of buttons you wish to define by selecting the level number in the Level box below the Apply button.
Page 126
Setup Menus Key Combinations & Sequences You can program a soft button to perform the function of a combination or sequence of keys. For example, you can cause a button to perform the same function as 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.
Page 127
Setup Menus when the button is clicked, you would enter the following in the B4 Command text box: <"tt07w"> (tt07w is the window class name for TeemTalk-07W.) Initiating A Script File You can program a soft button to run a script file when pressed by enclosing the name of the file and any arguments within the <' (left angle bracket and single quote) and '>...
Setup Menus Mouse Button Actions This dialog box is displayed by selecting Mouse Button Action in the Settings menu. This enables you to specify the function of the left and right mouse buttons when they are pressed on their own or in conjunction with modifier keys. You can assign up to six functions to each button.
Page 129
Setup Menus 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.
Setup Menus Button Tools This dialog box is displayed by selecting Button Tools in the Settings menu. This enables you to redefine the button tools displayed in the toolbar or floating button palette. Up to 64 buttons can be defined. For a complete description of how to use the toolbar and floating button palette, refer to the chapter entitled The Toolbar.
Page 131
Setup Menus Specify the name of the bitmap file to use then click the OK button. The dialog box will close and you will see the new button bitmap highlighted at the bottom of the Buttons list box. If you want to delete a custom button from the Buttons list box, select the button bitmap then click the Delete Custom button.
Setup Menus Help Menu Help Contents Selecting this option will display a help window listing the contents of help for TeemTalk. Clicking an underlined topic or pressing Tab to highlight the topic then pressing Enter will cause the window to display information on that topic. Text that has a continuous underline will cause another topic to be displayed when clicked, while text with a dotted underline will display a small temporary window with a description of the term.
This chapter describes how to transfer files using the Kermit, XMODEM, XMODEM-1K, YMODEM Batch, ZMODEM and ASCII protocols. Introduction TeemTalk includes a file transfer utility which enables two-way file transfer between the host and your PC. A range of file transfer protocols are supported to provide compatibility with virtually any host computer.
Page 134
File Transfer YMODEM Batch YMODEM Batch is similar to XMODEM-1K, but enables several files to be transferred. It checks for errors using a cycling redundancy check only. ZMODEM ZMODEM is an advanced development of YMODEM which enables much faster multiple file transfer with enhanced error detection and aborted transfer resumption. The zmodemStartup initialization command or -zm command line option can be used to make TeemTalk check incoming data for a remote ZMODEM startup sequence then automatically start a file transfer.
Sending Files The following procedure is used to transfer files from your PC to the host. 1. Start the transfer procedure on the host computer and specify that files are to be received. 2. Display the TeemTalk File menu on your PC and select File Transfer...
Page 136
File Transfer 7. Specify the directory which contains the file(s) for transfer in the right list box by clicking on one of the path options and clicking the Select button until the full directory path displayed above the list box is correct. The files contained in this directory will be displayed in the left list box.
Receiving Files The following procedure is used to transfer files from the host to your PC. 1. Start the transfer procedure on the host computer and specify that files are to be sent. 2. Display the TeemTalk File menu on your PC and select File Transfer...
Page 138
File Transfer 6. If the kermit protocol is being used and the host kermit is in remote mode, click the Remote button in the Initiate File Transfer dialog box, then the Get button in the Remote Operations dialog box to specify the file to be received, otherwise, click the Receive button in the Initiate File Transfer dialog box.
File Transfer Cancelling A File Transfer When a file transfer is in progress, the File Transfer Data window will be displayed. This will provide information on the progress of the file transfer similar to that shown below. Clicking the Cancel button will display another dialog box with four cancel options. Selecting Cancel File then clicking the YES button will cause transfer of the current file to be cancelled by sending a 'Cancel File' message.
File Transfer Setting Protocol Parameters General Parameters Clicking the General... button in the Initiate File Transfer dialog box will cause the General Parameters dialog box to be displayed. This enables you to set various parameters for any of the transfer protocols. Once the settings have been selected, the initialization file can be modified to reflect the changes under the heading [TeemTalkFTU,Kermit] by checking the Save Settings box then clicking the OK button.
Page 141
File Transfer Duplicate file warning Factory default: Selected When this is selected, if an incoming file has the same name as an existing one it will be renamed to avoid overwriting it. A unique generation number will append or replace part of the old name. Send delay for first packet Factory default: 0 The setting of this option determines the length of time in seconds before the first...
File Transfer Kermit Parameters Clicking the Kermit... button in the Initiate File Transfer dialog box will cause the Kermit Parameters dialog box to be displayed. This enables you to set parameters specific to the Kermit protocol. Once the settings have been selected, the initialization file can be modified to reflect the changes under the heading [TeemTalkFTU,Kermit] by checking the Save Settings box then clicking the OK button.
Page 143
File Transfer End of line char Factory default: CTRL-M (i.e. CR) This specifies the character which terminates the packet. Quote char Factory default: # This specifies the character used to indicate that the next character is in the decimal range 0 - 31, 128 - 159, or is a delete character (127). Packet size Factory default: 80 This specifies the maximum byte size of a packet from the sequence number byte and...
File Transfer ASCII Parameters Clicking the ASCII... button in the Initiate File Transfer dialog box will cause the ASCII Parameters dialog box to be displayed. This enables you to set parameters specific to the ASCII protocol. Once the settings have been selected, the initialization file can be modified to reflect the changes under the heading [TeemTalkFTU,ASCII] by checking the Save Settings box then clicking the OK button.
Page 145
File Transfer Line Pacing Character Factory default: None This specifies the pacing character used to indicate that the host or PC is ready to receive the next line of data. Line Pacing Time Factory default: 0 This specifies the time in 1/10 seconds that the program will pause between each line transmission.
File Transfer ZMODEM Parameters Clicking the Zmodem... button in the Initiate File Transfer dialog box will cause the ZMODEM Parameters dialog box to be displayed. This enables you to set parameters specific to the ZMODEM protocol. The Send settings inform the remote end how to treat the data that will be sent to it.
Page 147
File Transfer The Resume option enables you to send the remainder of a file if the transfer process is interrupted, for example if data blocks were missed or the connection was lost. This saves you having to retransmit the entire file again. File Transfer Action Factory default: Default This specifies what action is to be taken by the receiving end on files that are...
Page 148
File Transfer Remote Command Factory default: Not specified This enables you to enter a command that will be sent to the remote end to initiate the file transfer. If a remote command is specified, this will be sent to the host with a terminating carriage return character before the transfer is started.
File Transfer Kermit Remote Operations When Kermit is selected as the transfer protocol, the Remote button in the Initiate File Transfer dialog box provides access to commands that enable you to perform various operations on the host. Kermit has to be operating in server mode on the host for remote commands to function.
Page 150
File Transfer Directory This enables you to specify which filenames are listed from the host's working directory. Clicking OK when nothing has been specified will cause all filenames to be displayed. Erase This enables you to specify the names of files to be deleted from the host's working directory.
File Transfer Local Operation Clicking the Local button in the Initiate File Transfer dialog box will display a dialog box which enables you to specify the default local directory for sending and receiving files. The current directory is displayed at the bottom of the dialog box. The Specification text box is used to specify which files in the current directory are displayed in the Files selection box.
ICL FTF File Transfer This chapter describes the ICL FTF file transfer utility supported by TeemTalk for Windows 3.1x in all terminal emulation modes. Configuration Requirements 1. FTF requires the DOSLANTI TSR to be loaded, but it is not necessary for the user interface, providing you do not attempt to initiate a transfer.
ICL FTF File Transfer Sending & Receiving Files The following procedure is used to transfer files between your PC and the remote host. 1. Run the File Transfer Responder on the remote host computer. 2. Display the TeemTalk File menu on your PC and select File Trans- fer...
Page 155
7. If the file to be transferred is a binary file, change the Data Type setting to Binary, otherwise leave it as Text. No translation of the data will be performed during the transfer. 8. Specify the Direction of the file transfer by selecting To Host or From Host.
ICL FTF File Transfer Transfer Options This dialog box is displayed by clicking the During Transfer... button in the FTF dialog box. Text Formatting Factory default: Negotiate This specifies the method of formatting text during the file transfer. Clicking on the arrow button will display a list of all the formatting methods supported from which you can make a selection.
Page 157
No formatting action is specified by end of record but the formatting actions CR, LF, NL, BS, FF, NP may be represented by embedded characters. Negotiate FTF negotiates with the remote host to decide on the text formatting required. No formatting No formatting actions are implied by end of record or by emdedded characters.
Page 158
ICL FTF File Transfer Debug Transfer Factory default: Unselected This option should only be selected under the guidance of a Pericom representative. It causes diagnostic information to be produced which is used for troubleshooting pur- poses. Preserve Record Boundaries Factory default: Unselected Select this option if you want the receiving system to preserve the record boundaries in the transmitted data when it writes the file to disk.
Remote Host Options This dialog box is displayed by clicking the At Remote Host... button in the FTF dialog box. Remote File Operation Factory default: Make or replace This specifies what operation should be performed on the file. Click on the arrow button to display a list of operations supported, then double-click to select the mode you want to use.
Page 160
ICL FTF File Transfer Execute The file, which must be SCL or VME, will be submitted for execution. See also Special options. Print The file, which must be text, will be printed by the remote system after the transfer has completed. See also Special Options.
Page 161
Text Storage Code Factory default: Host Default This specifies the code in which data is stored at the remote system. Usually you can leave this set to Host Default so that the remote system decides for itself what code the data is stored in. Print Factory default: Unselected When selected, this will cause the file to be printed by the remote host after it has...
This chapter describes the FTP file transfer utility for TCP/IP connections. The Transfer Procedure The basic procedure for transferring files is described below. Following sections describe the various options available in detail. Note that FTP only operates on the Windows Sockets stack. 1.
Page 164
FTP File Transfer The left hand list box will display the contents of the local home directory on your current drive by default. The drive selection list box above it enables you to specify a different disk drive. 2. To make a remote host connection, display the Connection dialog box either by clicking the following button in the toolbar, or by selecting Connect to Host in the Session menu.
Page 165
FTP File Transfer The Local and Remote Directory boxes enable you to specify the start directories (and drive name if required) that FTP will automatically attempt to locate and display in the TTWFTP window when a session is connected. The normal default directory (home) will be displayed if no directory is specified or the directory is not accessible.
Page 166
FTP File Transfer 4. If you want to save the session configuration for future connection, display the Configure menu and select Save Settings on Exit. This is a toggle selection which will display a tick mark when enabled. 5. Display the directory containing the file(s) to be transferred and the destination directory in the Local and Remote Directory list boxes as required.
Page 167
If the current directory contains subdirectories that you wish to transfer, check the Include Subdirectories check box. This will ensure that FTP creates the relevant subdirectories on the destination drive. Note: A new Confirm Copy Files dialog box will appear for each subdirectory when it is opened ready for transferring its contents.
Page 168
FTP File Transfer Note that if you try to exit without disconnecting from the host, the following message box will be displayed: Clicking Yes will disconnect from the host then close the TTWFTP window. 10-6...
FTP File Transfer Menu & Toolbar Options Five menus can be displayed from the menu bar, four of which are shown below. The fifth menu, Help, enables you to display the software version number. The buttons on the toolbar provide a quick way of performing functions or displaying dialog boxes without having to use the menus.
Page 170
FTP File Transfer Delete This will display a message box to confirm that you want to delete the currently selected file(s) or directory on the local PC or remote host. Pressing the Delete key will have the same effect. Note that directories have to be empty before they can be deleted.
Page 171
FTP File Transfer Create Directory This will display a dialog box which enables you to create a new directory (or library on AS400) on the local PC or remote host. Remote Change Mode This will display a dialog box which enables you to change the permission settings available to you for a specified file on the remote host.
FTP File Transfer The Session Menu Connect to Host This will display a dialog box which enables you to enter details of the remote host and make a connection. A connection is made by entering the Host, Login, Password and (if required) Account details, specifying the operating system of the remote host, then clicking the Connect button.
FTP File Transfer host, login, password and account details when you click on it. A session name is assigned by clicking the Add button to display the following dialog box. Enter a unique name, the name of the remote host for example, then click OK to save the current host connection settings to that name.
FTP File Transfer Conversion option will cause all uppercase characters in the name of the file to be converted to lowercase during the transfer process. Save Settings on Exit This is a toggle function which will display a tick mark when selected. When selected, all the currently defined session names and associated settings will be saved when you exit.
FTP Initialization File Entries Session settings specified in the Connection dialog box can be saved by selecting Save Settings on Exit in the Configure menu. This is a toggle function which will display a tick mark when selected. The settings are stored in one of the following files: Windows 3.1x: TTWFTP.INI in the WINDOWS directory.
FTP File Transfer Disable Delete Command You can prevent the deletion of files and directories in the TTWFTP window by including the command DisableDelete=1 in a command group headed [General]. This will disable the Delete File button, the Delete option in the File menu, and the Delete key.
The name and contents of the initialization file will vary depending on which version of Microsoft Windows you are using. Windows 3.1x TeemTalk initialization commands are grouped under one of the following headings in the Microsoft Windows WIN.INI file: TeemTalk-05W: TeemTalk-07W: TeemTalk-11W: Initialization Commands [tt05w]...
A private profile file is used to store settings specific to TeemTalk which are inappro- priate for placing in any of the standard Windows .INI files. A default private profile file is automatically created when TeemTalk is installed: TeemTalk-05W: TeemTalk-07W: TeemTalk-11W:...
[Untitled.ses] Wsp=tt07w.wsp Nv=tt07w.nv [Sessions] Default=Untitled.ses [Startup] Dialog=1 SaveAsDefault=1 Editor=notepad.exe All entries within the file are searched for on a case insensitive basis. Note: TeemTalk WIN.INI commands cannot be placed in the private profile file. Settings which should be placed in the private profile file will be clearly indicated.
Page 180
Initialization Commands You can view the contents of the private profile file used by the current instance of TeemTalk by displaying the Startup Options dialog box from the File menu and clicking the Edit... button. The private profile file will already contain entries similar to the following, where commands are grouped under headings enclosed by square brackets: [Untitled.ses] Wsp=tt07w.wsp...
Initialization Commands Command Line Option Format The command line is entered in the Microsoft Windows Program Item Properties dialog box, which is displayed by selecting File then Properties in the Program Manager window when the TeemTalk icon is selected. Options are entered after the name of your TeemTalk program and each option must be preceded by a space.
Initialization Commands Command Summary ◆ indicates the command does not apply to TeemTalk-05W or TeemTalk-05W32. Network Connection Command Function Network host name Network protocol Load Winsock on startup NetBIOS version TSR identifier (Windows 3.1x) Input queue size New session warning message...
Page 183
Command Function Window fills screen on start-up Disable copyright message Disable Control menu & min/max Disable Control menu Disable close window menu item Disable minimize button Disable maximize button Disable window frame Disable title bar Disable menu bar Disable toolbar Disable scroll bar Title to display in title bar Subtitle to display in title bar...
Initialization Commands Network Connection Network Host Name Initialization File: host=name Command Line: hostname/protocol Default Setting: Not applicable You can make TeemTalk automatically connect to a network host node each time it is loaded or reset by specifying the host name, protocol and, if necessary, a different default TSR identifier in the initialization file or on the command line.
Page 185
TeemTalk for Windows 95 & NT: CTERM MULTILAN NETBIOS Refer to the Network Connection chapter in the Networking Guide for a description of these protocols. Note that if you only specify the host name on the command line then TeemTalk will assume you are using TCP/IP.
Initialization Commands TSR Identifier WIN.INI File: netid=identifier Command Line: -iidentifier Default Setting: TeemTalk for Windows 3.1x communicates with its TSR programs and the network kernel software via interrupt 63 (hex). A unique TSR identifier is used to link an instance of TeemTalk to a particular TSR. This enables two or more instances of TeemTalk to use different network protocols, and also allows other software in the system to use interrupt 63.
Page 187
Disable 'Closed Connection' Message Box Initialization File: exitOnClose=on exitOnClose=off exitOnClose=connect TeemTalk attempts to Command Line: -e1 TeemTalk does not exit -e2 TeemTalk attempts to reconnect Default Setting: Message box displayed When the host closes the connection or the connection fails, TeemTalk normally displays a message box giving you the option to reconnect, cancel or exit.
Initialization Commands Telnet Commands Suppress Telnet Echo Option Private Profile File: TelnetEchoSuppress=Yes Command Line: Default Setting: This command will suppress TeemTalk generation of the Telnet echo option on connection. It must be placed under the [Sessions] heading in the TeemTalk private profile file.
Session Configuration Startup Command Group To Action Initialization File: Not applicable Command Line: -nname Default Setting: Windows 3.1x: Windows 95 & NT: default You can specify more than one set of startup commands in the Windows 3.1x WIN.INI file or the Windows 95 or NT TT*W.INI private profile file. This enables you to configure each instance of TeemTalk differently.
Initialization Commands Private Profile File To Use Initialization File: Not applicable Command Line: -pffilename Default Setting: TT*W.INI This command line option enables you to specify a different private profile file for TeemTalk to use instead of the default. Path For Emulation Settings File WIN.INI File: NVPath=directory Command Line:...
Run Script File Initialization File: scriptfile=filename Command Line: -scfilename Default Setting: Not applicable TeemTalk provides a script language which can be used to automate certain activities such as logging into remote computers. These commands enable you to specify the name (and directory path if necessary) of the script file to initialize. The format of the script file is explained in the chapter Creating A Script File.
Initialization Commands specified in the ZModem Settings dialog box. Note that the transfer protocol selected in the Initiate File Transfer dialog box will be ignored. Refer to the File Transfer chapter for more information. Disable Bell Initialization File: bell=off Command Line: Default Setting: Enabled These commands enable you to turn off the terminal bell.
Display Window Minimized When Loaded Initialization File: windowSize=minimized Command Line: Default Setting: Not applicable These commands will cause the window to be displayed as an icon when TeemTalk is loaded. Window Maximized When Loaded Initialization File: windowSize=maximized Command Line: Default Setting: Not applicable 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...
Initialization Commands Disable Control Menu & Min/Maximize Buttons Initialization File: SystemMenu=none Command Line: Default Setting: These commands will remove the Control (System) menu icon and the minimize and maximize buttons from the TeemTalk window. Disable Control Menu Initialization File: SystemMenu=off Command Line: Default Setting: These commands will remove the Control (System) menu icon from the TeemTalk...
Disable Window Frame Initialization File: windowFrame=off Command Line: Default Setting: These commands will disable the window frame. Disable Title Bar Initialization File: titlebar=off Command Line: Default Setting: These commands will remove the title bar from the window. Disable Menu Items The following initialization file commands will disable individual menu items: File Menu: FileMenu=Off...
Initialization Commands Disable Menu Bar Initialization File: menubar=off Command Line: Default Setting: These commands will remove the menu bar from the window. The File, Edit and Settings menus and the << and >> window resize commands will be unavailable. Disable Toolbar Initialization File: toolbar=off Command Line: Default Setting:...
Window Subtitle Initialization File: subTitle="subtitle" Command Line: -st"subtitle" Default Setting: Untitled These commands enable you to specify a subtitle for display in the title bar of a specific TeemTalk window. By default the subtitle is the name of the session. Soft Buttons Displayed Initialization File: buttonlevels=0-4 Command Line:...
Page 198
Initialization Commands font size by using one of these commands where index is the index of the font as defined in the following tables. The size of the font for a particular index will vary depending on the terminal emula- tion.
Alpha is on during redraw These commands enable you to prevent display flicker which is noticeable with some applications when a segment redraw is being performed. (The commands do not apply to TeemTalk-05W or TeemTalk-05W32.) Crosshair Cursor Size Initialization File: CrosshairSize=size...
These commands specify the amount of available segment memory in 1 kilobyte blocks. The minimum segment memory size that can be specified is 256 kilobytes, the maximum is 2048 kilobytes. (The commands do not apply to TeemTalk-05W or TeemTalk-05W32.) Maximum Number Of Segments In Memory...
Keyboard & Mouse LK450 Keyboard Initialization File: LK450keyboard=yes Command Line: -kblk450 Default Setting: Not applicable These commands enable you to specify that an LK450 keyboard is being used. Mouse Cursor Style Initialization File: mouseCursor=0-10 Command Line: -mc0-10 Default Setting: I-beam cursor These commands enable you to specify the style of the mouse cursor displayed by default in the TeemTalk window.
Page 202
Initialization Commands In some cases it may be necessary to disable the copy and paste function of the mouse buttons to prevent accidental editing. This can be achieved by using one of these commands. When the editing functions are disabled, use the Edit menu options or the numeric keypad keys Shift + .
Printing Default TeemTalk Printer Initialization File: device=printer details Command Line: Not applicable Default Setting: As specified in the Control panel This command enables you to specify a different printer which TeemTalk will use by default instead of that specified in the Control panel. Use Windows Default Printer Initialization File: UseWindowsPrinter=yes Command Line:...
Initialization Commands Send Print Data To File Initialization File: printtofile=filename Command Line: -prfilename Default Setting: Not applicable These commands enable you to direct print data to a specified file instead of the printer. Disable Remote Printing Sequences Initialization File: remotePrinting=off Command Line: Default Setting: Remote printing sequences enabled...
Creating A Script File This chapter describes TeemTalk's scripting language. Introduction TeemTalk provides a comprehensive script language which allows all aspects of the emulator to be controlled via user written command files. Operating in real time, the script language can be used to create customised environments, detect and act upon host events, and simulate user input.
Creating A Script File TeemTalk for Windows 95 & NT To specify the name of the script file in the TT*W.INI private profile file (where * is your version of TeemTalk, e.g. 07 for TeemTalk-07W) , use a text editor to insert the following line under the command group headed [startup,default] , separating it from the next command group by a blank line: scriptfile=filename...
Creating A Script File For example, to program a key or button so that it will run the script file myscript.scr and assign the values value1 to variable ArgV1 and value2 to ArgV2, you would enter the following in the key/button definition text box: <'myscript.scr(value1,value2)'>...
Creating A Script File Script File Examples Log On Script To introduce scripting, here is an example of probably the most obvious task to automate - logging on to a host computer over a network: hrcv hold pset network protocol "protocol" nodename "nodename" connect hcmp 0,"login: "...
Page 209
Creating A Script File also sometimes necessary to ensure that the LAST character received from the host is the LAST character of the string, to ensure that the host is ready to accept what is sent by the put command. You can use the Display Controls option in the Terminal Settings dialog box to find this out.
Page 210
Creating A Script File LOGON1: pset emul mode tek LOGON2: pset emul mode w3220 LOGON3: pset emul mode vt2207 LOGON4: pset emul mode vt2208 Programming Keyboard Macros What we have now achieved using soft buttons could also be done using keyboard macros.
Page 211
Similar definitions can also be applied to soft buttons to allow frequently used sequences to be accessible with one mouse click. Key combinations are also possible to define by including the complete combination within angle brackets (< and >). For example, to program the A key so that it performs the same function as ALT + F4 :- pset macro VK_A "<ALT+VT__F4>"...
Page 212
Creating A Script File if (errno) goto lab1: DDE initiate "Excel", "sheet1", channel2 if (errno) goto lab2: wrt "DDE initiation with Excel succeeded_n_r" wrt "Excel Supports the following Clipboard formats:_n_r_t" dde request "Formats" RequestedInformation, channel1 dde request "Selection" RequestedSelectInfo, channel1 wrt RequestedInformation"_n_r"...
Page 213
Initiating A File Transfer The following script file example will attempt to initiate a file transfer and display various informative messages. ****************************** * Transfer a file using Kermit * ****************************** VAR %reply VAR %success = 1 VAR $files = "" VAR $message HRCV HOLD GOSUB lab2:...
Page 214
Creating A Script File IF (errno) MSGBOX "'set file type binary' did not get 'C-Kermit>' prompt",1,reply LET success = 0 RETURN RETURN **************************** * Setting Kermit to 'server' * **************************** lab3: LET success = 1 PUT "server_r" HCMP 60,"reconnect._n_r_n" IF (errno) LET success = 0 MSGBOX “setting remote Kermit to ‘server’...
Page 215
ELSE MSGBOX "'KERMIT remote SEND' successful",1,reply lab6: FTU CANCEL RETURN *********************************** * Take Kermit out of 'server' mode * *********************************** lab5: LET success = 1 FTU INITIATE FTU SET TRANSFER KERMIT IF (errno) LET success = 0 MSGBOX "Could not set 'TRANSFER' mode to 'KERMIT'",1,reply GOTO lab7: FTU SET REMOTE FINISH IF (errno)
Creating A Script File Syntax Conventions This section explains the rules for writing a script program. Program Lines The first text entry of each line must be a script command or a line label, which may be preceded by any number of spaces from the beginning of the line. The command can be entered in upper or lower case.
Page 217
Decimal Value Of ASCII Characters In Strings You can enter the decimal value of ASCII characters within character strings. A decimal value is entered as a three digit number preceded by an underline character. Decimal values with only two digits must be preceded by a zero. For example: _027 means ESC (the Escape character)
Creating A Script File Script Operators The script language supports various arithmetic operators to facilitate calculations and manipulations on numeric variables and discrete numeric values. Some of the operators are also extended to provide some useful manipulations on strings and string variables.
Page 219
Equivalence Testing (== !=) The == and != operators allow you to check that a variable is set to a particular value. For example, the following lines could be inserted between the 6th and 7th lines in the above sample code to provide a check for a specific value: else if (Input == 5) wrt "That's the value I wanted_n_r"...
Creating A Script File Arithmetic Modifiers (+= -= *= /= %=) These operators all act as per their usual function (if the = was ignored), but have the effect that they substitute the resultant value back into the variable upon which they were operating.
Page 221
For example: var $String while (String != "Exit") inp "Give me a string", String exit would keep requesting for input until the string equals Exit. The < and <= operators compare the decimal values of each character in the string in turn to see if the values are less than that of the equivalent characters in the string to which it is compared.
Creating A Script File Command Descriptions The commands that can be used in the script file are described in alphabetical order on the following pages. Conventions Character Case Each command description begins by showing the basic command followed by the command format with any parameters.
Command Summary PROGRAM COMMANDS Branch to specified label line if system flag is false. Branch to specified label line if system flag is true. ELSE Do the following if previously specified if condition not true. EXIT Exit script program but not TeemTalk. GOSUB Go to subroutine at specified label line.
Creating A Script File DIALOGUE Display dialog box with text box, Ok & Cancel buttons. Display and action following lines. Display prompt & place entered characters in variable. MSGBOX Display message box incorporating specified buttons. PASSWORD Display dialog box for password entry. RDPXY Read characters from display buffer position &...
Page 225
FTU SET Set the value of the specified parameter. FTU START Start the file transfer. FTP FILE TRANSFER FTP CD Change current local/remote directory. FTP CONNECT Connect to specified host. FTP COPYDLG Display message box during file transfer. FTP DIRFIRST Get first entry in local/remote directory.
Page 226
Creating A Script File STRING OPERATIONS DECRYPT Decrypt encrypted string and place in variable. ENCRYPT Encrypt string and place in variable. FSTR Format string to specified length and alignment. Count characters and spaces in variable. Convert uppercase characters to lowercase & place string in variable. LSTR Copy number of characters from left of string &...
Creating A Script File Commands BREAK Syntax: BREAK <time> Places a break signal on communications line for the specified time in milliseconds. If no time is specified then the break will be for 250 milliseconds. Syntax: BRF <label> If the system flag is set to FALSE, the program branches to the line with the specified label.
Page 228
Creating A Script File CLIPBD EMPTY Syntax: CLIPBD EMPTY This command will open the clipboard, clear all the data contained in the clipboard, then close it. Refer to the Error Numbers section later in this chapter for a list of possible error numbers for this command.
<destvar> <sourcevar> integer string integer float float integer DDE CANCEL Syntax: DDE CANCEL [<channel>] Cancels the DDE conversation on the channel specified by the <channel> variable (as defined by the dde initiate command). If no channel variable is specified then the channel ID is assumed to be 1.
Creating A Script File <channel> is the name of an integer variable (see var) into which an ID will be placed reflecting the particular channel for the initiated DDE link. A maximum of four channels may be used at any one time, each must have a different variable name.
The following example will place data contained in the variable data1 into cells located at row 1 column 1 through row 2 column 3 inclusive, with no channel specified (assuming the DDE partner is an Excel spreadsheet): dde poke data1 "R1C1:R2C3" DDE REQUEST Syntax: DDE REQUEST <item>...
Page 232
Creating A Script File DIALOGUE Syntax: DIALOGUE <title> <caption> <variable> [<x> <y>] This command enables you to display a simple dialog box with a specified title, containing two buttons (Ok and Cancel) and a single line text box with a specified caption, where <title>...
Page 233
<gname> is a previously defined string or integer variable which will store the group name (UNIX only). Note that if you require a value which follows one or more that are not required, you will still need to supply variables for them. For example, if you only wanted the time that the file was last modified, you would need to specify a variable for <size>...
Page 234
Creating A Script File Syntax: DSP <integer> If the integer is 1, all the program lines that follow are displayed and actioned. If the integer is 0, all following lines are actioned but not displayed. ELSE Syntax: ELSE This command is used in conjunction with the if command and informs the program to perform the command(s) on the following line(s) if a previously specified if condition was not true.
Page 235
ENCRYPT Syntax: ENCRYPT <result> <string> <key> Encrypts a string, where <result> is a previously defined string variable (see var) which will store the encrypted string. <string> is a string or string variable containing the string to encrypt. <key> is one or more characters that are used to define how the string is encrypted.
Creating A Script File FILE CLOSE Syntax: FILE CLOSE <handle> Closes the file with the specified handle where <handle> is the name of the integer variable assigned by the file open command. The Error Numbers section lists the possible error numbers for this command. FILE COPY Syntax: FILE COPY <filename>...
(read) W (write) and C (create). If this string is omitted the program will assume that the file will have read and write operations performed on it. For example, to create the file myfile.doc and enable characters to be written to it, the following line would be entered, specifying that the integer identifying the file is to be stored in the variable called id: file open id myfile.doc "cw"...
Creating A Script File FILE RGET Syntax: FILE RGET <handle> <variable> This will get a single character from a file and assign it to a variable, where <handle> is the integer variable specified by the file open command and used to identify the file.
<size> is a previously defined string or integer variable (see var) which will store the size of the file. <mode> is a previously defined string variable which will store the mode. <modtime> is a previously defined string variable which will store the time of the last modification.
Creating A Script File <variable> is a previously defined variable (see var) which contains the characters to be written to the file. <length> is the number of characters to be written if the variable is in string for- mat. If the variable is in integer format the number of characters that will be written is two, and if in floating point number format the number of characters that will be written is four.
FTP CONNECT Syntax: FTP CONNECT <system> <host> [<login> <password> <account>] This enables you to make a host connection for FTP file transfer. The <system> entry specifies the type of operating system used by the remote host and must be one of the following entered exactly as shown and enclosed by double quotes: Auto VAX UCX V1...
Creating A Script File FTP DIRFIRST Syntax: FTP DIRFIRST LOCAL <filename> [<size> <mode> <modtime> FTP DIRFIRST REMOTE <filename> [<size> <mode> <modtime> This FTP file transfer command will get the first entry in the current local or remote directory and place it in the previously defined string variables, where <filename>...
FTP DIRNEXT Syntax: FTP DIRNEXT LOCAL <filename> [<size> <mode> <modtime> FTP DIRNEXT REMOTE <filename> [<size> <mode> <modtime> This FTP file transfer command will get the next entry in the working directory following an ftp dirfirst command and place it in the previously defined string variables, where <filename>...
Creating A Script File Refer to the Error Numbers section later in this chapter for a list of possible error numbers for this command. FTP GET Syntax: FTP GET [<mode>] <remote file> [<local file>] This will transfer a file from the currently connected host, as initiated by the ftp connect command, where <mode>...
FTP RM Syntax: FTP RM LOCAL <filespec> FTP RM REMOTE <filespec> This FTP file transfer command will remove the specified local or remote file. Refer to the Error Numbers section later in this chapter for a list of possible error numbers for this command.
Creating A Script File <groupID> identifies a group of parameters. <paramID> identifies a particular parameter, or in the case of Parameter settings a sub-group of parameters. <subparamID> identifies a particular parameter when the <groupID> is specified as Parameter, otherwise this is omitted. For example, to get the current retry limit setting and place it in the previously defined variable called limit you would enter the following: ftu get limit parameter general retrylimit...
Page 247
Creating A Script File For example, to specify that the Kermit protocol end of line character for outbound packets is DEL, you would enter the following: ftu set parameter kermit seol "del" where parameter is the group ID, kermit is the parameter ID, seol is the sub- parameter ID, and "del"...
Creating A Script File FTU START Syntax: FTU START <command> This will start a file transfer where <command> can either be a variable or a string which usually relates to the name of the file to send or receive. The ftu set command is used prior to ftu start to specify whether you are sending or receiving a file.
Page 249
The following example will get the current protocol setting from the Windows 3.1 WIN.INI file and place it in the string variable netprot. getini "tt07w" "protocol" netprot The following example will get the current protocol setting from the Windows 95 or NT TT07W.INI file and place it in the string variable netprot.
Page 250
Creating A Script File HGET Syntax: HGET <variable> [, <count> [, <timeout>]] This gets one or more characters from the host and assigns them to the specified vari- able, where <count> is the number of characters to get from the host. If omitted then one character will be returned.
Page 251
Syntax: IF <condition> Informs the program to perform the command(s) on the following line(s) if the specified condition is true. The else command may be used in conjunction with if. For example: if (integer > 3) goto routine1: else goto routine2 If more than one command line is to be associated with if, insert a line containing the { (open curly brace) character before the first command line and a line containing the } (close curly brace) character following the last command line.
Page 252
Creating A Script File For example, to ask the user to enter his name and cause the name to be assigned to the variable UserID, the following line would be entered: inp "Please Enter Your Name: " UserID KACT Syntax: KACT <string> This command will cause the script program to perform the function of a key as if a terminal operator had pressed the key on the keyboard.
Page 253
KINTERCEPT Syntax: KINTERCEPT <boolean> When enabled, this command will cause all keystrokes entered by the terminal operator to be intercepted and stored in a queue so that the script program can take action on them using the kraw and kact commands. You should disable this function before the script program is exited.
Page 254
Creating A Script File KSTR Syntax: KSTR <string> This command will treat the characters contained in the string or string variable as macros to be performed. Refer to the Macros Settings dialog box description in the Setup Menus chapter for the macro definition format. More than one macro definition can be specified in the same string or variable.
Page 255
Syntax: LOW <result> <string> This command will convert all uppercase characters in a string to lowercase and place the resulting string in a variable, where <result> is a predefined string variable (see var) which will store the converted string. <string> is the string or variable containing the characters to be converted to lowercase.
Page 256
Creating A Script File For example, to specify that the Cancel and Retry buttons are to be displayed, the <buttons> integer would be 18. Only the following combinations of buttons are allowed: The following example will display a message box containing the message Do you wish to continue? and the buttons Yes and No, and cause the value of the button pressed by the user to be stored in the integer variable result.
Page 257
ONERROR Syntax: ONERROR <action> This command will perform the specified action when it encounters an error while the script program is running, where <action> can be one of the following: REPORT will display a message box indicating the type of error and the program line that caused it.
Page 258
Creating A Script File PARSE Syntax: PARSE <string> <variable1> <key> <variable2> This command enables you parse a string using a specified key (e.g. a single character or a string of characters), where <string> is the string or variable containing the string to be parsed. <variable#>...
Page 259
Creating A Script File text box by the user to be stored in the string variable result when the Ok button is pressed. password "Password" "Enter your password:" result 100 100 The Error Numbers section later in this chapter lists possible error numbers. PGET Syntax: PGET <variable>...
Page 260
Creating A Script File More than one setting within the same group of parameters can be specified on the same line. For example, to set the baud rate to 9600 and the serial port device to /dev/ ttya you would enter the following: pset host baud 9600 port "/dev/ttya"...
Page 261
RDPXY Syntax: RDPXY <variable> <row> <column> <count> This causes the program to read a specified number of characters from the specified row and column position in the display buffer and assign them to a previously defined string variable. Note that the row and column position is relative to the display buffer, not the current screen display.
Page 262
Creating A Script File RETURN Syntax: RETURN Terminates a gosub command, returning the program to the line following the most recently encountered gosub which has not yet been terminated. Syntax: RST This will reset TeemTalk and cause it to assert the last saved setup configuration. RSTR Syntax: RSTR <variable>...
Page 263
SETINI Syntax: SETINI <section> <entry> <setting> [<ini file>] This enables you set a setting in an initialization file, where <section> is a string or string variable which specifies the heading of the command group, for example tt07w for TeemTalk-07W initialization commands in the WIN.INI file, or startup,default for TeemTalk- 07W32 initialization commands in the TT07W.INI file.
Page 264
Creating A Script File SWITCH Syntax: (See below) This is used to compare the value of a variable with a list of possible values and perform the commands specified for the matching case. The format is as follows: SWITCH <variable> CASE <value1>...
TCMP Syntax: TCMP <delay> <row> <column> <string> This will wait for the specified <string> to appear on the screen at the start location specified by <row> and <column>, where <delay> is the number of seconds to wait for the specified string. If the string is received within the time period, the system flag is set to TRUE, otherwise the flag is set to FALSE.
About TeemTalk message box Copy Reverse command Copy Mono command Copy Mono Reverse command Close Session command Copy Reverse command TOOLBAR DEL Syntax: TOOLBAR DEL <position> This will delete the tool button or space at the specified position in the toolbar, where <position>...
Page 268
Creating A Script File <bitmap> is either a string containing the name of the bitmap file to use, or an integer which relates to the standard defined toolbar bitmaps in the order displayed in the Button Tools dialog box, the first being 0, the second 1, etc.
Page 269
var !float 0.45 All future references to a variable are made by using its name without the $, % or ! variable type identifying characters. Note: You can convert the type of data (string, integer, floating point number) from one variable to another using conv. You can specify more than one variable name (and value) on the same line.
Page 270
Creating A Script File wrt "Amount = " integer While commands may be nested up to 32 times. Syntax: WRT <string(s)> Displays string(s) delimited by double quote characters at the current cursor position. Variables (such as identity in the example below) can also be included. The following example will display User = followed by the contents of the variable identity and then perform a line feed (_n) and carriage return (_r).
Error Numbers You can incorporate a special variable called errno in your script file which will be used to store a number indicating the result of a command (i.e. success or type of failure). The errno variable is an integer variable which is already defined as part of the script language, that is, you do not need to use the var command to include it in your script file.
Page 272
Creating A Script File DIALOGUE The command was successful. Invalid parameter in the command string. Cancel button pressed. Unable to create the dialog box. FILE The command was successful. Invalid sub-command (e.g. must be file read and not file fred, etc.). Invalid variable for handle.
Page 273
Transaction done. Unknown packet. Cancelled. Too many retries. File open error. File read error. File write error. File close error. Sending. Send initialize error. 10 Send filename error. 11 Send data error. 12 Send end of file error. 13 Send end of transmission error. 14 Cannot initiate file transfer utility.
Page 274
Creating A Script File MSGBOX The command was successful. Invalid parameter in the command string. Invalid button combination specified. Unable to create the dialog box. PARSE The command was successful. Invalid parameter in the command string. Item not located in the string. PASSWORD The command was successful.
Script Error Trapping Functions The integrity of a script program can be checked by using the onerror, errorline and errorcode commands. These enable you to quickly find any syntax errors within the program. The following program lines provide an example of their use: var %integer1, $string1 onerror gosub errorhandler: (put your program here)
Page 276
Creating A Script File Message Displayed Syntax error Variable expected Integer expected String expected Boolean expected String variable expected Invalid expression Invalid parameter Label not found Index out of range Illegal RETURN statement There are no incompleted gosubs to return to. Illegal button combination A button combination passed to a dialogue Invalid key name Invalid subcommand...
PSET & PGET Parameters & Values This section lists the parameters available for the PSET and PGET commands, together with the values they will accept or return. Abbreviations are allowed in many cases, the essential characters being shown in UPPER CASE, with the rest of the value in lower case.
Page 278
Creating A Script File (Windows 95/NT): Port Number: Connect To Host: Close Host Connection: Telnet Options Telnet Port Number: Telnet Name: Suppress Echo: Force Binary Mode: Force EOR Mode: For Break Send TM: For Break Send CR: 12-74 GroupID ParamID NETwork PROTocol NETwork...
ISDN Settings Remote Dial Number: Remote Dial Sub Address: NETwork ISDNDIALSUBADDRESS Controller Card Number: NETwork ISDNCONTROL B1 Physical Layer: B2 Data Layer: B3 Network Layer: Local Dial Number: Local Dial Sub Address: Channel: B1 Baud Rate: B1 Data Bits: B1 Parity Bits: B1 Stop Bits: B2 Address A: B2 Address B:...
Page 280
Creating A Script File Print Screen Method: Use Printer Resolution: Auto Wrap: Centre Image On Paper: Graphics Scaling: Graphics Image: Auto Print Mode: Cancel Print: Eject Page: Serial Settings Use Serial Port: Host Port: Baud Rate: Parity: Flow Control: Data Bits: Stop Bits: Transmit Rate: On Line:...
Page 281
NCSI Settings Baud Rate: Parity: Flow Control: Data Bits: Stop Bits: Show Port Details: Save Session Settings Save Keyboard Macros: Save Soft Buttons: Save Attributes: Save Window Metrics: Save Text Rows: Save Buffer Rows: Save Connection: Save Terminal Settings: Emulation Settings Emulation: Code 1 Selects: Terminal ID:...
Page 282
Creating A Script File Multinational: Display Controls: Terminal Settings Keyboard Language: LF Implies CR: CR Implies LF: Ignore Deletes: Application Keypad: Application Cursor Keys: Scroll Bar on Maximize: Report Max. Line Length: Bypass Cancel Character: End Of Line Characters: End Of Message Characters: TERMinal End Of Message Frequency: TERMinal Terminal: Answerback String:...
Page 283
Dialog Settings GroupID Burst Scroll: DIALog Auto Wrap: DIALog Dialog Indices Locked: DIALog Dialog Area Visible: DIALog Cursor Origin: DIALog Cursor Style: DIALog Columns: DIALog Resize Font: DIALog Rows: DIALog Dialog Area Lines: DIALog Dialog Area Buffer: DIALog Dialog Area Enabled: DIALog Gin Settings Tablet Type:...
Page 284
Creating A Script File Attribute Settings Colour Selection Map Value Red: Map Value Green: Map Value Blue: Screen Index: Preferences Inverse Colours: AutoColour: ATTRIBUTE DISPLAY You can disable one or more attributes associated with the following text foreground or background index commands by entering the following characters immediately after the colour index: B Disable bold attribute F Disable flashing attribute...
Page 286
Creating A Script File Keyboard Macros Keyboard macros may be specified using Tektronix key reference numbers or virtual key names. A variable can also be specified for the ParamID. Delete All Macros: The following commands use the Tektronix key reference numbers listed in the Key Reference Numbers appendix.
Page 287
Soft Buttons The ParamID setting SB#L# specifies the soft button number (SB#) which can be any number between 1 and 12 inclusive, and the level number (L#) which can be 1 to 4. For example, SB4L2 specifies soft button 4 on level 2. Buttons Visible: Program Button: Button Name:...
Page 288
Creating A Script File Current Operating System Settings Current Disk Drive: Current Directory: Current Environment: Get Current Time: Get Current Day: Get Current Date: Get Milliseconds Elapsed Since Windows Started: Note: When using the Get Milliseconds command, the value will return to 0 (zero) after approximately 49.7 days.
Page 289
Invisible Attribute: Flashing Attribute: Highlight (Bold/Dim) Attribute: Normal (No Attributes): Line Drawing Character Set (VT Modes) Character Colour: Character Cell Colour: Creating A Script File GroupID ParamID CURRent BLank SECurity CURRent FLashing CURRent BOLD HALFBright CURRent NORMal CURRent LINEdrawing CURRent CURRent Value immediate...
Creating A Script File FTU SET & GET Parameters This section lists the parameters available for the script language FTU SET and FTU GET commands, together with the values they will accept or return. The actual value may be specified in upper or lower case, may have double quotes to delimit it as a string, or may be a previously defined variable.
Dynamic Data Exchange This chapter describes the support of dynamic data exchange (DDE) by TeemTalk. Introduction With the adoption of a standard user interface within the Microsoft Windows environment, personal computer users are becoming accustomed to the formalised methods by which keystrokes and mouse actions have a common effect, making it easier for users to become familiar with and switch between a whole range of unrelated but important applications.
Page 294
Dynamic Data Exchange ● Creating compound documents, such as a word-processing document that includes a chart produced by a graphics program. Using DDE, the chart will change when the source data is changed, while the rest of the document remains the same.
DDE Terminology In order to achieve a degree of understanding of the concepts of DDE, it is important to have a grasp of some of the terminology used to describe the protocol. Two applications co-operating in a DDE link are considered to be engaged in a DDE conversation.
Dynamic Data Exchange Using The Edit Menu DDE Functions The most apparent DDE support provided by TeemTalk are the two entries in the Edit menu, DDE Row Copy and DDE Column Copy. These two functions do not directly invoke a DDE link to another application. Instead, they ensure all the information that Microsoft Excel™...
Page 297
=szAppName|szTopicName!szItemName Therefore the Topic for the particular instance of TeemTalk under question is given between the | and the ! characters. The last piece of information required to establish a permanent data link is the item name itself. TeemTalk treats the item name as a direct reference to a position on the display area.
Dynamic Data Exchange File Transfer TeemTalk for Windows 3.1 (not Windows 95 or NT) supports DDE links with its file transfer executable, TTFLER.EXE, distributed with the standard TeemTalk package. Without getting too deep into the internal windows messages that are transmitted, the link between TeemTalk and TTFLER can briefly be summarised as follows.
Page 299
Data Transmission Over A Slave DDE Link Once initiated, TeemTalk enters Slave mode, diverting all input from the keyboard, for example to the Client application, and permitting data to be sent to it from the Client. Data coming from TeemTalk will be sent in the form of a DDE POKE message. A suitable way of accepting this is outlined below.
Page 300
Dynamic Data Exchange GlobalUnlock(hPokeData); if (bRelease) GlobalFree(hPokeData); PostMessage( hWndPartnerDDE, WM_DDE_ACK, hWnd, MAKELONG(0x8000, atomItem) return; The important call here is PartnerSentData, which actually does the processing of the received data. The lpPokeData->Value parameter, although defined in the DDE.H file as a character array containing 1 character, serves as a pointer to a larger block of data defined as follows: a) An INTEGER value reflecting the number of bytes of valid data sent, followed by...
Page 301
SendPoke( HWND hwnd, HWND hWndPartnerDDE, /* handle for partner in DDE */ char *szItem, int iData, char *szValue, int iValCount ATOM atomItem; HANDLE hPokeData; DDEPOKE FAR * lpPokeData; LPSTR pTemp; /* Allocate size of DDE data header, plus the data: a string */ /* terminated by <CR>...
Page 302
Dynamic Data Exchange Reading & Setting Terminal Parameters The TeemTalk for Windows 3.1 slave mode, or TeemTalk for Windows 95 or NT session DDE topic, supports the ability to set and read the user definable setup settings. The majority of settings require an integer value, but some require strings, which are handled slightly differently.
Page 303
case B2400: iBaud = 2400; break; case B4800: iBaud = 4800; break; case B9600: iBaud = 9600; break; case B19200: iBaud = 19200; break; return iBaud Example 2 Read the currently defined Answerback string and place in given buffer. GetAnswerback(LPSTR szAnswer, int iAnsLen) ATOM aAnswer;...
Page 304
Dynamic Data Exchange Example 3 All key values are defined using key macro identifiers as documented in the Key Reference Numbers appendix. Read the keyboard macro assigned to the Shift + F6 key sequence. Note: The highlighted characters Slave in hWndSlaveDDE are only applicable to TeemTalk for Windows 3.1.
Page 305
/* Treat Key macro request as a special case */ if (MenuID == IDM_MACROS) lSetting = MAKELONG(-DataGroup,iValue); else lSetting = MAKELONG(DataGroup,MenuID); ultoa(lSetting,buf,10); aItem = GlobalAddAtom((LPSTR)buf); if (!PostMessage( hWndPartnerDDE, WM_DDE_REQUEST, hWndSlaveDDE, MAKELONG(CF_TEXT,aItem) GlobalDeleteAtom(atomItem); return -1; /* Wait for DDE_DATA message return with requested data */ Xfer.Parameter = TRUE;...
Page 306
Dynamic Data Exchange /************************************************************* FUNCTION: ClientReceivedData PURPOSE: Called upon receipt of a WM_DDE_DATA *************************************************************/ void ClientReceivedData(HWND hWndDDE, HWND hWndPartnerDDE, LONG IParam) DDEDATA FAR * lpDDEData; BOOL bRelease; char szItemName(ITEM_NAME_MAX_SIZE+1); /*If this Data is in response to a request for data */ /*clear awaiting flags etc accordingly */ if (GetConvPendingAck(hWndDDE) == REQUEST) SetConvPendingAck(hWndDDE, NONE);...
Changing Parameter Settings Example 1 Set the serial communication’s port speed to a required baud rate. GetBaudRate(int Baud) int BaudID; switch(iBaud) case 110: BaudID = B110; break; case 300: BaudID = B300; break; case 600: BaudID = B600; break; case 1200: BaudID = B1200;...
Page 308
Dynamic Data Exchange Example 2 Redefine the Answerback to the given string. SetAnswerback(LPSTR szAnswer, int iAnsLen) ChangeSetting( hWnd, hWndPartner, IDM_EMUL, ANSSTRING, iAnsLen, szAnswer, iAnsLen Example 3 Set the keyboard macro assigned to the Shift + F6 key sequence to Hello World. Note: The highlighted characters Slave in hWndSlaveDDE are only applicable to TeemTalk for Windows 3.1.
Page 309
ChangeSetting( HWND hWndSlaveDDE, HWND hWndPartnerDDE, int MenuID, int DataGroup, int iValue, LPSTR szChar, int iCharCount DWORD lSetting; char buf[16]; lSetting = MAKELONG(DataGroup,MenuID); Itoa(iSetting,buf,10); SendPoke(hWndSlaveDDE, hWndPartnerDDE, buf, iValue, szChar, This time, the call to SendPoke assumes that all used strings are NULL terminated therefore allowing the iValue parameter to reference an integer setting, as opposed to the byte count as done previously.
Dynamic Data Exchange Additional DDE Functions 13-18...
Page 311
The first four functions in the table enable interrogation of TeemTalk. The remaining functions are described in the following sections. All functions referenced with the "Session" topic can additionally be performed using a topic name relating to the relevant TeemTalk instance, i.e. TTLK1, TTLK2, etc. as discussed in the section Using The Edit Menu DDE Functions earlier.
Page 312
Dynamic Data Exchange (LONG)sizeof(DDEPOKE) + sizeof(DDEMOUSEREPORT) + 2))) return; if (!(lpPokeData = (DDEPOKE FAR*)GlobalLock(hPokeData))) GlobalFree(hPokeData); return; MouseReport.X = Coord.x; MouseReport.Y = Coord.y; MouseReport.ButtonID = ButtonDown; fmemcpy(lpPokeData->Value, &(BYTE far *)MouseReport, There is no limit checking on the values of X and Y, so the values passed through to TeemTalk must be within the valid range for the application that is to receive the mouse hit.
Page 313
are received and then all of the buffered data will be dispatched to the Client DDE application that established the link. The termination characters are CR LF by default, but this can be overridden by including the following WIN.INI command in the TeemTalk command group: SessRecvTerm=character(s) where character(s) can be CRLF (default), CR, or LF.
Page 314
Dynamic Data Exchange This needs to be extracted from the DDEDATA message in order to read the appropriate values. One way of doing this is shown below. **************************************************************** FUNCTION: ClientReceiveData PURPOSE: Called when client application receives WM_DDE_DATA message. ****************************************************************/ void ClientReceiveData(hwndClientDDE, hwndServerDDE, lParam) HWND hwndClientDDE;...
Page 315
Dynamic Data Exchange The CurPosStr function is an alternative string version of CurPos. This returns a string of two three-digit decimal values for the X and Y coordinates in the form xxx,yyy. KeyStr KeyStr is a straightforward POKE of data that is treated as a key macro to be performed.
Dynamic Data Exchange DDE Link To A Visual Basic Application The following example Visual Basic application DDEDEMO creates a DDE link to two copies of TeemTalk. The link is created when the Start button is clicked. System information can be gained by using the buttons at the bottom of the screen. You can send information to TeemTalk by entering text in the box and clicking the Send button.
Page 317
DDEDEMO VERSION 2.00 Begin Form Form1 Caption ClientHeight ClientLeft ClientTop ClientWidth Height Left LinkTopic ScaleHeight ScaleWidth Width Begin CommandButton cls Caption FontBold FontItalic FontName FontSize FontStrikethru FontUnderline Height Index Left TabIndex Width Begin CommandButton ttscr Caption FontBold FontItalic FontName FontSize FontStrikethru FontUnderline Height...
Page 318
Dynamic Data Exchange FontSize FontStrikethru FontUnderline Height Index Left TabIndex Width Begin TextBox Text1 FontBold FontItalic FontName FontSize FontStrikethru FontUnderline Height Index Left TabIndex Width repeat last section with the following changes: Index 17 16 15 14 13 12 11 5 TabIndex 14 13 12 11 10 9 4440 4200...
Page 319
FontSize FontStrikethru FontUnderline Height Index Left TabIndex Width Begin CommandButton formats Caption FontBold FontItalic FontName FontSize FontStrikethru FontUnderline Height Index Left TabIndex Width Begin CommandButton topics Caption FontBold FontItalic FontName FontSize FontStrikethru FontUnderline Height Index Left TabIndex Width Begin CommandButton Sysitems Caption FontBold FontItalic...
Page 320
Dynamic Data Exchange Width Begin TextBox Text2 Height Left TabIndex Width Begin CommandButton cls Caption FontBold FontItalic FontName FontSize FontStrikethru FontUnderline Height Index Left TabIndex Width Begin CommandButton ttscr Caption FontBold FontItalic FontName FontSize FontStrikethru FontUnderline Height Index Left TabIndex Width Begin CommandButton Exit Caption...
Page 321
Width Begin CommandButton TTstat Caption FontBold FontItalic FontName FontSize FontStrikethru FontUnderline Height Index Left TabIndex Width Begin Frame Rahmen1 Caption FontBold FontItalic FontName FontSize FontStrikethru FontUnderline Height Left TabIndex Width Begin Frame Rahmen2 Caption FontBold FontItalic FontName FontSize FontStrikethru FontUnderline Height Left TabIndex...
Page 322
Dynamic Data Exchange Width Sub cls_Click (index As Integer) text2.LinkMode = 0 If index = 0 Then text2.LinkTopic = “TT07W|ttlk1” Else text2.LinkTopic = “TT07W|ttlk2” End If text2.LinkItem = “Send” text2.LinkMode = 2 text2 = text2 + Chr(13) + Chr(10) + Chr(0) text2.LinkPoke text2 = Chr(13) text2.LinkPoke...
Page 323
End Sub Sub status_Click (index As Integer) text2.LinkMode = 0 text2.LinkTopic = “TT07W|System” text2.LinkItem = “Status” text2.LinkMode = 2 text2.LinkRequest End Sub Sub Sysitems_Click (index As Integer) text2.LinkMode = 0 text2.LinkTopic = “TT07W|System” text2.LinkItem = “SysItems” text2.LinkMode = 2 text2.LinkRequest End Sub Sub topics_Click (index As Integer) text2.LinkMode = 0...
Page 324
Dynamic Data Exchange Text1(i + 12).LinkItem = “0,” + i + “,80” Text1(i + 12).LinkMode = 1 Next i End If End Sub 13-32...
Page 325
This appendix provides answers to the most commonly asked questions. Problem: When I try to run TeemTalk a message appears warning me that the language DLL or file transfer utility may not be compatible. Solution: This may occur when you have more than one version of TeemTalk installed on your system and the version you are trying to run is attempting to use a DLL or file that belongs to another version.
Troubleshooting 4. In the Save As File Name text box, specify the name of the workspace settings file (and the directory path if different from the default) which is to store the user preference settings selected by the Saved Items options.
Page 327
Problem: How do I run a 4010 program?. Solution: Display the Emulation Settings dialog box and select Tek as the emula- tion, then display the Dialog Settings dialog box and set the Dialog Area Enabled option to 0 (zero). Problem: The text background colour is incorrect. Solution: Select the required text colour indices in the Attributes dialog box then display the Dialog Settings dialog box and select Dialog Indices...
Page 328
Troubleshooting 2. Some overruns are caused by SMARTDRV write caching. To dis- able write caching but continue read caching, specify the drive letter without a + or -. For example, SMARTDRV C enables read caching but disables write caching. Note, however, that this will slow the PC down.
Virtual Key Names This appendix lists all the supported virtual key names which enable you to include a specific key function in a user definition. Standard Virtual Key Names Key Function Virtual Key Name 0 - 9 VK_0 - VK_9 A - Z VK_A - VK_Z Alt (same as Menu)
Dialog Area Copy* TK_DCOPY D. Area Visibility* TK_DVISIB Erase Dialog Area TK_DERASE Erase Graphics Area TK_GERASE Fill Patterns TK_PATTERNS * Except TeemTalk-05W and TeemTalk-05W32. Key Function Virtual Key Name F19 - F24 VK_OEM_F19 - F24 No Name VK_NONAME VK_PA1 Play...
Key Reference Numbers Key Reference Numbers This appendix lists the reference numbers assigned to keys on the British keyboard and mouse buttons which are used by Tek key programming commands. The following tables of reference numbers correspond to the keys listed in the left column.
Page 332
Key Reference Numbers BRITISH KEYBOARD KEY REFERENCE NUMBERS COMPOSE DELETE DO (F10) ESCAPE HELP (F11) HOME INSERT NEXT PAUSE BR REMOVE RETURN SPACE Keypad 0 Keypad 1 Keypad 2 Keypad 3 Keypad 4 Keypad 5 Keypad 6 Keypad 7 Keypad 8 Keypad 9 Keypad .
Page 335
MOUSE BUTTON REFERENCE NUMBERS Button Pressed -155 -157 Button Released -156 -158 Button Button Pressed -167 -169 Button Released -168 -170 Ctrl + Button Programmed strings for Button Released reference numbers are transmitted by releasing the button only when GIN has been enabled for report transmission on button release.
This appendix shows the tables of characters that are supported by TeemTalk. Introduction The following pages show the character sets that are supported when TeemTalk is in Tek Alpha or VT220 Alpha overall mode (as explained below). The mode in which each set is valid is indicated in brackets under the heading.
Page 338
Character Sets 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.
Page 339
ASCII (MULTINATIONAL 7-BIT) CHARACTER SET (Tek & VT220 Alpha Modes) COLUMN BITS 4 3 2 1 0000 0001 0010 0011 XOFF 0100 0101 0110 0111 1000 1001 1010 1011 1100 1101 1110 1111 OCTAL KEY: DECIMAL HEXADECIMAL The ASCII (American Standard Code for Information Interchange) character set will be selected when the Keyboard Language option in the Terminal Settings dialog box is set to North American, or the Multinational option in the Emulation Settings dialog box is selected.
Page 341
NATIONAL REPLACEMENT CHARACTERS (VT220 Alpha Mode) BINARY BIT OCTAL DECIMAL HEXADECIMAL ASCII £ British à Canadian Danish Ä Norwegian £ Dutch Finnish French £ à Belgian § German £ § Italian Portuguese £ § Spanish É Swedish Swiss French ù à...
Page 342
Character Sets NATIONAL REPLACEMENT CHARACTERS BINARY BIT OCTAL DECIMAL HEXADECIMAL ASCII British Danish Norwegian French German Swedish This table shows the characters that replace certain ASCII characters in Tek overall mode for the keyboard nationality chosen in the Terminal Settings dialog box. The national character set consists of the ASCII set with the changed characters listed on the line for the selected keyboard nationality.
Page 343
LINE DRAWING CHARACTER SET (Tek & VT220 Alpha Modes) COLUMN BITS 4 3 2 1 0000 0001 0010 0011 XOFF 0100 0101 0110 0111 1000 1001 1010 1011 1100 1101 1110 1111 OCTAL KEY: DECIMAL HEXADECIMAL This is a special character set which is used by some applications. "...
Character Sets ADDITIONAL CHARACTER SET COLUMN BITS 4 3 2 1 0000 0001 0010 0011 XOFF 0100 0101 0110 0111 1000 1001 1010 1011 1100 1101 1110 1111 OCTAL KEY: DECIMAL HEXADECIMAL These characters may be generated when TeemTalk is in Tek Alpha mode. (Tek Alpha Mode) Ä...
Host Command Summary This appendix lists the host and Tek Primary Setup commands that are valid in each terminal emulation mode. TeemTalk-specific commands are listed at the back. The following conventions are used in this command list: Spaces in a command are for clarity only and are not to be entered as part of the command.
Page 346
Host Command Summary TEXT ERASURE Erase text to end of line Erase text to end of screen GENERAL Cancel current ESC sequence & display error Sound audible tone MODE SELECTION Select terminal emulation mode (Host * 0 = Tek, 1 = ANSI, 2 = Edit, 3 = VT52, 5 = VT100N, 6 = VT220N, 7 = VT220M7, 8 = VT220M8) Select numeric keypad application mode...
ANSI VT100 Mode CHARACTER ATTRIBUTES Assign * attribute(s) to following characters Default attributes Bold on Underline on Flashing on Inverse video on Half intensity off Underline off Flashing off Inverse video off Black foreground Red foreground Green foreground Yellow foreground Blue foreground Magenta foreground 35 Cyan foreground...
Page 348
Host Command Summary Enable cursor Enable cursor autowrap Index cursor (move down one line) Insert FF character & advance cursor Line feed Move cursor down * lines Move cursor down one line Move cursor left * columns Move cursor one column left Move cursor right * columns Move cursor to beginning of next line Move cursor to left margin of current line...
Host Command Summary ANSI VT220 Mode When TeemTalk is in VT220 7 or 8 bit mode, the following commands will be executed in addition those listed previously for ANSI VT100 mode. CHARACTER ATTRIBUTES Non-erase attribute on Non-erase attribute off (* = 0 or 2) CHARACTER SET SELECTION Assign G2 label to * character set (second * is parameter)
Tek Mode ◆ Applies to TeemTalk-11W and TeemTalk-11W32 only. ● Applies to TeemTalk-05W & -05W32, TeemTalk-07W & TeemTalk-07W32. COLOUR Assign colour index to P0/P1 plotter pen ● Assign colours to dialog area indices Assign colours to surface indices ◆ Select background grey shade...
Page 352
Host Command Summary Enter Alpha mode Enter Marker mode Enter Vector mode Exit TeemTalk to DOS Insert FF & advance cursor Line feed Lock keyboard Lock viewing keys for zoom/pan Read command file from disk Reset TeemTalk Run a program Save parameters Save parameters in non-volatile file ◆...
Page 353
Select segment for GIN cursor ◆ Select tablet area Set GIN stroke report frequency Specify GIN cursor movement Specify GIN key characters Specify GIN stroke report key characters Specify tablet type GRAPHICS ALPHA TEXT Select alpha text font (G0) Select alpha text font (G1) Select underline mode Specify 4014 alpha text size (128 cpl) Specify 4014 alpha text size (128 cpl)
Page 354
Host Command Summary Select font for stroke precision Select graphics text control precision Select graphics text slant angle Select size of graphics text Specify graphics text string rotation angle Specify graphics text writing direction HOST COMMUNICATIONS Direct host data to specified port Ignore delete code Select bypass mode Select end of line characters...
Page 355
◆ Select port hardcopy quantity ◆ Select response to full page Send print data to file Set image orientation of hardcopy Specify colour resolution of data Specify density of hardcopy Specify hardcopy repaint number Specify printer type Specify size of colour hardcopy PIXEL COMMANDS Begin pixel operations Copy pixels from current to specified surf.
Page 356
Host Command Summary SEGMENTS Add primitives to segment Assign pick ID nos. to graphics primitives Assign segment to class Call segment as subroutine Copy segment into current segment def. Delete pick groups from segment Delete segment Delete segment part Enable segment visibility End definition of segment End segment &...
W3220 Mode GENERAL OPERATION Disable local echo Enable local echo Select bypass mode Transfer data between aux & host ports Transfer data from aux to host port GIN MODE Define polygon & enable polygon dragging Enable line dragging Request cursor position report Select GIN cursor position Terminate dragging GRAPHICS TEXT...
Page 358
Host Command Summary Select terminal emulation mode (Host * 0 = Tek, 1 = ANSI, 2 = Edit, 3 = VT52, 5 = VT100N, 6 = VT220N, 7 = VT220M7, 8 = VT220M8) POINT PLOT MODE Select marker type SURFACES & COLOURS Assign colour to overlay/alternate set index Assign colour to overlay/principal set index Assign colour to overlay/principal/alt.
TeemTalk Additional Commands MOUSE REPORTING IN ALPHANUMERIC APPLICATIONS Arm TeemTalk for mouse operation where *arg is of the format: bit 7 - 3 If all bits are cleared then any outstanding arming request is cancelled. The mouse remains armed until cancelled. When any of the selected events occur, the following report format is sent to the host: ESC [ = <Event Type>...
Page 362
Index Disable mouse editing 11-25 Disable remote printing 11-28 Disable scroll bar 11-20 Disable status bar 11-21 Disable system menu 11-18 Disable title bar 11-19 Disable toolbar 11-20 Disable window frame 11-19 Flashing for all sessions 11-22 Format 11-5 FTP include subdirectories 10-14 FTP progress bar 10-14 FTP time out 10-14 Hide script parameters 11-15...
Page 363
Scroll bar on maximized 7-32 Text attributes 7-40 Window size in rows 7-36 DVisib Button 2-17 Dynamic Data Exchange 13-1 Edit Menu 7-21 Edit Mode Selecting 2-9 Editing Text 7-21 Emulation Settings 7-25 Emulation Workspace 2-21 Enhanced AT Keyboard Mapping DEC VT220 mode 3-4 Tek, VT100 &...
Page 364
Index Tek mode E-7 VT220 mode E-6 VT52 mode E-1 W3220 mode E-13 Host Communications Bypass cancel character 7-33 End of message characters 7-34 End of message frequency 7-34 Getting started 2-3 NCSI settings menu 7-29 Report max. line length 7-33 RS232 overrun errors A-3 Serial settings menu 7-27 Host Connection...