HP OpenVMS Systems Documentation
HP TCP/IP Services for OpenVMS
To set up a VT100-Series terminal for emulation, follow these steps:
$ SET TERMINAL/INQUIRE
TN3270 requires terminal windows that support at least 24 lines and 80
4.12.3 Starting and Exiting from TN3270
Start a TN3270 session by using the TN3270 command. You can also use the TELNET/TERMINAL_TYPE=IBM-3278-n command. The default terminal type is IBM-3278-2. The following examples show several ways to start a TN3270 session, using the TN3270 command and connecting to host CENTRAL. For more information, see Section 4.3.
$ TN3270 CENTRAL
$ TN3270/TERMINAL_TYPE=IBM-3278-4 CENTRAL
You can invoke TN3270 and, without first connecting to a remote host, enter certain commands that customize the sessions and display parameters or status. You can also use a command file to invoke TN3270 and the customization.
The TN3270 command includes several qualifiers that allow you to specify customized or special files for the following:
TN3270 displays error messages in a bordered display at the bottom of your screen. This display overwrites the status display and remains visible until you clear it. To clear the display, invoke one of the following functions:
During a TN3270 session, you can record your screen's contents. The PRINT function directs your screen's contents to either a file or a spooled printer.
To record your screen's contents, follow these steps:
This creates the default output file, TN3270PRINT.LIS. TELNET does the following:
You can specify a different file name. To change the name, use one of the following methods:
$ TN3270 [ host ] /PRINTER=file
Online help during a TN3270 session displays the following information:
The Help screen shows the TN3270 functions as they correspond to the keys on your physical keyboard, as follows:
To see the Help screen, use the HELP function key F15.
4.12.7 If the Keyboard Locks
To unlock the keyboard, press the KP0 key to invoke the RESET function. (KP0 refers to the zero (0) key in the application keypad on the right hand side of the keyboard.)
Do not use the following functions when the cursor is in a protected field (a field that does not accept user input):
This section describes the keyboard functions. Preceding each function description are the key sequences for VT100 and VT200 terminals and the function name to use in a DEFINE/KEY command. In many of the key sequences, TN3270 allows use of the extended function (EXT) feature. Used in conjunction with another key, EXT allows access to an extended function for that key. The following illustrates the extended function feature in more detail.
|VT100: EXT + E||VT200: EXT + Find|
|DEFINE_KEY Function: ATTACH|
Changes control from one subprocess to another subprocess or to the parent process. When you invoke the ATTACH function, TN3270 uses the name of the last process to which you attached as the default process name.
If you want to attach to a different process, press Ctrl/U to erase the default process name. You can then enter the process name of your choice at the prompt. The process name can be a quoted string. Use the quotation marks to preserve spaces, tabs, or lowercase letters in strings.
|VT100: EXT + A||VT200: F19|
|DEFINE_KEY Function: ATTENTION|
Provides a way to "get the attention of" the remote application program that you are running by sending a SIGNAL RU command to the remote host. See the user's guide of the particular application program to learn what response the program gives when you use this key.
Back Tab (| Left arrow)
|VT100: BACKSPACE||VT200: F12|
|DEFINE_KEY Function: BACK_TAB|
On an unformatted screen, the cursor returns to the first position on the screen.
Cent Sign (¢)
|VT100: EXT + C||VT200: EXT + C|
|DEFINE_KEY Function: (None)|
|VT100: EXT + Enter||VT200: EXT + F20|
|DEFINE_KEY Function: CLEAR|
DEF KEY (DEFINE key)
|VT100: Ctrl/K||VT200: Ctrl/K|
|DEFINE_KEY Function: DEFINE_KEY|
Lets you interactively define or redefine a key. You get a prompt for the name of the key to define and for a function you want to assign to that key. Refer to Section 4.12.9 for more information about using the DEF KEY function.
|VT100: Delete||VT200: <X]|
|DEFINE_KEY Function: DELETE|
Deletes the character at the cursor. The cursor remains where it is, and the other characters to the right of the cursor in the same field move one position to the left. The end of the field fills with blanks. Note that this is not the action normally associated with the Delete key on keyboards.
DSP ATT (display attributes)
|VT100: Ctrl/V||VT200: EXT + F17|
|DEFINE_KEY Function: DISPLAY_ATTRIBUTES|
Enables and disables the visible attribute mode. This mode of operation forces display of the attribute characters (that is, the characters at the start of a field that indicate the display and data type of that field). In IBM 3270 model terminal emulation (TN3270), you can use the DSP ATT function to debug application programs, as explained in Section 4.12.10.
|VT100: EXT + *||VT200: EXT + F12|
|DEFINE_KEY Function: DUP|
After entering the data in the field on the first form, use the DUP function when at the same field on succeeding forms. The application program makes the necessary translation, filling in these fields with the same value. For details about the use of this key, refer to the user's guide of the particular application program.
Displays an asterisk (*).
DV CNCL (device cancel)
|VT100: EXT + U||VT200: EXT + Remove|
|DEFINE_KEY Function: DVCNCL|
Cancels the RECORD function. Use the DV CNCL function if you begin using the RECORD function and then decide you want to stop. If you want to delete a sequence that has already been recorded on a PF key, use the RECORD function, press the PF key, and then use the DV CNCL function.
|VT100: Line Feed + Enter||VT200: Do + Enter|
|DEFINE_KEY Function: ENTER|
Sends your input to the remote application program. While this communication is active, the keyboard locks and indicator Inhib appears on the status line. Usually the application program releases the keyboard when it has finished processing your input.
ER EOF (erase to the end of the field)
|VT100: EXT + KP,||VT200: F18|
|DEFINE_KEY Function: ERASE_EOF|
ER INP (erase input)
|VT100: EXT + KP-||VT200: EXT + F18|
|DEFINE_KEY Function: ERASE_INPUT|
On an unformatted screen, clears all the data and moves the cursor to the first position on the screen.
You can also use the ER INP function to remove all previously recorded key sequences by using the RECORD function and then the ER INP function.
|VT100: Ctrl/Z or F10||VT200: Ctrl/Z or F10|
|DEFINE_KEY Function: EXIT|
Terminates the remote TELNET/TN3270 session. Aborts any exchange of data in progress between the local and remote hosts. Note that terminating a session with the IBM host in this way may result in improper termination of the session. For the appropriate logoff command string, see the user's guide for the IBM application with which you are communicating.
EXT (extended function)
|VT100: KP.||VT200: KP.|
|DEFINE_KEY Function: EXTEND|
Used in conjunction with another key, allows access to an extended function for that key. First invoke the EXT function, and then press the second key. If you invoke EXT accidentally, invoke the RESET function to cancel the EXT function.
If the status display is enabled when you invoke the EXT function, the word Extend appears on the status line.
FM (field mark)
|VT100: EXT + ;||VT200: EXT + F13|
|DEFINE_KEY Function: FM|
Specifies the end of a field on an unformatted screen or the end of part of an unprotected field on a formatted screen. Refer to the user's guide of the remote application program for specific use of this key.
Displays a semicolon ( ; ).
|VT100: EXT + H||VT200: Help|
|DEFINE_KEY Function: HELP|
|VT100: EXT + B||VT200: F13|
|DEFINE_KEY Function: HOME|
Horizontal Control (Right arrow and Left arrow)
|VT100: Right arrow or Left arrow||VT200: Right arrow or Left arrow|
|DEFINE_KEY Function: RIGHT, RIGHT_NOWRAP, LEFT, or LEFT_NOWRAP|
|VT100: EXT + PF4||VT200: F14|
|DEFINE_KEY Function: INSERT_MODE|
In insert mode, when you enter a character into an unprotected field, it is displayed to the left of the cursor, moving the following display elements one position to the right:
You can insert characters into following:
If you attempt to insert characters after the field is full, the keyboard locks, the terminal bell rings, and the word Inhib appears on the status line. If the keyboard locks when you try to insert characters into a field that looks empty, the field might have trailing spaces. To delete these spaces, use the ER EOF function.
To return your screen to the normal mode of entry, use one of the following keyboard functions:
Logical NOT (| --)
|VT100: EXT + N||VT200: EXT + N|
|DEFINE_KEY Function: (None)|
Logical OR (|)
|VT100: EXT + O||VT200: EXT + O|
|DEFINE_KEY Function: (None)|
New Line (hooked left arrow)
|VT100: Return||VT200: Return|
|DEFINE_KEY Function: NEWLINE|
Moves the cursor to the first unprotected position on the next line of your screen. If no unprotected fields are on the screen when you invoke the new line function, the cursor moves to the first location on the screen. If the screen has no fields, this key has the same function as the Return key.
NUM OVR (numeric lock override)
|VT100: EXT + J||VT200: Remove|
|DEFINE_KEY Function: NUMOVR|
Lets you enter nonnumeric characters into numeric fields. Once you enable this function, use NUM OVR again to disable it. If you do not disable the numeric lock override, it remains enabled even after you exit from TN3270. The letter O appears on the status line to indicate that the numeric lock override is in effect.
PA1, PA2, PA3
|VT100: PF4 , KP- , KP,||VT200: PF4 , KP- , KP,|
|DEFINE_KEY Function: PA1--PA3|
These program access keys are defined by the program you are using. These keys request attention from the remote application program without sending any data. You should refer to the user's guide of your application program to learn how the PA keys are defined.
PF1 through PF24
|VT100: see table||VT200: see table|
|DEFINE_KEY Function: PF1--PF24|
These program function keys are defined by the remote application program you are using. They request attention from the application program and send the data entered to the host. The PF keys are coded by the application program to perform functions relating to the application. A particular PF key may be coded differently from one application to another. The user's guide of the remote application program usually defines the specific PF key assignments for that application program.
|Press This Key or
|PF13||EXT + PF1|
|PF14||EXT + PF2|
|PF15||EXT + PF3|
|PF16||EXT + KP7|
|PF17||EXT + KP8|
|PF18||EXT + KP9|
|PF19||EXT + KP4|
|PF20||EXT + KP5|
|PF21||EXT + KP6|
|PF22||EXT + KP1|
|PF23||EXT + KP2|
|PF24||EXT + KP3|
|VT100: EXT + M||VT200: Insert Here|
|DEFINE_KEY Function: PLAY|
Recalls keystroke sequences stored on PF keys using the RECORD function. Invoke the PLAY function and then press the PF key on which the desired key sequence is stored. The PLAY function executes all commands included in the keystroke sequence.
If the HELP utility is invoked in your key sequence, the PLAY function continues until you exit from the HELP utility. Also, if you use functions that require you to respond to prompts (such as ATTACH, DEF KEY, SET FIL, or SPAWN), the information you enter at the prompt is not recorded. When you recall the sequence, the system prompts you for this information again.
The letter P appears on the status line if the status display is enabled.
|VT100: EXT + P||VT200: F11|
|DEFINE_KEY Function: PRINT|
Records the contents of your screen in a file or at a printer. (This is a local print feature.) If the status display is enabled when you use the PRINT function, the word Print appears on the status line. Your screen refreshes when the printing process completes.