HPlogo Using SNA IMF Pass Thru: HP 3000 MPE/iX Computer Systems > Chapter 5 Using Terminals with Pass Thru

HP and IBM Terminal Keys

» 

Technical documentation

» Feedback

 » Table of Contents

 » Glossary

 » Index

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 “IBM and HP Keyboard Functions” 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 to the left. If the cursor is in column 0, it puts the cursor in the last character position on the screen (bottom right).

[BACKSPACE] moves the cursor one column to the left. If the cursor is in column 0, it remains there.

(BACKTAB)moves the cursor to the previous unprotected field.

[SHIFT]-[TAB] operates on one line at a time. 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

[ERASE EOF] Puts nulls in the character position occupied by the cursor and all later character positions in the field (if the cursor is within an unprotected field). Sets the MDT for the field on. If the cursor is within a protected field, [ERASE EOF] inhibits input and does not change any characters.

[CLEAR DISPLAY] for a 264x terminal or [CLEAR LINE] for a 23xx/262x terminal puts blanks in the character position occupied by the cursor and all later character positions in the field (if the cursor is within an unprotected field). If the cursor is in a protected field or on an attribute 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 INPUT] sets all unprotected character positions to nulls, resets the MDT to 0, and resets the cursor to the first position on the screen.

[CLEAR DISPLAY] clears and fills with blanks (or nulls, on a 700/94 terminal with null support) all unprotected fields, from the 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

[INSERT] inserts new characters at the cursor position. Shifts all characters from the right of the cursor position one position to the right until the field is full. After that, [INSERT] inhibits input

[INSERT CHAR] inserts new characters at the current cursor position. Shifts all characters from the right of the cursor one position to the right. Characters that are 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 “Configuring Pass Thru”)

(RETURN) returns the cursor to column 0 of the following line on the screen. If you are on the last line, this key moves the cursor to column 0 of the first line.

[RETURN] key (with auto-linefeed set) returns the cursor to column 0 of the following line on the screen.

[SYS REQ]

Available as a softkey function (see Chapter 2 “Configuring Pass Thru”)

(TAB) moves the cursor to the start of data in the next unprotected field.

[TAB] moves the cursor either to the start of 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 “Configuring Pass Thru”)

 

HP Terminal Keys that Function Normally in Pass Thru

The following HP terminal keys perform their normal functions in Pass Thru:

  • [CAPS LOCK]

  • [INSERT CHAR]

  • [DELETE CHAR]

  • [CLEAR DISPLAY]

  • [HOME UP]

  • [RESET]

  • Cursor position keys

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 [RESET] key 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 in Pass Thru

The following keys do not perform their normal functions in Pass Thru:

  • The [BREAK] key is always disabled. Use the EXIT softkey to 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 [ENTER] key instead of the [RETURN] rather than in line mode. In Pass Thru, the [RETURN] key only moves the cursor; no data is transferred 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 keys or 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 “3270 Bit Assignment and Character Translation Tables”

Default Softkey Functions

The default softkey functions on HP 23xx, 264x, and 262x terminals are shown in Figure 5-1 “Default Softkey Functions”. These functions correspond to certain keyboard functions on an IBM 3278 display station.

Figure 5-1 Default Softkey Functions

Default Softkey Functions

Table 5-2 “Default Softkey Functions” 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 “Starting Pass Thru”)

[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] key to 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 LEVELn softkey functions are for changing levels.

Table 5-3 “User-Defined Softkey Functions” 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 “Configuring Pass Thru”

LEVELn

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.

PA1, PA2, and PA3

Specifying one of these keys notifies the host that you pressed that 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 “Configuring Pass Thru”

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 “Configuring Pass Thru”

 

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 “Example User-Defined Softkeys Functions” 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 “Example User-Defined Softkeys Functions” 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 Softkeys Functions

Example User-Defined Softkeys 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-1 “IBM and HP Keyboard Functions” 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 5240 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 Attributes

[PF5]

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] pressed 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 reset on 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.
Feedback to webmaster