3.1. Dialogs ________________________________________________________________ dataComet documentation. (Rev. 2/20/2010) Copyright 1995 databeast, Inc. All Rights Reserved. This document has information on (select and use "Find..." to go to the section): Using the "VT100" Preferences panel (ASCII) Using the "3270" Preferences panel (IBM 3270) Using the "Color" Preferences panel Using the "Keypad" Preferences panel Using the "Keypad" Preferences panel Using the "Views" Preferences panel Using the "Define macros" dialog... see "4. Macros" ___________________________________________________ Using the "VT100" Preferences panel (ASCII) ___________________________________________________ This dialog allows you to control the configuration of the emulator for the session which is currently on top when it is an ASCII connection. "Host menus and function keys": Allows you to select function key mappings. The "IBM 3270" and "IBM 5250 (AS/400)" options allow you to connect to an IBM EBCDIC host indirectly using an ASCII emulator, for example using a modem or through a UNIX machine running tn3270, and get menus and key mappings which send the equivalents of IBM function keys. A number of ASCII function key mappings are also provided for various ANSI/VT100 terminal variants; the names parallel the UNIX termcap or terminfo terminal entry names, e.g., "ncsa", "linux", "scoansi", "xterm", etc. "Return key sends:":, "Carriage Return":, "Line Feed": If the box for CR is checked, return sends a CR; if the box for LF is checked, an LF will be sent. If both are checked, CR-LF is sent. (You can always send a Line Feed by pressing Control-Return.) "Map ` to Escape": Applies to ASCII terminal emulation. Maps the '`' key to the ESCAPE key. (You can still send a '`' by pressing Control-'`'.) "Map delete to Delete (v. BS)": Applies to ASCII terminal emulation. Makes the key at the top right of the keyboard (variously labeled "Backspace" and "Delete") send a Delete character rather than a Backspace. (You can still send a Backspace by pressing Control-Backspace.) "Option is Meta Key": When the option key is down, metafy the character by sending an before sending the character. This is usually used with EMACS. The dataComet-Keyboard resource must be installed in the "Library/Keyboard Layouts/" file for this to work for all characters (otherwise E, I, N, U, and ` will misbehave, see the document "A3. dataComet Keyboard"). "Send vi commands to position cursor": Applies to ASCII terminal emulation when using the UNIX vi editor. This mode allows the cursor to be positioned more accurately and also sends fewer characters. "XOFF Ctl-": Host output is held soon after you input this character rather than waiting for the host to hold output. "XON Ctl-": works the same way for "resume output". "KILL Ctl-": currently is not used. "Size: Rows": & "Columns": You can use these fields to customize the size of the emulator. NOTE that you will have to configure your host to recognize any size other than 24 rows X 80 columns if the host does not accept Telnet window size negotiations. Only emulator sizes with less than 256 rows and total are less than 32000 characters are valid. "Answerback:": The answerback message dataComet sends back to the host when it receives a Control-E from the host. "Do CR-LF when LF received (newline mode)": Interpret linefeed characters sent from the host as newlines (carriage return-linefeeds). "Do CR-LF when CR received": Add a linefeed character when a CR is received from the host. "Wrap text when line overflows": Causes characters past the right margin to wrap down to a new line rather than being ignored. "VT100-wrap (wrap at column 81)": Allows you to disable the VT100 "feature" (designated in termcap entries with "xn" for "Xanthippe glitch") which makes the cursor wait to wrap at the end-of-line (so if a character is placed in column 80, and then a linefeed character is received, only one linefeed is performed). "Backspace wraps": Allows the cursor to wrap back to the end of the previous line when a BS is received. This is not standard VT100 behavior, but works well when entering long command lines in UNIX. "Use VT100 jump scrolling mode": Configures the ASCII emulators so that they will not update the screen immediately when the cursor goes above or below the scrolling area, but will wait until all the data from the host has been processed. This can speed up the display with some applications, since scrolling takes a lot of time. "Do blink": You can use this for special cases in which you wish to disable the "Blink" attribute in a VT100 display. "Do underscore": You can use this for special cases in which you wish to disable the "Underscore" attribute in a VT100 display. "Log Erase": Logs lines which are partially erased in the scrollback buffer and session log. "Update display promptly on clear": When this option is set, dataComet displays all data before it is cleared. Otherwise, it delays drawing until all processing of current host data is complete. "Display full Apple character set": Sets the VT100 class emulators to display characters from 128 through 159 rather than interpreting them as 8-bit control codes--as they are in standard ANSI/VT220 terminals. (This option is useful for displaying Mac OS X host characters more faithfully.) "Paste Pacing": options allow you to configure ASCII pastes to work reliably with your host in cases where the host is slow. If "Wait for character echo": is set, dataComet will wait for each character sent to be echoed before sending the next character. If you set "ticks/line":, dataComet will pause for that number of ticks (1/60ths of a second) before sending the next line; "ticks/char": pauses for the given number of ticks for each character. ___________________________________________________ Using the "3270" Preferences panel (IBM 3270) ___________________________________________________ This dialog allows you to control the configuration of the session which is currently on top when the connection is made using the 3270 emulator. "IBM Terminal Type": "IBM 3270-2 (24 X 80)":, "IBM 3270-3 (32 X 80)":, "IBM 3270-4 (43 X 80)":, "IBM 3270-5 (27 X 132)":, "IBM 3270 Custom": Allows you to set screen sizes other than the standard 24 row by 80 column display, using the "Size: Rows": and ... . NOTE that not all applications will use the larger display area. "Use Extended Base Colors for 3279": Turns on Base Color mode for mapping attributes to color when the 3279 color emulator is used, so Intense characters are Red and Protected characters are Blue. "Use IBM 5250 menus and function keys": Modifies menus and PF key mappings so you can easily use commands available on IBM AS/400 5250 terminal sessions, using the default host 3270 PF key mappings for 3270 <-> 5250 emulation. "Disable fallback to 24 X 80 screen": Allows you to disable host-selected fallback to the 24 X 80 default screen size from larger screen sizes, preserving the contents of the scrollback buffer in cases where the default screen size is only temporarily reset and not actually used. "Typeahead: allow input when System Busy": The Typeahead option allows you to set the emulator so it will discard all input when the SYS (system lock) light is on, as would a genuine IBM 3270 display. Thus, if typeahead is turned off, for a moment after the Enter key or a PF key is pressed, no input will be accepted from the keyboard, and all pending keyboard events will be discarded. If typeahead is on, keyboard input will be discarded only in the event of a "keyboard lock" condition, signified by the KBD light on the right of the screen, or if an error occurs in processing a command. (Note that when the Keyboard lock condition occurs, it can be cleared by either pushing the Reset button or executing the Reset menu command.) The IBM 3270 video display terminal distinguishes between null characters and spaces, yet displays both as blank spaces. Because this distinction fails to deliver "what you see is what you get," we have two options for handling nulls: "Send Imbedded 3270 Nulls as Blanks": Causes the emulator to substitute blanks for nulls which are in the middle of text within a field. "Squeeze out blanks at end of field in Insert mode": Causes blanks to be treated like nulls so that blanks at the end of a field will be deleted as you insert text in the middle of the field. "Shift whole field when deleting characters": Causes the whole field, rather than just the portion of the field on the current line, to shift to the left when a character is deleted. "Use starting cursor position as margin when pasting": Causes pastes to move the cursor back to the original starting column on the next row rather than to the beginning of the next row. "Erase EOF when pasting to clear previous contents": Clears the remainder of the current field before moving to the next line. ___________________________________________________ "Color" Using the "Color" Preferences panel ___________________________________________________ The "Color" Preferences panel allows you to turn color mapping on and off and set the color map for a session. The VT100 and 3270 emulators allow you to associate character attributes (such as "bold font") with different foreground and background colors; you can also select the button "Host Selects Colors" with VT220 and PC-ANSI mode to use host ANSI color sequences to set the color independently of other character attributes and map bold characters to the Intense color to display 16-color PC-ANSI screens. (Note that you may need to do a screen refresh to see the correct color mapping on a screen.) Clicking on a color brings up the standard Macintosh "Choose Color" dialog. Note that dataComet does not modify the Macintosh Color Palette, so the appearance of a color on the display may differ from the field displayed in the "Choose Color" dialog if you are only displaying 16 colors on your monitor. This is set in the Monitors Preferences Panel; this provides few colors into which to map your color choice in the Color Dialog into the existing 16 color Pallette. (Not modifying the Palette avoids nasty changes in the appearance of other applications when the Palette is changed.) To simplify copying color settings from one session to another, you can Copy the settings displayed for one Color dialog and Paste them into the Color dialog for another session. "Color mapping on": Use colors rather than black and white when displaying an emulator screen. "Background Color Erase": On by default, so that the currently selected background color fills areas which are erased. Some applications may work better with this option off. "Host selects colors": Let color control sequences received from the host determine the color used for characters in the emulator screen rather than selecting colors based on character attributes. "... except Background": Lets you select background colors yourself, even when Host selects colors is enabled. "Use 16 colors": Allows you to select 16-color colormaps for the VTxxx terminals. NOTE that this disables support for double-high and double-wide characters. "Show Extended map": Displays and allows you to modify the extended color range for host-selected PC-ANSI highlighted characters, and to modify the color mapping for Underlined attributes for VT100 attribute mapping. "Default Colors": Resets the current color map to the default map for the selected terminal type and setting for "Host selects colors". (Holding the Shift key down while pressing this button lets you select the default 16-color PC-ANSI map when VT100 or VT220 emulation has been selected, or normal 8-color mapping when PC-ANSI emulation has been selected.) ___________________________________________________ "Keypad..." Using the "Keypad" Preferences panel ___________________________________________________ "Set VT100/VT220 Keypad:" options: "Automatic": The VT100 keypad configuration is controlled by the host application. Host application control sequences to change the keypad functions are ignored if the following options are used: "Calculator": The keypad sends the characters associated with the labels in the "Set Keypad..." drawing, allowing you to exit PF key modes and send numeric keys. The arrow keys use the standard codes. "Calculator-Alternate": The keypad sends numeric keys; the arrow keys send the special PF-Application arrow key codes so they will work correctly with applications which expect them. "PF-Application": The keypad sends the VT100 codes associated with the Keypad Application mode. The arrow keys send special PF-Application codes. "PF-Alternate": The keypad sends the VT100 codes associated with the Keypad Alternate Application mode, but the arrow keys use the standard codes. "VT220 named FKeys sent without Shift key down": Usually the six function keys in the middle of the keyboard perform local Macintosh functions, and you need to hold down the Shift key to send the VT220 FKeys which are associated with these keys. This option swaps these functions, so that Shift is required instead to perform the local Macintosh functions. 3270 keypad options: The "Function 1", "Function 2", and "Function 3" keyboards provide convenient alternative keymappings for the keypad for interacting with IBM hosts. Shared options: "Switch Standard keyboard +/- keys to match picture": The Macintosh Standard and Extended keyboards have the '+' and '-' keys swapped. This setting allows you to remap the two keys so they're swapped back, producing the PF and other keys as they appear in the "Set Keypad..." pictures. ___________________________________________________ "Views" Using the "Views" Preferences dialog ___________________________________________________ "Show buttons at top of window": Show the buttons at the top of a session window. You can set these buttons to execute macros by using Command-Click to bring up the "Define Macros" dialog. "Show status bar at top of window": Show button controls and session status indication at the top of an emulator window. You can set these the button controls by using Command-Click to bring up the "Define Macros" dialog. "Show packets sent counter": Show the number of packets sent to the host. "Show packets received counter": Show the number of packets received from the host. "Show session timer at top of window": Maintain a session timer. This timer can be reset to zero using the '!Cr' macro. "Show cursor-buttons at left of window": Displays numbers corresponding to a macro (the list is displayed by holding down the '?'/'M' indicator at the top left of an emulator window; this is visible when "Show status bar at top of window" is enabled). Clicking when the number is displayed will execute that macro (or a default function key). You can set these macros by using Command-Click to bring up the "Define Macros" dialog. "Show horizontal scrollbar at bottom of window": Allows you to hide the horizontal scrollbar at the bottom of an emulator window. "Show cursor position": Displays the emulator cursor position in the horizontal scrollbar display area (row followed by column number). "Use Mouse position": When "Show cursor position" is enabled, this option allows you to display the emulator row and column position to which the mouse cursor points. ________________________________________________________________