HP and IBM Terminal Keys [ Using SNA IMF Pass Thru ] MPE/iX 5.0 Documentation
Using SNA IMF Pass Thru
HP and IBM Terminal Keys
Some keys on an IBM 3278 have no corresponding key on an HP terminal.
Sometimes, you can substitute keys on an HP terminal for keys on an IBM
terminal. This section describes the differences and similarities
between the keys on an HP terminal and the keys on an IBM 3278 display
station.
Table 5-1 compares the keyboard functions of IBM and HP terminals.
Table 5-1. IBM and HP Keyboard Functions
-------------------------------------------------------------------------------------------
| |
| IBM 3278 Keyboard Function HP Terminal Keyboard Function |
| |
-------------------------------------------------------------------------------------------
| |
| ALT CURSR Not available |
| |
| Audible click Not available |
| |
| <- (BACKSPACE) moves the cursor one column BACKSPACEmoves the cursor one column to the |
| to the left. If the cursor is in column 0, left. If the cursor is in column 0, it |
| it puts the cursor in the last character remains there. |
| position on the screen (bottom right). |
| |
| |<- (BACKTAB)moves the cursor to the SHIFT-TAB operates on one line at a time. |
| previous unprotected field. If a field extends over three lines, and |
| your cursor is at the end of the field, one |
| SHIFT-TAB moves the cursor to column 1 of |
| the same row; a second SHIFT-TAB moves the |
| cursor to column 1 of the previous row; and |
| a third SHIFT-TAB moves the cursor to the |
| start of the field. If the first character |
| of a field is in the same row as your |
| cursor, SHIFT-TAB works just like the |<- |
| (BACKTAB) key on a 3278. |
| |
| CURSR BLINK Not available |
| |
| CURSR SELECT Not available |
| |
| DEV CNCL Not available |
| |
| DUP Not available |
| |
-------------------------------------------------------------------------------------------
Table 5-1. IBM and HP Keyboard Functions (cont.)
-------------------------------------------------------------------------------------------
| |
| IBM 3278 Keyboard Function HP Terminal Keyboard Function |
| |
-------------------------------------------------------------------------------------------
| |
| ERASE EOFPuts nulls in the character CLEAR DISPLAYfor a 264x terminal or CLEAR |
| position occupied by the cursor and all LINEfor a 23xx/262x terminal puts blanks in |
| later character positions in the field (if the character position occupied by the |
| the cursor is within an unprotected field). cursor and all later character positions in |
| Sets the MDT for the field on. If the the field (if the cursor is within an |
| cursor is within a protected field, ERASE unprotected field). If the cursor is in a |
| EOF inhibits input and does not change any protected field or on an attribute |
| characters. character when you press CLEAR DISPLAY, it |
| moves the cursor to the start of the next |
| unprotected field and clears that field and |
| subsequent fields. It also sets the MDT if |
| the field was not already blank. |
| |
| ERASE INPUTsets all unprotected character CLEAR DISPLAYclears and fills with blanks |
| positions to nulls, resets the MDT to 0, (or nulls, on a 700/94 terminal with null |
| and resets the cursor to the first position support) all unprotected fields, from the |
| on the screen. cursor position to the end of terminal |
| memory. It sets the MDT if the field was |
| not already null. |
| |
| FIELD MARK Not available |
| |
| IDENT Not available |
| |
| INSERTinserts new characters at the cursor INSERT CHARinserts new characters at the |
| position. Shifts all characters from the current cursor position. Shifts all |
| right of the cursor position one position characters from the right of the cursor one |
| to the right until the field is full. position to the right. Characters that are |
| After that, INSERT inhibits input. moved past the right margin of the screen |
| are lost. Therefore, you are limited to |
| inserting one row of characters at a time. |
| |
| PRINT Available as a softkey function (see |
| chapter 2). |
| |
| [[CR]] (RETURN) returns the cursor to The RETURNkey (with auto-linefeedset) |
| column 0 of the following line on the returns the cursor to column 0 of the |
| screen. If you are on the last line, this following line on the screen. |
| key moves the cursor to column 0 of the |
| first line. |
| |
| SYS REQ Available as a softkey function (see |
| chapter 2). |
| |
-------------------------------------------------------------------------------------------
Table 5-1. IBM and HP Keyboard Functions (cont.)
-------------------------------------------------------------------------------------------
| |
| IBM 3278 Keyboard Function HP Terminal Keyboard Function |
| |
-------------------------------------------------------------------------------------------
| |
| ->| (TAB)moves the cursor to the start of TABmoves the cursor either to the start of |
| data in the next unprotected field. data in the next unprotected field or to |
| the first position of the next row if the |
| field wraps multiple lines and the HP |
| terminal supports MDTs (currently 2624, |
| 2625, 2394, and 150). |
| |
| TEST/SRK Available as a softkey function (see |
| chapter 2). |
| |
-------------------------------------------------------------------------------------------
HP Terminal Keys that Function Normally inPass Thru
The following HP terminal keys perform their normal functions in Pass
Thru:
* CAPS LOCK
* INSERT CHAR
* DELETE CHAR
* CLEAR DISPLAY
* HOME UP
* RESETterminal key (soft reset only)
* Cursor position keys:
uparrow
downarrow
<-
->
If you press the RESET key once on any HP terminal except the 2640B,
2640N, and 2640S, a soft reset occurs. A soft reset is similar to the
function of the RESET key on an IBM 3278 display station, so you can use
the RESET key on your HP terminal the way you would use the RESETkey on
an IBM 3278 display station.
CAUTION Do not use the RESET key on the HP 2640B, 2640N, and 2640S
because it causes a hard reset. You may not be able to recover
from a hard reset. Also, do not press the RESET key more than
once within 0.5 seconds because 264x terminals treat such a
sequence as a hard reset.
HP Terminal Keys that Function Differently inPass Thru
The following keys do not perform their normal functions in Pass Thru:
* The BREAKkey is always disabled. Use the EXIT softkeyto end Pass
Thru for your terminal.
* Use CTRL-R to recover from a hard reset. The TAB key moves the
cursor to the next unprotected field. Use the CLEAR DISPLAY key
to clear all unprotected fields from the screen.
* The CTRL-Y function is ignored. Use the EXIT softkey to end Pass
Thru for your terminal.
* Use the ENTERkey instead of the RETURNkey because Pass Thru
terminals operate in block moderather than in line mode. In Pass
Thru, the RETURN key only moves the cursor;no data is transfered
to the host. To send data through the HP 3000 to the IBM host,
you must press ENTER or a softkey corresponding to one of the
following IBM 3278 keys: PA1, PA2, PA3, CLEAR, or SYS REQ.
Function Keys (Softkeys)
A set of eight keys on HP 3000 terminals, called function keysor
softkeys, can be configured to perform various terminal operating
functions, such as I/O device operations and data transfer operations.
The function keys are f1, f2, f3, f4, f5, f6, f7, and f8.
SNA IMF provides a set of default functions for your softkeys. You can
use the default configuration, or you can specify a different set of
softkey functions in your PTCONFIG file when you configure Pass Thru.
For more information on softkey functions and configuration, see chapter
2, "Configuring Pass Thru."
If you are using a 264x terminal, you can get an SNA IMF Function Key
Template(7120-8716) to label the functions of your softkeys.
When you press a function key, SNA IMF sends an attention ID (AID)code to
the IBM host, telling it what key you pressed. The AID codes associated
with the function keys on your HP terminal are the same AID codes
associated with certain keys on an IBM 3278 display station. The AID
codes generated by SNA IMF are listed in appendix E.
Default Softkey Functions.
The default softkey functions on HP 23xx, 264x, and 262x terminals are
shown in figure 5-1. These functions correspond to certain keyboard
functions on an IBM 3278 display station.
Figure 5-1. Default Softkey Functions
Table 5-2 describes the default softkey functions for 23xx, 262x, and
264x terminals.
Table 5-2. Default Softkey Functions
------------------------------------------------------------------------------------------
| |
| Key Function |
| |
| f1 (PF1-PF24) |
| The f1 key represents the 24 Program Function (PF) keys of an IBM 3278. |
| When you press f1, the current contents of your terminal's buffer is |
| temporarily stored, and the following prompt appears on your screen: |
| PROGRAM FUNCTION KEY NUMBER? Respond by entering the number of the IBM |
| PF key you want; then press the ENTER key. The modified, unprotected |
| data from your screen image is sent to the host, along with the AID of |
| the PF key you specified. |
| |
| f2 (SYSTEM REQUEST) |
| The f2 key sends a special protocol sequence to the host. Use this key |
| to communicate with the System Services Control Point (SSCP). The SSCP |
| controls the resources of an SNA domain and enables you to do such |
| things as log on and off. |
| |
| f3, f4, f5 (PA1, PA2, and PA3) |
| The host application program defines the functions of these keys. When |
| you press the f3, f4, or f5 key, SNA IMF notifies the host that you |
| pressed that key. |
| |
| f6 (CLEAR) |
| Pressing f6 clears the screen, moves the cursor to the home position, |
| and sends a CLEAR KEY PRESSED message to the host. |
| |
| f7 (PRINT) |
| Pressing the f7 key makes a copy of the internal screen image and sends |
| it to an output file. The format of the internal screen image is |
| determined by the format parameter in the info string when Pass Thru is |
| started. (See chapter 3.) |
| |
| f8 (EXIT) |
| Pressing the f8 key at a terminal ends Pass Thru only for that |
| particular terminal and returns the terminal to the control of MPE. |
| |
------------------------------------------------------------------------------------------
User-Defined Softkey Functions.
An IBM 3278 Display Station has 24 function keys, and an HP terminal has
8 function keys. Although HP terminals do not have as many function keys
as IBM terminals, an HP feature called rolling softkeys allows you to
create several levels of softkey functions, so a function key can perform
different functions at different levels. The rolling softkeys feature
lets you map your HP terminal function keys to the function keys on an
IBM 3278 display station.
The first HP terminal function key (f1) is reserved for the main softkey
menu; you can define the functions of the other seven function keys in
the PTCONFIG file. See chapter 2, "Configuring Pass Thru," for more
information about configuring your rolling softkeys.
SNA IMF provides a set of default functions for your softkeys. (See
"Default Softkey Functions," earlier in this chapter.) You can use the
defaults, or you can configure a set of softkeys that suits your own
needs.
The rolling softkeys feature allows you to do the following:
* Configure a function key to perform a single softkey function, or
configure it as a menu key, which brings up a new set of softkey
functions for all the function keys.
* Label the functions of your softkeys in windows on the terminal
screen.
* On certain HP terminals, double the number of emulated softkeys by
using the SHIFT keyto produce uppercase and lowercase softkeys.
The rolling softkeys feature allows you to map several sets of variable
softkeys to your 8 function keys. For a terminal that supports shifted
function keys (a 16-function key terminal), you can define up to 6 levels
of softkeys. For a terminal that does not support shifted function keys
(an 8-function key terminal), you can define up to 12 levels of softkeys.
In each level, you must define at least one softkey for changing levels.
The NEXT and LEVEL n softkey functions are for changing levels.
Table 5-3 describes the user-definable softkey functions for 23xx, 262x,
and 264x terminals. For more information on softkey functions and
configuring your function keys, see chapter 2, "Configuring Pass Thru."
Table 5-3. User-Defined Softkey Functions
------------------------------------------------------------------------------------------
| |
| Key Function |
| |
| CLEAR Emulates the IBM 3278 CLEAR key. Moves the cursor to home position, |
| clears the screen, and sends a CLEAR KEY PRESSED message to the IBM |
| host. |
| |
| CLPRT Closes your local print spool file (LOGIMF) and prints it while your |
| session is still active. Then a new LOGIMF file is opened. If you |
| need to send your output to a disc file instead of a spool file, enter |
| the following file equation at the MPE colon prompt before you start |
| your Pass Thru session: (This is the only file equation that works.) |
| |
| FILE LOGIMF,NEW;DEV=DISC;REC=-133,,,ASCII;NOCCTL;SAVE |
| |
| EXIT Ends Pass Thru for your terminal only and returns the terminal to MPE |
| control. |
| |
| LBNULL Tells Pass Thru to convert leading blanks to nulls before transmitting |
| data to the IBM host. For more information, see "Leading Blanks, |
| Trailing Blanks, and Trailing Nulls," in chapter 2. |
| |
| LEVEL n Rolls the softkeys to the specified level. The value of n can be 1 |
| through 6, for terminals that support shifted function keys, or 1 |
| through 12, for terminals that do not support shifted function keys. |
| If level 12 does not exist, this function rolls the function keys over |
| to level 1. |
| |
| MENU Displays the Pass Thru softkey menu and prints this prompt on your |
| terminal's screen: ENTER 1-24, PA1, PA2, PA3, CLEAR, SRK, PRINT, |
| CLPRT, and EXIT. Answer this prompt by entering the number of an IBM PF |
| key or the character string for the softkey you want. |
| |
| MPEXLCIP (SNA IMF/XL only) Suspends your Pass Thru session and creates an MPE XL |
| command interpreter process. A colon prompt appears on your screen, |
| and you can enter MPE commands. To return to your Pass Thru session, |
| type EXIT at the MPE colon prompt. See "Using the MPE Command |
| Interpreter from Pass Thru," later in this chapter. |
| |
| NEXT Rolls the function keys to the next level of softkey functions. |
| |
------------------------------------------------------------------------------------------
Table 5-3. User-Defined Softkey Functions (cont.)
------------------------------------------------------------------------------------------
| |
| Key Function |
| |
| PA1, PA2, and Specifying one of these keys notifies the host that you pressed that |
| PA3 key. The IBM host application defines the functions of these keys. |
| |
| PF1-PF24 These softkey functions correspond to the 24 PF keys of an IBM 3278 |
| display station. |
| |
| PRINT Sends a copy of the internal screen image to an output file. The |
| format of the internal screen image is determined by the format |
| parameter you specify in the info string when you start Pass Thru. |
| |
| RESET Emulates the 3278 RESET key. It unlocks the keyboard and enables |
| input. This function issues the RESET3270 intrinsic, described in the |
| SNA IMF Programmer's Reference Manual. |
| |
| STATUS Displays status information about your LU-LU session on your terminal |
| screen. See "Displaying SNA Session Status Information," later in this |
| chapter. |
| |
| SRK (System Request Key) Pressing the SRK key sends a special protocol |
| sequence to the host. Use this key to communicate with the System |
| Services Control Point (SSCP). The SSCP controls the resources of an |
| SNA domain and enables you to do such things as log on and off. |
| |
| TBNULL This key tells Pass Thru to send trailing blanks for non-null |
| characters sent by the IBM host. See "Leading Blanks, Trailing Blanks, |
| and Trailing Nulls," in chapter 2. |
| |
| TNBLANK This key tells Pass Thru to convert trailing nulls to blanks before |
| sending data to the IBM host. See "Leading Blanks, Trailing Blanks, |
| and Trailing Nulls," in chapter 2. |
| |
------------------------------------------------------------------------------------------
Chapter 2, "Configuring Pass Thru," tells you how to specify your own
rolling softkeys by creating a configuration file called PTCONFIG. If you
use another name for your configuration file, you must equate that name
to the name PTCONFIG using an MPE file equation. You can assign softkey
functions to keys f2 through f8. You cannot define the f1 function key,
because it is reserved for the softkey menu; however, you can define the
shifted f1 key.
In the PTCONFIG file, you can also define the softkey labels that appear
on your screen, telling you which functions your softkeys have at the
current level.
Figure 5-2 illustrates an example softkey configuration. This
configuration defines four levels of softkeys. The lowest level (level
1) has softkeys that take you to the other three levels. Each of the
upper levels has one softkey that takes you back to the lowest level.
The f1 key is the menu key in all four levels.
The upper three levels of softkeys in this configuration correspond to
three IBM host applications: TSO, CICS, and a user application called
APPL. Each application requires a slightly different set of softkeys, so
a different level is assigned to each application. In this example, only
8 softkeys are defined in each level; however, if your terminal supports
shifted function keys, you can define up to 16 softkeys for each level.
When you start Pass Thru, the softkey labels on your screen indicate that
you are on level 1. If you started Pass Thru to communicate with CICS,
you would press the softkey labeled "CICS." The function assigned to the
"CICS" softkey is LEVEL3, so pressing the softkey labeled "CICS" would
take you to level 3.
The quoted strings in figure 5-2 are the softkey labels configured for
each softkey function. Softkey labels appear on your screen, telling you
which functions your softkeys have at the current level.
Figure 5-2. Example User-Defined Softkey Functions
Softkeys for 3270-to-5250 Communication.
When you use Pass Thru to communicate with an application on an IBM
AS/400, your 3270 data stream must be translated to 5250 data. The 3270
emulation software on the AS/400 provides a mapping between Pass Thru's
softkey functions and 5250 key functions. Table 5-4 lists the 5250 key
functions and the 3270 softkeys that you push to send 5250 keys to the
AS/400.
Table 5-4. AS/400 5250 to Pass Thru 3270 Mappings
------------------------------------------------------------------------------------------
| |
| 5250 key function 3270 softkeys pressed to select 5250 function |
| |
| Help PF1 |
| |
| 3270 Help PF2 |
| |
| Clear PF3 |
| |
| Print PF4 |
| |
| Display Embedded PF5 |
| Attributes |
| |
| Test Request PF6 |
| |
| Roll Down PF7 |
| |
| Roll Up PF8 |
| |
| Error Reset PF10 |
| |
| System Request PF11 |
| |
| Record Backspace PF12 |
| |
| F1 through F12 Press PA1, wait for system to respond, then press the desired |
| function key (PF1 through PF12). |
| |
| F13 through F24 Press PA2, wait for system to respond, then press the desired |
| function key (PF13 through PF24). If your keyboard does not |
| have keys PF13 through PF24, use keys PF1 through PF12. For |
| example, to send F15, press PA2, then PF3. |
| |
| Field Exit Clear Line, then TAB. |
| |
| Attention SYS REQ, then PA1. |
| |
------------------------------------------------------------------------------------------
HP Terminal Keys That Are Invalid in Pass Thru
Do not use the following HP terminal keys with Pass Thru:
* Graphic keys on the 2648A terminal.
* ESC, MEMORY LOCK, DISPLAY FUNCTION, NEXT PAGE, and PREVIOUS PAGE.
* RESET keypressed once on the 2640B, 2640N, and 2640S terminal, or
the RESET key pressed twice within 0.5 seconds (a hard reset), on
either the 2645 or 2648 terminals. Both of these actions will
cause a hard reset.
CAUTION Do not do a hard reseton an HP terminal that is operating under
Pass Thru; you may not be able to recover from it. You can
produce a hard reset in two ways. The first way is by pressing
the RESET] key once on the HP 2640B, 2640N, and 2640S. Because
Pass Thru does not lock the keyboard on these terminals, RESET
is unnecessary. The other way to produce a hard reset is by
pressing the RESET key twice within 0.5 seconds on either the HP
2645 or 2648 terminal. This clears the special environment
created on the terminal when Pass Thru took control. As with
the first type of hard reset, there is no guarantee of recovery.
MPE/iX 5.0 Documentation