5250 Help

5250 Help

Table of Contents

Using 5250 Help

This topic explains how to use 5250 online help.

The left panel of 5250 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. Note: Help text print is not available in DBCS languages (Japanese, Korean, Simplified Chinese, and Traditional Chinese).

Click the Exit button to end the help session.

Auto-Logon

This section describes how a System Administrator can create an auto-logon playback file (playback file that automatically starts at 5250 session start time). An auto-logon playback file can substitute the user's User ID and Password during playback. An auto-logon playback file is created as follows:

1) Start a 5250 session.

2) Click Record... and Start.

3) Click Pause (assuming the cursor is in the User ID entry field).

4) Enter your User ID in the User ID entry field (your User ID is not recorded).

5) Select Insert User ID at this point and click Continue Recording.

Note on steps 5 and 9: During playback, the User ID and Password (step 9) that were used on the user's initial 'IBM Server Login' are used during system logon. If the Authentication Server is different than the system providing this 5250 session, the user's User ID and Password should be the same. If not the same, you could select Pause playback at this point to allow the user to enter their User ID or Password on this system.

6) Press a key (for example, the Tab key) to move the cursor to the Password entry field.

7) Click Pause.

8) Enter your Password (your Password is not recorded).

9) Select Insert Password at this point and click Continue Recording. Note: Your 'IBM Server Login' Password will be used during auto-logon playback.

10) Press the Enter key. You may need to press other keys to remove system messages after the Enter key.

11) If you wish, you can add to the playback file. For example, you can start a specific system application.

12) Click Stop Recording.

13) Enter a name for this auto-logon playback file and click Save.

14) Now, start the IBM Network Station Manager program.

If you are creating an auto-logon playback file for yourself, you can skip steps 15 - 18.

15) Click 5250 to change 5250 preferences.

16) Select system default, group default, or user default to determine who has access to this auto-logon playback file.

17) Select the desired auto-logon playback file name from the list of playback sequences to make available.

18) Click Finish.

19) Click Startup.

20) Click Programs or Menus.

Note: When using Menus for auto-logon (creates a button on the task bar), the user's IBM Network Station will not be secure unless locked or logged out. If an IBM Network Station is left unlocked and a task bar menu button does auto-logon, anybody can log on to the system by clicking on the menu button. An alternative is to change step 9 above to select Pause playback at this point. This will require the user to enter their Password when starting the 5250 session.

21) Select system defaults, group defaults, or user defaults.

22) Enter a 5250 Program or Menu line: Menu item label (if a menu), system, optional title, and an other parameter of -playback (or -PLAYBACK) followed by the playback file name.

23) Click Finish.

24) If you desire both Programs and Menus, repeat steps 20 - 23.

25) If you are setting up the auto-logon playback file for multiple User defaults, repeat steps 15 - 24 for each user.

Note: If the auto-logon playback file does not work correctly, you can re-record the playback file and replace the existing playback file.

Note: If you playback this auto-logon playback file using the 5250 Playback... pull down, you will be required to enter your password.

Note: An administrator can create a system default or group default Startup (Programs or Menus) with a default -playback file. Individual users could create their own auto-logon playback file (starting their programs) with the same playback file name. These users must exclude the system or group default playback file in their 5250 preferences, so the user-level playback file is found.

Color Mapping

The 5250 Color Mapping program allows you to change the colors used in your 5250 sessions. Use of the 5250 Color Mapping program requires authorization from your System Administrator (using the IBM Network Station Manager program).

There are four levels of access to the 5250 Color Mapping program:

1) Advanced: You are allowed to use both the Basic and Advanced Color Mapping options.

2) Basic: You are allowed to use the Basic Color option (the Advanced button is unavailable).

3) Disabled: The Color Mapping option is grayed out, hence unavailable.

4) Hidden: The Color Mapping option does not appear in the pull down menu.

Note: An IBM Network Station typically supports up to 256 colors (using 1 Megabyte of Video RAM). After this limit is reached, false colors may produce confusing browser images. The five IBM basic color schemes match the colors used by the Network Station browser and Java. Advanced color schemes could use up to a maximum of 22 colors.

The Default Color Map Files topic describes how a System Administrator can create system default, group default, and user default color mapping files for IBM Network Station users.

The 5250 Color Mapping program has its own help text. See this help text for details on the 5250 Color Mapping program.

At the start of a 5250 session, the 5250 emulator searches for a color mapping file for the session. The following order is used; if a color mapping file is found, it is used for the 5250 session:

- Search for a session specific color mapping file that you selected using the Color Mapping program.

- Search for a default color mapping file that you selected using the Color Mapping program.

- Search for a user default color mapping file that your administrator selected for you.

- Search for a group default color mapping file that your administrator selected for your group.

- Search for a system default color mapping file that your administrator selected as a default for all IBM Network Station 5250 users.

- If none of the above is found, the 5250 emulator uses default colors (black background).

Column Separators

5250 sessions do not typically display column separators (dots between characters in certain types of AS/400 fields). You or your System Administrator can enable the display of column separators using the IBM Network Station Manager program.

Note: An error dialogue is displayed to the user while automatic error recovery is occuring. This allows the user to cancel the 5250 emulator session. If the 5250 emulator successfully recovers, the error dialogue is removed without user interaction.

Control Menu Bar Choice

Selecting Control menu bar option displays various AS/400 5250 keys. Selecting one of the keys performs the same function as if the user pushed this key on the keyboard. This is convenient when keys are difficult to locate on the keyboard.

Copy

Data from a 5250 session can be copied into the IBM Network Station 'clipboard buffer' and then pasted into this 5250 session, a different 5250 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 alternate way of marking a copy area is by pressing the secondary mouse button (usually the right one). This marks the data between the text cursor and the mouse pointer. The secondary mouse button can be used to adjust a marked copy area.

A block copy (rectangular area) is also available. Double click the secondary mouse button (within the IBM Network Station double click time) to mark a block copy area between the text cursor and the mouse pointer. The secondary mouse button can be used to adjust a marked block copy area.

Note: Copy cannot be started on an AS/400 hotspot (see Hotspots for more information), 5250 selection field, menu bar, pull down, button, or scroll bar. Furthermore, some AS/400 applications may program the primary mouse button to perform an application function instead of the Copy.

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.

Keyboard copy is also available: Copy data is marked by pressing and holding a shift key, pressing the primary mouse button (the shift key can now be released), moving the mouse pointer, and releasing the mouse button. The marked data is automatically copied into the clipboard buffer. A keyboard block copy area is marked by pressing and holding a shift key, pressing/releasing/pressing the primary mouse button (the shift key can now be released), moving the mouse pointer, and releasing the mouse button. The secondary mouse button can be used to adjust a marked copy area (recopy the copy area).

Cut

Data from a 5250 session can be cut (deleted) from an entry field and copied into the IBM Network Station 'clipboard buffer'. The cut data can then be pasted into this 5250 session, a different 5250 session, or a different application.

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).

See Paste for a description of pasting data during this session, or a different session.

See Copy for a description of copying data. Copy supports additional capabilities such as block copy (copy a rectangular area).

Default Color Map Files

The default background color for 5250 sessions is black. You can modify the colors used in your 5250 sessions by using the Color Mapping program (if you are authorized). Even if you are not authorized to use the Color Mapping program, you can use a default color scheme. See your System Administrator for details.

An administrator can use the 5250 Color Mapping program and IBM Network Station Manager program to create system default, group default, and user default color mapping files. Default color mapping files can be used for two purposes:

1) Select a default color scheme for Network Station 5250 users that do not have access to the 5250 Color Mapping program and for users that have not selected their own color mapping scheme.

2) Select administrator created advanced color mapping files to make available to basic Color Mapping program users.

A default color mapping file is created as follows:

1) Use the 5250 Color Mapping program to create and test the color mapping file: Select the basic color scheme that is closest to your desired color scheme. Click the Apply button. Click the Advanced button. You can optionally adjust colors. Apply changes to the emulator session.

2) Save the advanced color scheme with a color file name. Your color mapping file is written to your IBM Network Station user directory. Default color mapping files are not copied; if you accidentally change a default color mapping file, users will use the changed file.

3) Use the IBM Network Station Manager program, 5250 Preferences, to select the desired color mapping file from the administrator's user directory to become a system default, group default, or user default color scheme. You can also make your advanced color schemes available to other basic and advanced color mapping users; other users can select your default advanced color schemes using basic color mapping.

Default Keyboard Map Files

You 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 5250 Keyboard Remapping program and IBM Network Station Manager program to create system default, group default, and user default keyboard mapping files. A default keyboard mapping file is created as follows:

1) Use the 5250 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 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.

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 followed by the named keyboard mapping file name (including the keyboard type extension) in the IBM Network Station Manager program, Startup Programs or Startup Menus (depending on how your 5250 session starts). Then, save the updated default keyboard mapping file with the same name.

3) Use the IBM Network Station Manager program, 5250 Preferences, to select the desired keyboard mapping file from the administrator's user directory to become a system default, group default, 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).

Default Playback Files

You can use default record/playback files, even if you are not authorized to use the 5250 Record program. See your System Administrator for details.

An administrator can use the 5250 Record program and IBM Network Station Manager program to create system default, group default, and user default playback files. A default playback file is created as follows:

1) Use the 5250 Record program to create and test the playback file. The playback file is written to the administrator's IBM Network Station user directory. Default playback files are not copied; if you accidentally change a default playback file, users will use the changed file.

2) Use the IBM Network Station Manager program, 5250 Preferences, to select the desired playback file (or files) from the administrator's user directory to become a system default, group default, or user default playback file.

Display Name (5250 Session)

An administrator can specify the virtual display name for 5250 sessions using the IBM Network Station Manager. Click on Startup, then Programs or Menus in IBM Network Station Manager. Programs automatically starts a 5250 session or sessions after login. Menus controls the menu bar buttons; one or more menu bar buttons can start 5250 sessions. Enter -DISPLAY_NAME, one space, and one parameter (the parameter is described below) in the Other parameters field. -DISPLAY_NAME and the parameter are case sensitive.

-DISPLAY_NAME also controls the number of 5250 sessions that can be started on the target AS/400. The target AS/400 must be at Version 3/Release 2, Version 3/Release 7, Version 4/Release 1, or later.

The rules for AS/400 session names are:

- Each active 5250 session must have a unique session name (virtual display name).

- Display names must be 2 to 10 characters in length.

- The first character must be an alpha character.

- All characters must be alpha, numeric, a period, or an underscore.

- All alpha characters must be upper case.

There are 11 types of the display name parameters. The first 7 parameter types follow the user independent of the IBM Network Station used. The last 4 parameter types are based on the IBM Network Station hardware.

1) XXXXXX where XXXXXX is a 2 to 10 character name of the 5250 session. The user is limited to a single session.

2) XXXXXX+n where XXXXXX is a 1 to 9 character name of the 5250 session. The user is limited to n sessions. n is anumber from 2 to 9. For example: JUAN+4 would allow the user to start four 5250 sessions where the first session would be JUAN1, the second JUAN2, then JUAN3 and JUAN4.

3) "XXXXX YYYYYYYY ZZZZ" is a list of possible display names separated by a space. The starting and ending quotes are required. Each name must be 2 to 10 characters in length. The maximum number of names is determined by the size of Other parameters in IBM Network Station Manager (256 characters).

4) USE_USER_ID allows the user to start a single 5250 session where the session name is the same as the user's User ID (2 to 10 characters).

5) USE_USER_ID+n allows the user to start n 5250 sessions where the session name is the same as the user's User ID (limited to 9 characters) with the number n appended to the end. n is a number from 2 to 9. For example: USE_USER_ID+4 and a User ID of JUAN would have session names of JUAN1, JUAN2, JUAN3, and JUAN4.

6) text+USE_USER_ID is another variation of USE_USER_ID. The 'text' are characters that preceed the user's User ID. For example, DSP+USE_USER_ID and a User ID of JUAN would have a session name of DSPJUAN. The text can be from 1 to 8 characters.

7) text+USE_USER_ID+n is also supported. n is a number from 2 to 9.

8) USE_HOST_NAME allows the user to start a single 5250 session where the session name is the Host Name of the Network Station. The Host Name is read from the DNS (Domain Name Server) at Network Station login time. Lower case characters are converted to upper case by the 5250 emulator. If the Host Name exceeds 10 characters, the session name is truncated starting from the end, up to a period delimitor. For example, a Network Station with a Host Name of ns23.newyork.ibm.com would have a session name of NS23.

9) USE_HOST_NAME+n is also supported. n is a number from 2 to 9.

10) USE_MAC_ADDRESS allows the user to start a single 5250 session where the session name is created starting with an alpha character which indicates the type of communication card (T for token ring or E for Ethernet) followed by the lower four bytes of the MAC address. The MAC address is displayed on the IBM Network Station "View Hardware Configuration" screen (boot monitor screen). For example: USE_MAC_ADDRESS with a token ring Network Station and MAC address of 00.00.E5.68.D5.99 would result in a session name of TE568D599.

11) USE_MAC_ADDRESS+n allows the user to start n 5250 sessions where the session name is created as above but with n appended to the end. For example: USE_MAC_ADDRESS+3 with a token ring Network Station and MAC address of 00.00.E5.68.D5.99 would result in session names of TE568D5991, TE568D5992, and TE568D5993.

Enter Key Location

The Miscellaneous Preferences... option allows the user to transfer the function of the Enter key to the Ctrl key position.

See the Key Sequences section for the default key locations.

The Euro monetary symbol is enabled for the 5250 emulator by your administrator using the IBM Network Station Manager. Click on Startup, then Programs or Menus in IBM Network Station Manager. Programs automatically starts a 5250 session or sessions after login. Menus controls the menu bar buttons; one or more menu bar buttons can start 5250 sessions. Enter -EURO in the Other parameters field. -EURO is case sensitive.

Exit 5250

This option ends the 5250 session.

Field Exit Key Location

The Miscellaneous Preferences... option allows the user to transfer the functions of the Enter and Field Exit keys to the Ctrl and Enter key positions.

See the Key Sequences section for the default key locations.

Fonts

The 5250 session supports fixed font sizes. You can change the 5250 session font using the Fonts pull down choice or dragging the lower right corner of the 5250 session window (using the mouse).

Your administrator can use the IBM Network Station Manager program (Startup, then Programs or Menus) to set your initial 5250 window location and size (the 5250 emulator may adjust the resulting window size to match the font used).

Held Key Typing Rate

You 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).

Hotspots

The mouse can be used to navigate application menus by clicking on hotspot locations. Miscellaneous Preferences can disable hotspots, enable hotspots on the primary mouse button single click, or enable hotspots on the primary mouse button double click. The following hotspot functions are supported.

Clicking the primary mouse button (typically the left mouse button) on function key text emulates the pressing of this function key (for example, "F3=Exit").

Clicking the primary mouse button on a recognized menu hotspot emulates the pressing of the menu number(s) followed by the Enter key (for example, "1. User tasks").

Clicking the primary mouse button on "More..." scrolls forward through the data, and on "Bottom" scrolls data upward. Clicking the secondary mouse button on "More..." or "Bottom" scrolls data upward.

In some cases, "More -/+" are presented. Clicking the primary mouse button on "-" scrolls data upward. Clicking the primary mouse button on "+" scrolls data forward.

The Enter key can be emulated by double clicking the primary mouse button. The first click positions the cursor and the second click activates the Enter key.

An operator error (typically presented at the bottom of a 5250 session as a result of a keystroking error) can be reset by clicking the primary mouse button on the error line.

The default action of the primary mouse button is to position the text cursor.

The remainder of this section provides details on 5250 hotspot functions.

Mouse events are typically ignored when the keyboard is locked or in operator error state. An exception is clicking the primary button on the error line resets an operator error.

AS/400 applications can program the mouse to return events to the AS/400 application; this takes priority over hotspot functions.

Function key emulation details: You can click the primary mouse button anywhere within recognized function key text; for example, "F23=Set initial menu". Recognized function key formats include:

- "Fx=" where x can be "1" to "9".

- "Fyz=" where y can be "0", "1", or "2". If y is "0", z can be "1" to "9". If y is "1", z can be "0" to "9". If y is "2", z can be "0" to "4".

- "PFx=" is supported like "Fx=".

- "PFyz=" is supported like "Fyz=".

Function key text is not recognized within an entry field.

Menu hotspot details: You can click the primary mouse button anywhere within recognized menu item text; for example, "1. User tasks". The characteristics of recognized menu item text include:

- The format of the menu item text is "xxn.yzzzzzzzz" where each x is a blank, null, or a display attribute. n can be a one to five digit number with digits of "0" to "9". y can be a blank or a null. zz can be any characters other than a recognized xx pattern.

- One "x" character is allowed if the "x" character is located in column 1.

- A menu item can be recognized up to the end of a row.

Menu item text is not recognized within an entry field.

If a valid menu hotspot is recognized, the one to five digit number is auto-keyed into a valid entry field. If the cursor is currently located in a valid entry field, the number is keyed and the remainder of the entry field nulled out. An Enter key is emulated. If the cursor is not currently located in a valid entry field, a valid entry is searched for.

Image/Fax Display

Image/fax scaling: Your image/fax application may have a scale up and scale down button. You also can scale image/fax data by pressing the secondary mouse button within the image/fax data, moving the mouse pointer, and releasing the mouse button. The image/fax data with the outlined box is scaled up. Double clicking the secondary mouse button restores the original scaling.

Image/fax support can be enabled for the 5250 session by using the IBM Network Station Manager program to set the system default, group default, or user default for image/fax support. 5250 Preferences can enable image/fax for all of your 5250 sessions. Startup Programs and Startup Menus (depending on how your 5250 session starts) can enable image/fax support on a session by session basis. When image/fax support is in effect, a bar chart symbol appears in the right hand portion of the status line.

Note: If an image or fax is displayed, the 5250 emulator requires more Network Station memory than a non-image/fax 5250 session. If an image or fax is too large to display on your Network Station due to lack of available memory at that time, an error dialogue box is displayed.

See the Screen Print topic for information on printing an image or fax displayed in the 5250 session.

The 5250 emulator supports the following image/fax formats:

1) TIFF format (TIFF is a trademark of Aldus Corporation): Only one image is supported per TIFF format. If a TIFF contains multiple images, the AS/400 must send each TIFF image separately. The following TIFF compression algorithms are supported:

- No compression

- CCITT Group 3 Fax one-dimensional modified Huffman run length encoding

- CCITT Group 3 Fax compression

- CCITT Group 4 Fax compression

- PackBits run length encoding

- Color

- Grey scale

2) IOCA format (function set 10 only): Only one image is supported per IOCA format. The following five IOCA function set 10 compression algorithms are supported:

- IBM MMR (Modified CCITT Modified Read algorithm)

- No compression

- CCITT Group 3 Fax one-dimensional modified Huffman run length encoding

- CCITT Group 3 Fax compression

- CCITT Group 4 Fax compression

3) PCX format: The following compression algorithms are supported:

- No compression

- Run length encoding

- Color

4) JPEG color/grey scale 8 bit baseline DCT (extended baseline is not supported).4

5) Standalone Group 3 Fax Compression format: A four byte length of the Group 3 fax, eight bytes (typically set to zero), and a Group 3 Compression fax.

Key Sequences

Some 5250 keyboard functions are not marked on IBM Network Station PC type keyboards. Keyboard functions and default key sequences are listed below. The OV/400 Editor screen has unique keyboard functions that are described in the OV/400 Editor Key Sequences topic. The 5250 Keyboard Remapping program can modify the location of 5250 keyboard functions on your keyboard.

Attention: Esc

Character Advance: Shift + Backspace

Character Backspace: Backspace

Clear: Shift + Page Up

Cursor Select: Alt + Insert

Dup: Shift + Insert

Enter: Enter (also Shift + Enter) (Miscellaneous Preferences can switch this key with the Ctrl key)

Erase End of Field: Alt + Delete

Erase Input: Alt + End

Extended Display Attributes: Alt + l (letter l)

F13 - F24: Shift + F1 - F12

Fast Cursor Left: Alt + Cursor Left

Fast Cursor Right: Alt + Cursor Right

Field Exit: + (on the right side of the keyboard when not in Num Lock state) (Miscellaneous Preferences can switch this key to the Ctrl or Enter key location)

Field Mark: Shift + Home

Field Minus: - (on the right side of the keyboard when not in Num Lock state)

Field Plus: + (on the right side of the keyboard when not in Num Lock state) Note: Field Exit and Field Plus provide the same function.

Help: Scroll Lock

Hex key: Alt + 7 (the numeric 7 key above the alpha keys)

Image Scroll Down: Alt + Numeric keypad '2'

Image Scroll Left: Alt + Numeric keypad '4'

Image Scroll Right: Alt + Numeric keypad '6'

Image Scroll Up: Alt + Numeric keypad '8'

Local Print Screen: Shift + Print Screen (Miscellaneous Preferences can enable Local Print Screen without the Shift key)

New Line: Ctrl (Miscellaneous Preferences can switch this key with the Enter key)

PA1: Shift + Delete

PA2: Shift + End

PA3: Shift + Page Down

Playback: Alt + Page Up

Record: Alt + Home

Reset: Ctrl (on the lower left side of the keyboard)

Roll Down: Page Up

Roll Up: Page Down

Rule Line: Alt + Page Down

System Request: Alt + Print Screen (Note: subsequent Enter key is required to send data to AS/400)

Test Request: Alt + Scroll Lock

Keyboard Macros

Keyboard macros allow you to easily key a sequence of characters into your 5250 sessions. The keyboard remapping program can be used to create simple keyboard macros (less than about 100 characters). A simple keyboard macro can also be specified for a keypad button.

The record/playback program can be used to create simple or complex keyboard macros. The resulting playback file can be started from an emulator pull down, a key sequence specified in the keyboard remapping program, or a keypad button. See the Playback topic for more information.

Keyboard Remapping

The 5250 Keyboard Remapping program allows you to change the actions of keys within a 5250 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 5250 Keyboard Remapping program:

1) Enabled: You are allowed to remap your keyboard for 5250 sessions.

2) Disabled: You are not authorized to use the 5250 Keyboard Remapping program. The "Keyboard Remapping..." pull down choice is unavailable.

3) Hidden: You are not authorized to use the 5250 Keyboard Remapping program. The "Keyboard Remapping..." pull down choice is not displayed.

The 5250 Keyboard Remapping program has its own help text. See this help text for details on the 5250 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 Map Files topic describes how a System Administrator can create system default, group default, and user default keyboard mapping files for IBM Network Station users.

At the start of a 5250 session, the 5250 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). The following order is used; if a keyboard mapping file is found, it is used for the 5250 session:

- Search for a -KEYFILE named keyboard mapping file (a System Administrator may use named keyboard mapping files).

- Search for a session specific keyboard mapping file that you created using the Keyboard Remapping program.

- 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 5250 users.

- If none of the above is found, the 5250 emulator uses default keyboard actions.

Language of a 5250 Session

The 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 5250 session language defaults to your server language or the setting of dates, currency, numbers, and messages in IBM Network Station Manager. Your 5250 session language is the language of the 5250 data within your main 5250 window. Your system administrator can set some or all of your 5250 sessions to a language different than your default 5250 session language.

Your System Administrator can use the optional -LANGID parameter to set a 5250 session language to a language different than your default 5250 session language. -LANGID is used in IBM Network Station Manager as follows. Click Startup, then Programs or Menus. Programs automatically starts a 5250 session or sessions after login. Menus controls the menu bar buttons; one or more menu bar buttons can start 5250 sessions. Enter -LANGID, one space, and one parameter (the parameter is described below) in the Other parameters field. -LANGID and the parameter are case sensitive.

The following languages are supported by the IBM Network Station 5250 emulator.

5250 Session Language	-LANGID Parameter
Byelorussian (Belarus)	BE_BY
Bulgarian (Bulgaria)	BG_BG
Catalan (Spain)	CA_ES
Czech (Czech Republic)	CS_CZ
Danish (Denmark)	DA_DK
German (Switzerland)	DE_CH
German (Germany)	DE_DE
Greek (Greece)	EL_GR
English (Great Britain)	EN_GB
English (United States)	EN_US
Spanish (Spain)	ES_ES
Spanish (Latin America)	ES_LA
Estonian (Estonia)	ET_EE
Finnish (Finland)	FI_FI
French (Belgium)	FR_BE
French (Canada)	FR_CA
French (Switzerland)	FR_CH
French (France)	FR_FR
Hungarian (Hungary)	HU_HU
Icelandic (Iceland)	IS_IS
Italian (Switzerland)	IT_CH
Italian (Italy)	IT_IT
Japanese Extended Katakana or Extended Latin (Japan)	JA_JP
Japanese Extended Katakana	JA_JP.IBM930
Japanese Extended Latin	JA_JP.IBM939
Korean (Korea)	KO_KR
Lithuanian (Lithuania)	LT_LT
Latvian (Latvia)	LV_LV
Belgian-Dutch (Belgium)	NL_BE
Dutch (Netherlands)	NL_NL
Norwegian (Norway)	NO_NO
Polish (Poland)	PL_PL
Portuguese (Brazil)	PT_BR
Portuguese (Portugal)	PT_PT
Russian (Russia)	RU_RU
Serbian Latin (Serbia)	SH_SP
Slovakian (Slovakia)	SK_SK
Slovenian (Slovenia)	SL_SI
Serbian Cyrillic (Serbia)	SR_SP
Swedish (Sweden)	SV_SE
Turkish (Turkey)	TR_TR
Ukrainian (Ukraine)	UK_UA
Simplified Chinese (China)	ZH_CN
Traditional Chinese (Taiwan)	ZH_TW

Note: A Network Station 5250 user can have multiple 5250 sessions in multiple languages.

Large Screen Mode: 27 by 132

You or your System Administrator can disable the 27 row by 132 column display screen size for all of your 5250 sessions using the IBM Network Station Manager program (5250 preferences).

Your System Administrator can disable the 27 row by 132 column display screen size for some of your 5250 sessions. The -wide disable parameter is used on one of your 5250 startup commands.

Note: Most AS/400 screens use 24 rows by 80 columns regardless of 27 by 132 option setting. When the AS/400 sends a 27 by 132 display screen, your 5250 window may change font and move. This behavior can be adjusted using Miscellaneous Preferences.

Note: Older (VGA) monitors may not be capable of displaying 27 rows by 132 columns. Your Network Station monitor must be capable of (and setup to use) 1024x768 or greater resolution to display 27 rows by 132 columns.

Left/Right Handed Mouse

The 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).

Maximize

The 5250 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.

Miscellaneous Preferences

Miscellaneous Preferences allow you to adjust your 5250 sessions; for example, cursor appearance, function of the Backspace key, and rule line control. 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, all 5250 sessions on the IBM Network Station are 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.

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 5250 sessions for a given user.

Changing Enter/Field Exit Key (Enter and Ctrl keys) or Print Key (Print Screen key) will not allow these keys to be remapped using the 5250 Keyboard Remapping program.

Mouse Functions

The mouse controls many functions on the IBM 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 retiles windows.

The mouse can also:

- Access menu bar and pull down functions.

- Cut, copy, and paste: See Cut, Copy, and Paste for more information.

- Activate 5250 hotspots: For example, by selecting function keys (See Hotspots for more information).

- Position the cursor (the default action of the primary mouse button, usually the left button).

- Select and control 5250 Enhanced User Interface constructs; for example, selection fields, buttons, and scroll bars.

Mouse Speed

You 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.

New 5250

This pull down choice allows you to start additional 5250 sessions. You are prompted for the host name. The current host name is available as a default. The host name can be the (name server) name of the system or the (numeric) IP address of the system.

If your IBM Network Station does not have enough memory to start an additional 5250 session, a dialogue box is presented indicating the lack of available memory.

OV/400 Editor Function

The 5250 program provides OV/400 Editor function similar to 3477, 3487, and 3488 InfoWindow II terminals. See the OV/400 Editor Key Sequences topic for information on key sequences.

OV/400 Editor Key Sequences

Many OV/400 Editor keyboard functions are not marked on IBM Network Station keyboards. Those keyboard functions and default key sequences are listed below. The 5250 Keyboard Remapping program can modify the location of 5250 keyboard functions on your keyboard.

Begin Bold: Alt + b

Begin Underscore: Alt + u

Beginning of Line: Shift + Cursor Left (left pointing arrow)

Bottom of Page: Shift + Cursor Down (down pointing arrow)

Carrier Return: Alt + main keyboard Enter key (not the Enter key on the right side of the keyboard)

Center Text: Alt + c

Display Text Attributes: Alt + i

End Active Attribute: Alt + j

End Current Column: Alt + d

End of Line: Shift + Cursor Right (right pointing arrow)

Half Index Down: Alt + h

Half Index Up: Alt + y

Keyboard Change (Symbols): Alt + a

Next Stop Code: Alt + n

Page End: Alt + p

Required Carrier Return: - or + (on the right side of the keyboard when not in Num Lock state)

Required Space: Alt + space bar

Required Tab: Alt + t

Stop Code Insert: Alt + s

Top of Page: Shift + Cursor Up (up pointing arrow)

Word Underline: Alt + w

Paste

Data which has previously been Cut or Copied into the 'clipboard buffer' can be Pasted into a 5250 session.

Pull down the Paste option to transfer a copy of the data stored in the clipboard buffer into the 5250 session, starting at the mouse pointer location.

Keyboard paste is also available. Press and hold a Shift key and press the secondary mouse button (usually the right button). Miscellaneous Preferences can set the keyboard paste start location to be the mouse pointer position instead of the text cursor position.

If the paste data originated from a block copy within a 5250 session, the paste is a block paste.

Restriction on Paste into an OV/400 edit screen: A Paste stops if a 'text instruction' or 'format change character' is found in the paste data. A typical text instruction is the date instruction. A format change character appears as a reverse image capital 'F'. Operator error '0072' or 'Key not allowed' is presented if a paste is interrupted.

Playback

Playback allows you to play recorded keystrokes into the 5250 window. See Record for information on recording. Use of record/playback requires authorization from your System Administrator using the IBM Network Station Manager program. There are three levels of authorization to 5250 record/playback:

1) Enabled: You are allowed to record and playback within your 5250 sessions.

2) Playback only: You are allowed to playback within your 5250 sessions. The "Record..." pull down choice is not displayed.

3) Hidden: You are not authorized to use 5250 Record/Playback. The "Record..." and "Playback..." pull down choices are not displayed.

Playback: Place the cursor at the desired position on the desired menu and start the playback. There are five ways to start a playback file:

1) Select the "Playback..." pull down choice, select a playback file, and select the "Start" button.

2) Press the Playback key and the appropriate function key (the accelerator function key is defined during recording). See Key Sequences to find the Playback key location.

3) Using the Keyboard Remapping program, you can specify a playback file to start when you press a specific key sequence. Insert your playback file name between the parentheses of the Play() action in keyboard remapping.

4) A playback file can be specified on a keypad button. See Pop-Up/Pull Down Keypad for more information.

5) An auto-logon playback file starts when the 5250 session starts. See Auto-Logon for more information.

A playback pause will occur for a data key in a non-display entry field (except for an auto-logon playback file when the 5250 session is starting -- in certain cases, an auto-logon playback file will pause for a non-display entry field -- see Auto-Logon for more information). During recording, a pause can be specified to permit entry of variable (for example, a part number) or private data (for example, a password). To resume playback click the Continue button.

The playback rate can be controlled by adjusting the Playback Rate slider.

A playback indicator is written to the status line during playback. Clicking on the playback indicator stops the playback.

Click Cancel from the Playback window to end the playback session.

User playback files can be deleted by selecting a file and clicking the Delete button.

The Default Playback Files section describes how a System Administrator can create system default, group default, and user default playback files for IBM Network Station users.

Pop-Up/Pull Down Keypad

The 5250 emulator allows you to create pop-up and pull down keypads. A keypad has keypad buttons. Each keypad button has a key sequence or playback file associated with the button. Note: A System Administrator can disable keypads (using the IBM Network Station Manager program).

The "Keypad..." pull down choice is displayed if you have created one or more pop-up keypads. The "Keypad..." pull down choice is used to start one or more pop-up keypads. When you select a keypad button, the keypad action is processed in the 5250 session that started this pop-up keypad.

A "Keypad" menu bar choice is displayed if you have created one or more pull down keypads.

The "Customize Keypad..." pull down choice is used to create keypads or to change an existing keypad.

Keypad customization has its own help text. Click "Help" in the keypad customization window.

Any keypad that you create is available to all of your 5250 sessions.

Record

Record allows you to record keystrokes during a 5250 session for later play back. Use of record/playback requires authorization from your System Administrator (using the IBM Network Station Manager program). There are three levels of authorization to 5250 record/playback:

1) Enabled: You are allowed to record and playback within your 5250 sessions.

2) Playback only: You are allowed to playback within your 5250 sessions. The "Record..." pull down choice is not displayed.

3) Hidden: You are not authorized to use 5250 Record/Playback. The "Record..." and "Playback..." pull down choices are not displayed.

Recording: Place the cursor at the desired position on the system screen and select the "Record..." pull down choice (or press the Record key). Click the Start button to begin recording. Your keystrokes (and mouse events) will be recorded.

Click Pause to temporarily stop recording. There are three ways to pause recording:

1) Select 'None' to temporarily pause recording (for example, to process an AS/400 message that happens to occur during recording).

2) Select 'Pause playback at this point' to allow the user to enter private data (for example, Password) or data which may vary (for example, a part number). Pause before the first private or variable data key and continue recording after the last private or variable data key.

3) Select 'Insert User ID' and 'Insert Password' for auto-logon and automatically starting a playback file at 5250 session start time (see Auto-Logon for more information).

Click Continue Recording to resume recording after a pause.

Click Stop when you complete recording or wish to discard a record sequence. Select an existing playback file to replace (overwrite), enter the name for the new playback file, or click Do Not Save to discard a record sequence.

Note: The Record program limits the playback file name to 32 characters.

You can define an accelerator key. This allows later playback using the Playback key followed by the function key which you select. Click the Assign Optional Accelerator button and click the desired function key or press the function key on the keyboard.

User playback files can be deleted within the Playback window.

The Default Playback Files topic describes how a System Administrator can create system default, group default, and user default playback files for IBM Network Station users.

Note: The Keyboard Remapping program can be used to create simple keyboard macros.

Resizing a 5250 Session

The 5250 session size can be changed by selecting a different font using the "Fonts..." pull down.

The session size can also be changed by pressing the primary mouse button (usually the left button) on the lower right corner of the 5250 window border, moving the mouse pointer, and releasing the mouse button. The 5250 session size is adjusted to best match where the mouse button was released.

Your administrator can use the IBM Network Station Manager program (Startup, then Programs or Menus) to set your initial 5250 window location and font.

Rule Line Support

The 5250 session can display a rule line; a rule line is a horizontal line, vertical line, or both horizontal and vertical lines displayed in the 5250 window.

Support for the Rule Line key and the type of rule line to display are controlled by pulling down the "Miscellaneous Preferences..." choice.

Screen Print

The 5250 emulator screen print function allows you to print the contents of a 5250 session 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 "Screen Print..." in the Print pull down or pressing the Shift + Print Screen key. Miscellaneous Preferences can enable local screen print without the Shift key.

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 5250 session contents to the specified printer. The 5250 session contents are converted prior to printing, based on the language of your 5250 session. More information can be found below.

Image/fax printing: PCL and PostScript printers are generally capable of printing an image or fax that you have displayed in your 5250 session. You are given the choice of printing the image/fax data or the 5250 session character data if you have an image or fax displayed.

Note: Clicking the Print button saves any changes that you make in the 5250 Screen Print window for use the next time you select 5250 screen print.

Note: A local Network Station printer can also be a system printer.

The 5250 session contents are converted prior to printing, based on the language of your 5250 session. The printer language is assumed to be the same as your 5250 session language. Note: All characters may not print correctly in all languages.

For PostScript printers, 5250 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 5250 Session for the primary using country for a language):

5250 Session Language	ASCII Printer Code Page	PCL Symbol Set
Bulgarian	915	ISO 8859-5 (ECMA-113/88) Latin Cyrillic
Byelorussian	915	ISO 8859-5 (ECMA-113/88) Latin Cyrillic
Catalan	850	ISO 8859-1 (ECMA-94) Latin 1
Simplified Chinese		Not applicable
Traditional Chinese		Not applicable
Czech	912	ISO 8859-2 (ECMA-94) Latin 2
Danish	850	ISO 8859-1 (ECMA-94) Latin 1
Dutch	850	ISO 8859-1 (ECMA-94) Latin 1
Belgian-Dutch	850	ISO 8859-1 (ECMA-94) Latin 1
English	850	ISO 8859-1 (ECMA-94) Latin 1
Estonian	922	ISO 8859-1 (ECMA-94) Latin 1
Finnish	850	ISO 8859-1 (ECMA-94) Latin 1
French	850	ISO 8859-1 (ECMA-94) Latin 1
German	850	ISO 8859-1 (ECMA-94) Latin 1
Greek	813	ISO 8859-7 (ECMA-118) Latin Greek
Hungarian	912	ISO 8859-2 (ECMA-94) Latin 2
Icelandic	850	ISO 8859-1 (ECMA-94) Latin 1
Italian	850	ISO 8859-1 (ECMA-94) Latin 1
Japanese		Not applicable
Korean		Not applicable
Latvian	921	ISO 8859-1 (ECMA-94) Latin 1
Lithuanian	921	ISO 8859-1 (ECMA-94) Latin 1
Norwegian	850	ISO 8859-1 (ECMA-94) Latin 1
Polish	912	ISO 8859-2 (ECMA-94) Latin 2
Portuguese	850	ISO 8859-1 (ECMA-94) Latin 1
Russian	915	ISO 8859-5 (ECMA-113/88) Latin Cyrillic
Serbian Cyrillic	915	ISO 8859-5 (ECMA-113/88) Latin Cyrillic
Serbian Latin	912	ISO 8859-2 (ECMA-94) Latin 2
Slovakian	912	ISO 8859-2 (ECMA-94) Latin 2
Slovenian	912	ISO 8859-2 (ECMA-94) Latin 2
Spanish	850	ISO 8859-1 (ECMA-94) Latin 1
Swedish	850	ISO 8859-1 (ECMA-94) Latin 1
Turkish	920	ISO 8859-9 (ECMA-128) Latin 5
Ukrainian	915	ISO 8859-5 (ECMA-113/88) Latin Cyrillic

Status Line (OIA)

The status line (sometimes called an operator indicator area or OIA) is located at the bottom of each 5250 session. The status line contains the following information:

The first portion of the status line is your 5250 session number on the system.

The next portion of the status line is the system name to which this 5250 session is communicating.

The next portion of the status line contains the text "Message Waiting" if the 5250 session has the message waiting indicator set on for this session.

The next portion of the status line contains several indicators related to the keyboard state of this 5250 session:

- A capital "X" indicates that the keyboard is locked, waiting for information from the AS/400.

- Two right-pointing brackets (>>) indicate that type ahead is on (the default).

- An upward pointing arrow indicates that a shift key is held down on the keyboard.

- A capital "A" indicates the keyboard is in Caps Lock state (upper case).

- An upside down "V" indicates the keyboard is in insert state.

- An indicator similar to a small "d" indicates the keyboard is in diacritic state (this indicator is not used in most languages).

- A bar chart symbol indicates that the 5250 session is capable of displaying image and fax.

The last portion of the status line displays the row and column location of the text cursor (Miscellaneous Preferences controls if the row and column location is displayed).

Window Title

Each 5250 session has a window title at the top of the 5250 window. The window title has three parts.

1) The first portion of the window title is the window title text. The default window title text is "5250". Your administrator can change this to any title you wish.

2) The middle portion of the window title is the system name to which this 5250 session is communicating. The length of the name can be up to 20 characters in length.

3) The last portion of the window title is your IBM Network Station session number on this system. "1" is the first session into a system; "2" is the second session, etc.

Your administrator can define a different font to be used in the window title and define different foreground/background colors for the 5250 window title.