The options listed below under "Additional Information Available"
describe 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.
1 – ATTACH
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.
2 – ATTN
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.
3 – Back Tab
VT100: BACKSPACE VT200: F12
DEFINE_KEY Function: BACK_TAB
Moves the cursor, depending on the type of screen. On a formatted
screen, the cursor moves one of the following ways, depending on
the cursor's location when you press this key:
o If the cursor is in a field, but not at the first position of
the field, it moves to the beginning of the unprotected field
that it is in.
o If the cursor is in the first position of a field, it moves
to the beginning of the preceding unprotected field. If the
cursor is in the first position of the first unprotected
field, the cursor moves to the first position of the last
unprotected field on the screen.
On an unformatted screen, the cursor returns to the first
position on the screen.
4 – Cent Sign
VT100: EXT + C VT200: EXT + C
DEFINE_KEY Function: (None)
Enters a cent sign. If your terminal does not have this
character, your screen displays a hyphen ( - ).
5 – CLEAR
VT100: EXT + Enter VT200: EXT + F20
DEFINE_KEY Function: CLEAR
Clears the screen and moves the cursor to the first position
on the screen. When you invoke the CLEAR function, the software
notifies the application program that this function has been
used.
6 – DEF_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.
7 – DELETE
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.
8 – DSP_ATT
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.
9 – DUP
VT100: EXT + * VT200: EXT + F12
DEFINE_KEY Function: DUP
Lets you enter a value in the same field in several forms without
needing to repeat the entry for each form.
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 (*).
10 – DV_CNCL
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.
11 – ENTER
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.
12 – ER_EOF
VT100: EXT + KP, VT200: F18
DEFINE_KEY Function: ERASE_EOF
Erases the contents of the current field, from the location of
the cursor to the end of the field. The cursor remains in the
same location.
13 – ER_INP
VT100: EXT + KP- VT200: EXT + F18
DEFINE_KEY Function: ERASE_INPUT
On a formatted screen, clears all the data in the unprotected
fields on your screen and moves the cursor to the first position
in the first unprotected field on the screen.
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.
14 – EXIT
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.
15 – EXT
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.
16 – FM
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 ( ; ).
17 – HELP
VT100: EXT + H VT200: Help
DEFINE_KEY Function: HELP
Displays online help and an illustration of the TN3270 keyboard.
18 – HOME
VT100: EXT + B VT200: F13
DEFINE_KEY Function: HOME
Repositions the cursor to the first position in the first
unprotected field on the screen (that is, to the beginning of
the input area on the screen).
19 – Left/Right Arrows
VT100: Right arrow or VT200: Right arrow or Left arrow
Left arrow
DEFINE_KEY Function: RIGHT, RIGHT_NOWRAP, LEFT, or LEFT_NOWRAP
Moves the cursor horizontally across your screen without changing
data you have already entered. Note the following about cursor
behavior:
o If the cursor is at the end of a line when you use the Right
arrow function, the cursor moves to the start of the next
line.
o If the cursor is at the beginning of a line when you use
the Left arrow function, the cursor moves to the end of the
previous line.
If the screen display you receive is wider than 80 columns,
you can use the Right arrow and Left arrow functions to move
through the display.
If you want the cursor to wrap to the opposite edge of the
display, use one of the following function sequences:
EXT + Right arrow
EXT + Left arrow
20 – INSERT
VT100: EXT + PF4 VT200: F14
DEFINE_KEY Function: INSERT_MODE
Enables insert mode. Use insert mode to edit what you entered. If
the status display is enabled, the word Insert appears.
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:
o The cursor
o The character at the cursor location
o All the characters to the right of the cursor in the field
You can insert characters into following:
o An unformatted screen
o An unprotected field on a formatted screen until it is full
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:
o RESET
o CLEAR
o ENTER
o Any PA key
o Any PF key
21 – Logical Not
VT100: EXT + N VT200: EXT + N
DEFINE_KEY Function: (None)
Represents the remote host's symbol for a logical NOT; displayed
as a circumflex ( ^ ).
22 – Logical Or
VT100: EXT + O VT200: EXT + O
DEFINE_KEY Function: (None)
Represents the remote host's symbol for a logical OR; displayed
as a solid vertical line from the terminal's graphics set. Press
Ext + O if the vertical bar is not available on your keyboard.
23 – New Line
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.
24 – NUM_OVR
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.
25 – PA Keys
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.
26 – PF Keys
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.
To
Implement
This Press This Key or
Function Key Combination
PF1 PF1
PF2 PF2
PF3 PF3
PF4 KP7
PF5 KP8
PF6 KP9
PF7 KP4
PF8 KP5
PF9 KP6
PF10 KP1
PF11 KP2
PF12 KP3
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
27 – PLAY
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.
28 – PRINT
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.
The first use of PRINT in a given run of TN3270 creates a new
version of the output file. Successive uses of PRINT in the same
program cause the screen contents to append to the existing file.
If the output is directed to a printer, each use of PRINT creates
a separate entry in the printer queue. If the printer is a
spooled printer, the output is released for printing immediately.
To specify where to direct the output file, use the command
qualifier /PRINTER=file. The SET FIL function allows you to
change the name of the output file each time you invoke the PRINT
function.
29 – RECORD
VT100: EXT + L VT200: EXT + Insert Here
DEFINE_KEY Function: RECORD
Saves a keystroke sequence on a specific PF key. Invoke the
RECORD function with the appropriate key sequence, press the
PF key as prompted, enter the keystroke sequence, and then invoke
the RECORD function again. You can save a maximum number of 127
keystrokes on each PF key. If the status display is enabled when
you use the RECORD function, the letter R appears on the status
line.
To recall the keystroke sequence, use the PLAY function. To
cancel the RECORD function, use the DV CNCL function. To erase
all previously recorded key sequences, use the ER INP function.
30 – REFR
VT100: Ctrl/W VT200: Ctrl/W or F20
DEFINE_KEY Function: REFRESH
Removes TN3270 error messages, operating system messages, or
other messages that appear on your screen. This key function
deletes extraneous characters from your screen and redisplays the
fields and data that were on the screen before the interruption.
This function does not transmit or receive data from the remote
host. It is a local OpenVMS function.
31 – RESET
VT100: KP0 VT200: KP0
DEFINE_KEY Function: RESET
Returns the keyboard to normal input mode from insert mode.
Also, the RESET function returns the keyboard to your control
after it locks when you try to enter data in to a protected or a
full field, or when you try to enter the wrong type of data in a
field.
Invoking RESET turns off the Inhib indicator. The cursor remains
where it is and the screen remains unchanged.
32 – SELECT
VT100: EXT + K VT200: Select
DEFINE_KEY Function: SELECT
Lets you choose items from a menu, table, or list and then notify
the program of your selection. Use the arrow keys to position
the cursor on the field designator character, then use the SELECT
function. For more information on using SELECT, refer to the
user's guide of the remote application.
33 – SET_FIL
VT100: EXT + F or Ctrl/F VT200: EXT + F11
DEFINE_KEY Function: SET_PRINTFILE
Lets you change the name of the file or device that receives
output each time you invoke the PRINT function. After you invoke
SET FIL, you are prompted for the name of a new output device,
emulating the remote host's IDENT function.
Note that if you specify the same name that is already in use,
subsequent PRINT operations direct output to a new version of the
same file.
34 – SHO_MSG
VT100: EXT + G VT200: EXT + F14
DEFINE_KEY Function: SHOW_MESSAGE
Displays the broadcast messages that have been posted on a
separate screen. If the status line is enabled, the indicator
Msg appears on the status line. If you do not read the messages
before they fill up the screen, the messages begin to scroll up
out of view and you can no longer read them. These broadcast
messages are not saved after you either read them or exit
TN3270.
35 – SPAWN
VT100: EXT + D VT200: Find
DEFINE_KEY Function: SPAWN
Creates a subprocess under the current process. Use the
LOGOUT command to terminate the subprocess. Because a tree of
subprocesses can be established using the SPAWN function, you
must be careful when terminating any process in the tree. When a
process is terminated, all subprocesses below that point in the
tree are terminated automatically.
When you create a subprocess, you can specify an optional command
string. The command string is executed within the created
subprocess, and the subprocess terminates upon completion of
the command.
36 – STATUS
VT100: EXT + S VT200: F17
DEFINE_KEY Function: STATUS
Lets you enable and disable the display of status information.
When you enable STATUS, the last line on your screen is painted
over with a reverse video strip. This line may conceal remote
host system or application information. If this occurs, the word
Hidden appears in the status line.
You can disable the status display by using the STATUS function
again.
37 – SYS_REQ
VT100: EXT + R VT200: EXT + F19
DEFINE_KEY Function: SYS_REQUEST
Lets you shift between the application program (the LU-LU
session) and the control program (the SSCP-LU session). If the
status display is enabled, the Appl or SSCP indicator appears
on the status line to indicate the type of session. Appl appears
when you are in an LU-LU session, and SSCP appears when you are
in the SSCP-LU session.
The screen is refreshed when you use the SYS REQ function.
38 – Tab
VT100: Tab VT200: Tab
DEFINE_KEY Function: TAB
Moves the cursor to the first character location of the next
unprotected field on your screen. If the screen has no fields,
the Right arrow function moves the cursor to the first location
on the screen.
If the cursor is within the last unprotected field on the screen,
the cursor moves to the first position of the first unprotected
field on the screen.
39 – Up/Down Arrows
VT100: Up arrow or Down VT200: Up arrow or Down arrow
arrow
DEFINE_KEY Function: UP, UP_NOWRAP, DOWN, or DOWN_NOWRAP
Moves the cursor vertically on your screen without altering
the data you have already entered. Note the following about the
cursor behavior:
o If the cursor is at the top of the screen when you press the
Up arrow, the cursor appears in the same column at the bottom
of the screen.
o If the cursor is at the bottom of the screen when you press
the Down arrow, the cursor appears in the same column at the
top of the screen
If the screen display you receive is larger than 24 rows
deep, you can use the Up arrow and the Down arrow keys to
move through the display. These keys scroll the screen display
up or down.
If you want the cursor to wrap to the opposite edge of
the display, use the key sequence EXT + Up arrow or
EXT + Down arrow.