|
||||||||||||||||||
VT HelpVT Help Table of Contents
Using VT Emulator HelpThis topic explains how to use VT Emulator online help. The left panel of VT Emulator Help window contains a list of help topics. These topics can be scrolled using the mouse, the Page Up key or Page Down key. Pointing to a topic with the mouse pointer and pushing the primary mouse button (usually the left button) puts a description of the selected topic on the right panel. The description in the right panel can be scrolled using the mouse, Page Up key, Page Down key, (at the top of the window) Cursor Up key, or (at the bottom of the window) Cursor Down key. The search buttons allow you to search for a text string within the help text sections. A search text string can contain blanks and is not case sensitive. Click the Next Topic and Prev Topic buttons to recreate the order of topics you have already seen. Click the Print button to print the help text topic being viewed or all help text topics. Click the Exit button to end the help session. If your monitor resolution is 1024x768 or higher, a Font button allows you to change the font size while viewing online help. 132 Column ModeYou or your System Administrator can disable the 132 column display screen size for all of your VT Emulator sessions using the IBM Network Station Manager program (VT Emulator Application). This can be done by setting the Additional Parameter NSTerm*c132: False. See the Additional Parameters section for details. Your System Administrator can disable the 132 column display screen size for some of your VT Emulator sessions. The 132 column display screen size can be disabled by using the +132 parameter on your VT Emulator startup command. The -132 parameter is used on your VT Emulator startup command to enable the 132 column screen size. The default screen size for the VT Emulator is 24 rows by 80 columns. This will be the screen size unless the host application sends a command to the VT Emulator to switch to 132 column mode. The number of rows will not change. Additional ParametersAdditional values (resources) control the appearance and behavior of your VT Emulator session, specified using the IBM Network Station Manager program, in the Additional Parameters section of the VT Emulator Application Setup menus. Setting these values affect all VT Emulator sessions on your Network Station. Note: Additional parameters are different than Launch Bar Other parameters. Additional parameters apply to all VT Emulator sessions. Other Parameters apply only to VT Emulator sessions which are started from the Launch Bar. Each Additional Parameter must be on a separate line. The format of the Additional Parameter is: NSTerm*iconic:True NSTerm is the VT Emulator program name, followed by a "*", the preference name, a ":", and the preference value. The parameters and values are case sensitive. If more than one additional parameter is entered, each must be on a separate line. Here are the Additional Parameters you may enter, and their values. Following the values is a brief description of the parameter. NSTerm*c132: True or False - Specifies if the VT Emulator will honor an application request to switch between a 132 and 80 column logical session size. NSTerm*iconic: True or False - Specifies if the VT Emulator is initially displayed in an iconified state. NSTerm*iconName: "xxxxxxx" - Where xxxxxxx specifies the name to display beneath the VT emulator icon. The name may contain any valid character, including blanks. NSTerm*mapOnOutput: True or False - Indicates that the VT Emulator will de-iconify (map) itself upon output from the application, if it is iconified. NSTerm*reverseVideo: True or False - Specifies if the foreground and background colors should be reversed. NSTerm*logFile: path/filename - Specifies the file name and path to which the VT Emulator writes the debug log. The VT Emulator must have write access to the path and file specified. NSTerm*DESKTOP: Enable (default) or DISABLE - Specifies if the VT emulator should initially position a VT emulator window using the previous position and font size. Color PreferencesThe default colors for the VT Emulator are a white background and a black foreground. The default can be changed by using the IBM network Station Manager program. The startup foreground, background, cursor, and mouse pointer colors can be changed for al VT Emulator sessions by setting values in the Applications, VT Emulator Additional Parameters. The colors can be set for a particular VT Emulator session when configuring a VT emulator Launch Bar Item by specifying values in the Other Parameters field. (Applications can change foreground and background color.) Preferences and values are case sensitive. The parameters are followed by a colon (:) and possible values. Following the values is a brief description of the parameter. These are placed in the Additional Parameters. The value of 'color' below can be replaced by: blue, sky-blue, turquoise, green, forest green, yellow, gold, purple, orange, orange-red, pink, light pink, tan, red, maroon, beige, gray, brown, tomato, slate gray, aquamarine (a full list of color names can be found in the file rgb.txt). NSTerm*background: color - This resource specifies the background color of the VT Emulator window as well as the default background color for the scroll bar. NSTerm*cursorColor: color - This resource specifies the color to use for the text cursor. NSTerm*foreground: color - This resource specifies the foreground color of the VT Emulator. NSTerm*pointerColor: color - This resource specifies the foreground color used by the VT Emulator for the mouse pointer. The following values are placed in the Other Parameters field when configuring a particular session. They will override any of the Additional Parameters for a particular session. The value of 'color' can be replaced by: blue, sky-blue, turquoise, green, forest green, yellow, gold, purple, orange, orange-red, pink, light pink, tan, red, maroon, beige, gray, brown, tomato, slate gray, aquamarine. -bg color - This option specifies the background color of the VT Emulator. -cr color - This option specifies the color to use for the text cursor. -fg color - This option specifies the foreground color of the VT Emulator. -ms color - This option specifies the color to use for the mouse pointer. A red-green-blue hexadecimal format can be specified for -bg, -cr, -fg, and -ms. For example: Control Menu Bar ChoiceSelecting Control menu bar option displays various VT Emulator functions. Soft Reset, Hard Reset, Send Break, Start Debug Log, and Stop Debug Log are the available options. Soft Reset: Resets the terminal to the default state. When in the default state, the cursor is placed at the upper-left corner of the screen, and the Miscellaneous Preference values of Application Cursor Mode and Application Keypad Mode are disabled. They may be enabled again by using the Miscellaneous Preferences program. Hard Reset: Does a soft reset and deletes all content from the screen. Send Break: Sends a break character to the application. Start Debug Log: Writes the data streams to and from a session to a log file.
Stop Debug Log: Stops the Debug Log. CopyData from a VT Emulator session can be copied into the 'clipboard buffer' and then pasted into this VT Emulator session, a different VT Emulator session, or even a different application. Menu bar copy: The data to be copied is first marked by setting the mouse pointer on the first character, pressing and holding the primary mouse button (usually the left one) while dragging the mouse pointer to the last character, then releasing the button. Finally, the Copy option of the Edit menu is selected to transfer a copy of the data to the clipboard buffer. An individual word or line can also be marked. Double click the primary mouse button in order to mark the word at the mouse cursor location. Triple click the primary mouse button in order to mark the entire line where the mouse cursor is located. Data may also be copied by using the keyboard. Once the data is marked by using the mouse, press the Alt key and the "c" key at the same time. The copy function may be mapped to a different key by using the Keyboard Remapper. Note: If the Edit menu choice is not displayed, your System Administrator can enable this menu choice for you using the IBM Network Station Manager. See Paste for a description of pasting data into this session or a different session. CutData from a VT Emulator session can be cut (deleted) and copied into the 'clipboard buffer'. The cut data can then be pasted into this VT Emulator session, a different VT Emulator session, or a different application. Data may not be cut from the history buffer, but only from areas that are available for input. The data to be copied and deleted is first marked by setting the mouse pointer on the first character, pressing and holding the primary mouse button (usually the left one) while dragging the mouse pointer to the last character, then releasing the button. Finally, the Cut option of the Edit menu is selected to delete the original text and to transfer a copy to the clipboard buffer. A marked cut area can be adjusted by pressing the secondary mouse button (usually the right one). Data may also be cut by using the keyboard. Once the data is marked by using the mouse, press the Alt key and the "x" key at the same time. The cut function may be mapped to a different key by using the Keyboard Remapper. The cut function is not available in 7 bit mode. See Paste for a description of pasting data during this session, or a different session. See Copy for a description of copying data. Default Keyboard Mapping FilesYou can use a default keyboard mapping file to change the actions for keys on your keyboard, even if you are not authorized to use the Keyboard Remapping program. See your System Administrator for details. An administrator can use the VT Emulator Keyboard Remapping program and IBM Network Station Manager program to create system, group, and user default keyboard mapping files. A default keyboard mapping file is created as follows: 1) Use the VT Emulator Keyboard Remapping program to create and test the keyboard mapping changes. If you have Network Stations with multiple keyboard types (for example, 101 and 102 key PC keyboards), use a Network Station with the matching type of keyboard to create the keyboard mapping file. A keyboard mapping file applies to one type of keyboard and VT emulation type. When the Keyboard Remapping program is started, a default key map is loaded based on the keyboard type and the VT Emulation type. This means an Network Station with a 101 key PC keyboard may be used to create separate key maps for vt220, vt100, and xterm emulation by starting the Keyboard Remapping program from VT Emulator sessions with those different VT Emulation types. 2) Save your keyboard mapping changes. The keyboard mapping file is written to the administrator's IBM Network Station user directory. Named keyboard mapping files allow use of a naming convention for mapping files (easier to match your keyboard mapping files to their users). Default keyboard mapping files are not copied; if you accidentally change a default keyboard mapping file, users will use the changed file. If you wish to change a named default keyboard mapping file later, temporarily add -keyfile in the IBM Network Station Manager program: click Desktop, click Launch Bar. Edit the Launch Bar Content for the VT Emulator session. Enter the -keyfile parameter followed by one space and the (case sensitive) named keyboard mapping file name (including the keyboard type extension) in Other parameters. Then, save the updated default keyboard mapping file with the same name. If your keyboard mapping file name contains any spaces, use double quotes around the file name (for example, -keyfile "key map file name.101_xterm"). 3) Use the IBM Network Station Manager program, VT Emulator Preferences, to select the desired keyboard mapping file from the administrator's user directory to become a system, group, or user default keyboard mapping file. Only one system default keyboard mapping file is allowed for each type of keyboard (for example, 101 PC keyboard) and VT emulation type ( for example, vt220). For more information on Keyboard Mapping Files, see the help text for the Keyboard Remapper. Note: The NumLock key is typically a modifier key and cannot be remapped. The -numLock (case sensitive) Other parameter option allows the NumLock to be remapped. Euro Monetary SymbolThe Euro monetary symbol is supported by the VT Emulator in the following languages: Danish, Dutch, Belgium Dutch, German, Swiss German, UK English, US English, Finnish, French, Belgium French, Canadian French, Swiss French, Italian, Swiss Italian, Norwegian, Portuguese, Brazilian Portuguese, Spanish, Latin American Spanish, and Swedish. The Euro monetary symbol is enabled for the VT Emulator by your administrator using the IBM Network Station Manager, Language preferences. To change this value for an individual session, enter -euro in the Network Station Manager, Launch Bar, Other parameters field. -euro is case sensitive. Exit VT EmulatorThis option ends the VT Emulator session. FontsThe VT Emulator session supports fixed font sizes. You can change the VT Emulator session font using the Fonts pull down choice. Your administrator can use the IBM Network Station Manager program to set your initial VT Emulator window location and size. Held Key Typing RateYou or your System Administrator can adjust the rate at which keystrokes are processed when a key is held down (using the IBM Network Station Manager program, select Hardware, then Workstation). Keyboard RemappingThe VT Emulator Keyboard Remapping program allows you to change the actions of keys within a VT Emulator session. Use of this program requires authorization from your System Administrator using the IBM Network Station Manager program. The Keyboard Remapping program could allow a user to accidentally change the functions of keys producing undesirable results. There are three levels of authorization to the VT Emulator Keyboard Remapping program: 1) Enabled: You are allowed to re-map your keyboard for VT Emulator sessions. 2) Disabled: You are not authorized to use the VT Emulator Keyboard Remapping program. The "Keyboard Remapping..." pull down choice is unavailable. 3) Hidden: You are not authorized to use the VT Emulator Keyboard Remapping program. The "Keyboard Remapping..." pull down choice is not displayed. The VT Emulator Keyboard Remapping program has its own help text. See this help text for details on the VT Emulator Keyboard Remapping program. Note: The Keyboard Remapping program is not available on a VGA-type monitor. VGA monitors are lower resolution (640x480) and typically older PC monitors. The Default Keyboard Mapping Files topic describes how a System Administrator can create system, group, and user default keyboard mapping files for IBM Network Station users. At the start of a VT Emulator session, the VT Emulator searches for a keyboard mapping file for the session. The keyboard type needs to match; a keyboard mapping file is used for one type of keyboard (for example, a PC 102 key keyboard), and one type of VT Emulation (for example, VT220). The following order is used; if a keyboard mapping file is found, it is used for the VT Emulator session: - Search for a -keyfile named keyboard mapping file that you created using the Keyboard Remapping program (stored in your $NSMSHARED/NSTERM/K directory; a System Administrator may use named keyboard mapping files.) - Search for a default keyboard mapping file that you created using the Keyboard Remapping program. - Search for a user default keyboard mapping file that your administrator selected for you. - Search for a group default keyboard mapping file that your administrator selected for your group. - Search for a system default keyboard mapping file that your administrator selected as a default for all IBM Network Station VT Emulator users. - If none of the above is found, the VT Emulator uses its program default keyboard actions for the terminal type. Language of a VT Emulator SessionThe language in which you are viewing this emulator help text, menu bar/pull downs, and dialogue boxes can be set in the IBM Network Station Manager program (your messages and menus language). Your VT Emulator session language uses the IBM Network Station Manager user language setting. Left/Right Handed MouseThe mouse on a IBM Network Station defaults to being a right handed mouse. The primary mouse button is the left mouse button. The primary mouse button on a left handed mouse is the right mouse button. You or your System Administrator can change your mouse to be left or right handed (using the IBM Network Station Manager program, select Hardware, then Workstation). MaximizeThe VT Emulator window can be maximized, covering the entire display screen. Click on the square in the upper right hand corner to toggle between normal window size and maximized window size. Maximize does not switch to a different font. Certain applications may not function correctly in maximized mode. Miscellaneous PreferencesMiscellaneous Preferences allow you to adjust your VT Emulator sessions; for example, cursor appearance, scrolling behavior, and application mode. Note: A System Administrator can use the IBM Network Station Manager program to disable Miscellaneous Preferences. The left portion of the Miscellaneous Preferences window lists preferences which can be changed. One preference is selected at a time. The right portion of the Miscellaneous Preferences window lists possible settings for the selected preference. Whenever a preference is changed, the VT Emulator session that launched Miscellaneous Preferences is temporarily updated to the new preference setting. For example, to change cursor style, simply select a different cursor style. Preferences are not changed by simply selecting preferences in the left portion of the window. The bottom portion of the Miscellaneous Preferences window has four buttons: 1) Click Save to save any changed preferences for later use. Preferences are saved in your Network Station user directory. This will bring up a Save Options window. This gives options to save changed preferences or to save all preferences. If save all preferences is selected it may save values that were set by command line parameters. This may cause behavior to be different for other VT Emulator sessions. If save changed preferences only is selected, then only the values that were explicitly changed in this Miscellaneous Preferences session are saved, but they will affect all subsequently launched VT Emulator sessions. 2) Click Exit to exit from the Miscellaneous Preferences window. 3) Click Set Defaults to restore all preferences back to their default state. 4) Click Help to bring up the help text you are currently viewing. Miscellaneous Preference settings are the same for all VT Emulator sessions for a given user. Mouse FunctionsThe mouse controls many functions on the Network Station. The mouse moves windows (by clicking and dragging the window title), changes window size (by pulling down "Fonts...", or dragging a window side or corner), and re-tiles windows. The mouse can also: - Access menu bar and pull down functions. - Cut, copy, and paste: See Cut, Copy, and Paste for more information. - Position the cursor (the default action of the primary mouse button, usually the left button). - Control the scroll bar. Mouse SpeedYou or your System Administrator can change the speed of your mouse (how fast the mouse pointer moves in relation to mouse movement) using the IBM Network Station Manager Hardware section. New VT EmulatorThis pull down choice allows you to start additional VT Emulator sessions. You are prompted for the host name. The current host name is available as a default. The host name can be the (Domain Name Server) name of the system or the (numeric) IP address of the system. This menu option may not be available to you if the System Administrator has disabled the Command Menu. An administrator can limit the number of VT emulator sessions per icon: In the IBM Network Station Manager program: click Desktop-->Launch Bar. Edit the Launch Bar Content for the VT Emulator Icon. Enter: Note: An administrator can change the VT Emulator port (default port is 23) by entering -port followed by the numeric port number in Other parameters. PasteData which has previously been Cut or Copied into the 'clipboard buffer' can be Pasted into a VT Emulator session. Pull down the Paste option to transfer a copy of the data stored in the clipboard buffer into the VT Emulator session, starting at the mouse pointer location. Data may also be pasted using the keyboard. Press the Alt key and the "v" key at the same time, and the data will be copied from the clipboard to the cursor location. The copy function may be mapped to a different key by using the Keyboard Remapper. Print Scroll BufferThe VT Emulator print scroll buffer function allows you to print the portion of a VT Emulator session that has been scrolled from view on a local Network Station printer or a network printer. Use of print scroll buffer requires authorization from your System Administrator (using the IBM Network Station Manager program). Any printer or printers that are available to you must be configured using the IBM Network Station Manager program. Print scroll buffer is started by clicking on "Print Scroll Buffer..." in the Print pull down or pressing the Alt + Print Screen key (or the key that was mapped to this function using the Keyboard Remapper program) Printers supported, ASCII printer code page, and PCL Symbol Set information can be found in the Screen Print help topic. Resizing a VT Emulator SessionThe VT Emulator session window size can be changed by selecting a different font using the "Fonts..." pull down. The number of rows and columns displayed does not change when different fonts are selected. The session size can also be changed by pressing the primary mouse button (usually the left button) on the lower right corner of the VT Emulator window border, moving the mouse pointer, and releasing the mouse button. The VT Emulator session size will remain where the mouse button was released, but the fonts will not be changed to match this new session size. Instead, a different number of rows and columns will be displayed. This is most useful when reading long lines of application information. If the window is made narrower (fewer columns displayed), the lines that are longer than the current size will be clipped at the window border. Certain applications may not function correctly when the emulator session is re-sized. Your administrator can use the IBM Network Station Manager program to set your initial VT Emulator window location and font. For screen size information, see the Additional Parameters, 132 Column Mode, or Screen Size sections. Screen PrintThe VT Emulator screen print function allows you to print the contents of a VT Emulator window on a local Network Station printer or a network printer. Use of screen print requires authorization from your System Administrator (using the IBM Network Station Manager program). Any printer or printers that are available to you must be configured using the IBM Network Station Manager program. Screen print is started by clicking on "Print Screen..." in the Print pull down or pressing the Shift + Print Screen key (or the key that was mapped to this function using the Keyboard Remapper program). Screen print is supported on many ASCII, PCL 4/5 (PCL is a trademark of Hewlett-Packard Co.), and PostScript Level 2 (PostScript is a trademark of Adobe Systems Incorporated) printers. Screen print sends the VT Emulator session contents to the specified printer. The VT Emulator session contents are converted prior to printing, based on the language of your VT Emulator session. More information can be found below. Note: Clicking the Print button saves any changes that you make in the VT Emulator Screen Print window for use the next time you select VT Emulator screen print. Note: A local Network Station printer can also be a system printer. The VT Emulator session contents are converted prior to printing, based on the language of your VT Emulator session. The printer language is assumed to be the same as your VT Emulator session language. Note: All characters may not print correctly in all languages. For PostScript printers, VT Emulator session contents are converted to ISOLatin1Encoding. ASCII printer code page and PCL Symbol Set can be found in the table below (see the topic Language of a VT Emulator Session for the primary using country for a language):
Screen SizeVT Emulator sessions default to support a 24 row by 80 column logical display screen size. Changing the font size using the "Fonts . . ." pull down will not change the number of rows and columns in the VT Emulator session. The number of rows and columns can be changed by pressing the primary mouse button (usually the left button) on the lower right corner of the VT Emulator window border, moving the mouse pointer, and releasing the mouse button. The VT Emulator, by default, will recognize an escape sequence from the application and switch to 132 column mode. This can be disabled by using the Network Station Manager program (Applications, VT Emulator) to set NSTerm*c132: False in the Additional Parameters field. This will set it for all VT Emulator sessions. If this behavior is only required for certain VT Emulator sessions, it can be set using the +132 parameter when configuring individual VT Emulator sessions on the Launch Bar. The Additional Parameter may be overridden by specifying -132. The default screen size may be changed when using the Network Station Manager program to configure the Launch Bar item for the VT Emulator session. The window width sets the initial number of columns and window height sets the initial number of rows. Changing the number of rows and columns may cause applications that are dependent on a 24x80 screen size to not appear as expected. Status LineThe status line is optionally located at the bottom of each VT Emulator session. The status line can be made visible by enabling the Miscellaneous Preference for Visible Status Line. When visible, the status line displays the row and column location of the text cursor in the far right corner. The host application running in the VT Emulator may also make the status line visible, and may optionally write program data to this line. This behavior may happen regardless of the setting of the Visible Status Line Miscellaneous Preference. Window TitleEach VT Emulator session has a window title at the top of the VT Emulator window. The default window title text is "VT Emulator". Your administrator can change this to any title you wish, using the Network Station Manager program. Your administrator can define a different font to be used in the window title and define different foreground/background colors for the VT Emulator window title. |
|
||
