|
||||||||||||||||||
5250 Help5250 Help Table of Contents
Using 5250 HelpThis 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. Click the Exit button to end the help session. If your monitor resolution is 1024x768 or higher, a Font button allows you to change the font size while viewing online help.
Additional ParametersA System Administrator can set Additional parameters in IBM Network Station Manager 5250 preferences. Additional parameters set default Miscellaneous Preferences values and set other 5250 preferences. Note: Additional parameters are different than Launch Bar Other parameters. Additional parameters apply to all 5250 sessions. Other Parameters apply only to 5250 sessions which are started from the Launch Bar. See the Other Parameters topic for information on IBM Network Station Manager Launch Bar Other parameters. Each Additional parameter must be on a separate line. The format of an Additional parameter line is: NS5250 is the 5250 program name, followed by a "*", the preference name, a ":", and the preference value. Additional parameters that have equivalent Miscellaneous Preferences settings and the parameter values are listed below. The 5250 Miscellaneous Preferences program provides additional information on each preference and preference value. (If a Miscellaneous Preference file exists for a user, the Additional parameter values are not used for the Miscellaneous Preference type of parameters. If the user sets Miscellaneous Preferences to Set Defaults, Additional parameter values are used.) Preference Name:Preference Values CURSOR_STYLE : cursor style CURSOR_BLINK : cursor blink ENTER_KEY: Enter key/right Ctrl key Note: 5250 Enter key is set as a 5250 preference in IBM Network Station Manager, above Additional Parameters. PRINT_KEY: Print key USE_DEFAULT (default) use the default DESTRUCTIVE_BACKSPACE: Destructive backspace INSERT_MODE: insert mode DEFAULT_OFF_AUTOMATIC_RESET (default) default off/automatic reset DEFAULT_COPY_TYPE: default copy type PASTE_LOCATION: paste location AUTOMATIC_HELP: automatic Help key ERROR_RESET_KEYS: error reset keys AUDIO_ALARM: audio alarm INPUT_ONLY_CURSOR_MOVEMENT: cursor only to input positions KEYBOARD_BUFFERING: locked keyboard buffering DISABLE disable LARGE_SCREEN_BEHAVIOR: large screen behavior ROW_COLUMN_INDICATOR: row/column indicator RULE_LINE: rule line RULE_LINE_STYLE: rule line style BLUE_UNDERSCORE: blue underscore BRACKET: bracket character change AUTOMATIC_RECONNECT: automatic reconnect HOTSPOTS: hotspots HOTSPOT_HIGHLIGHTING: hotspot highlighting The other 5250 Additional parameters are listed below: TITLE_OPTION: window title options SESSION_ID: session id MAX_SESSIONS: maximum sessions DISPLAY_NAME: host display name RETRY_COUNT: retry count RETRY_INTERVAL: retry interval INACTIVITY_TIMEOUT: inactivity timeout ICONIFIED_ACTION: iconified session change when the emulator screen changes BLINKING_TEXT: blinking text attribute EURO: (default set in IBM Network Station Manager) Euro symbol FONTS_TO_USE: fonts to use 27X132_IN_800X600: should 27 rows by 132 columns be available with 800X600 monitor resolution KEY_BUFFERING_DELAY: keyboard buffering delay PLAYBACK_DELAY: playback delay Auto-LogonThis 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 Option, Record... and Start. 3) If the cursor is not in the User ID entry field, move the cursor to the User ID entry field. 4) Click Pause (you may need to move the Record Pause Options window to see the 5250 session User ID and Password entry fields). 5) Select Insert User ID at this point. 6) Click on the 5250 session window title to enable the cursor in the 5250 session. 7) Enter your User ID in the User ID entry field (your User ID is not recorded). Note on steps 7 and 13: During playback, the User ID and Password (step 13) 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. 8) Click Continue Recording. 9) Move the cursor to the Password entry field: click the mouse in the first Password entry field position or press the Home key and then the Tab key as necessary to move the cursor to the Password entry field (this positions the cursor in the Password entry field correctly for a User ID that fills the User ID entry field). 10) Click Pause. 11) Select Insert Password at this point. 12) Click on the 5250 session window title to enable the cursor in the 5250 session. 13) Enter your Password (your Password is not recorded). 14) Click Continue Recording. Note: Your 'IBM Server Login' Password will be used during auto-logon playback. 15) Press the Enter key. You may need to press other keys to remove system messages after the Enter key. 16) If you wish, you can add to the playback file. For example, you can start a specific system application. 17) Click Stop Recording. 18) Enter a name for this auto-logon playback file and click Save. 19) Now, start the IBM Network Station Manager program. If you are creating an auto-logon playback file for yourself, you can skip steps 20 - 23. 20) Select system, group, or user to determine who has access to this auto-logon playback file. 21) Click Applications and click 5250 to change 5250 preferences. 22) Select the desired auto-logon playback file name from the list of playback sequences to make available. 23) Click Save. 24) Click Desktop and click Launch Bar. 25) Edit the Launch Bar Content for the 5250 session. Note: When using the Launch Bar for auto-logon, 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 Launch Bar does auto-logon, anybody can log on to the system by clicking on the Launch Bar icon. 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. 26) Add an Other parameter of -playback (or -PLAYBACK) followed by one space and the (case sensitive) playback file name. If your playback file name contains any spaces, use double quotes around the file name (for example, -playback "playback file name"). 27) Click OK, then Save. 28) If you are setting up the auto-logon playback file for multiple User defaults, repeat steps 20 - 27 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 or group default auto-logon 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 MappingThe 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: Some IBM Network Station model hardware supports up to 256 colors. 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 Mapping 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 Separators5250 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. Communication Error RecoveryThe 5250 emulator defaults to manual error recovery when a communication error causes: - A 5250 session to go down because the Network Station lost communication with the S/390. - A 5250 emulator session is unable to start successfully because of a possible communication error. Automatic error recovery can be enabled for the 5250 emulator by your administrator using the IBM Network Station Manager. Click on Desktop, then Launch Bar in the IBM Network Station Manager. Edit the Launch Bar Content for the 5250 session and enter -RETRY_COUNT, a space, and a number between 0 and 9999 in the Other parameters field. The number of 1 or greater is the number of automatic retries that should be attempted by the 5250 emulator. The default is 144 retries. If automatic error recovery is not successful, manual error recovery is then used. A number of 0 disables automatic error recovery (sets manual error recovery). -RETRY_COUNT is case sensitive. 5250 emulator automatic error recovery does 3 quick retries (approximately 20 seconds apart) followed by the number of retries specified with -RETRY_COUNT, using a retry interval. The default retry interval is 300 seconds (5 minutes). The retry interval can be set using -RETRY_INTERVAL, a space, and a number between 1 and 9999 in the Other parameters field. The number is the time interval between retries, in seconds. Note: An error dialogue is displayed to the user while automatic error recovery is occurring. 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 ChoiceSelecting 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. CopyData 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. Miscellaneous Preferences and Additional Parameters can change the default copy from linear to block. 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). CutData 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 Mapping FilesThe 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 Mapping FilesYou 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 parameter in the IBM Network Station Manager program: click Desktop, click Launch Bar. Edit the Launch Bar Content for the 5250 session. Enter the -KEYFILE parameter followed by one space and the (case sensitive) named keyboard mapping file name (including the keyboard type extension) in Other parameters. Then save the updated default keyboard mapping file with the same name. If your keyboard mapping file name contains any spaces, use double quotes around the file name (for example, -KEYFILE "key mapping file 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 Keypad FilesYou can use default pop-up or pull down keypad files, even if you are not authorized to use the 5250 Customize Keypad program. See your System Administrator for details. An administrator can use the 5250 Customize Keypad program and IBM Network Station Manager program to create system, group, and user default keypad files. A default keypad file is created as follows: 1) Use the 5250 Customize Keypad program to create and test the keypad file. The keypad file is written to the administrator's IBM Network Station user directory. Default keypad files are not copied; if you accidentally change a default keypad file, users will use the changed file. 2) Use the IBM Network Station Manager program, 5250 Preferences, to select the desired keypad file (or files) from the administrator's user directory to become a system, group, or user default playback file. Note: The -KEYPAD parameter can be used to automatically start a pop-up keypad when the 5250 session starts. -KEYPAD is entered in Other parameters for the Launch Bar content that starts the 5250 session. One space and the (case sensitive) pop-up keypad file name follows -KEYPAD. If your keypad file name contains any spaces, use double quotes around the file name (for example, -KEYPAD "keypad file name"). Default Playback FilesYou 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. Note: Auto-logon playback files are supported, see the topic Auto-Logon for more information. Display Name (5250 Session)An administrator can specify the virtual display name for 5250 sessions using the IBM Network Station Manager program: click Desktop, click Launch Bar. Edit the Launch Bar Content for the 5250 session. 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 can also control 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 display 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 associated with a specific IBM Network Station. 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 a number from 2 and 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 Network Station 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 Network Station User ID 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. Note: If the User ID is 10 characters, the last character is replaced by the number n. USE_USER_ID+99 is supported (the 99 is required). This option allows multiple users to share the same User ID. Up to 99 5250 sessions can be started; however, for performance reasons, 40 or fewer 5250 sessions is recommended. Session numbers from 1 to 99 are chosen randomly and appended to the User ID. If the User ID is 9 characters, the last character is removed before the 1 or 2 digit number is added. Two characters are removed for a 10 character User ID. USE_USER_ID+999 is supported (the 999 is required). Up to 999 5250 sessions can be started. Session numbers from 1 to 999 are chosen randomly and appended to the User ID. If the User ID is 8 characters, the last character is removed before the 1 to 3 digit number is added. Two characters are removed for a 9 character User ID and three characters are removed for a 10 character User ID. 6) text+USE_USER_ID is another variation of USE_USER_ID. The 'text' are characters that precede 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. text+USE_USER_ID+99 and text+USE_USER_ID+999 are supported; see display name type 5 above for more information. 8) USE_HOST_NAME allows the user to start a single 5250 session where the session name is the TCP/IP 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. 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. 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. n is a number from 2 to 9. 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 LocationThe 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. Euro Monetary SymbolThe Euro monetary symbol is supported by the 5250 emulator in the following languages: Danish, Dutch, Belgium Dutch, German, Swiss German, UK English, US English, Finnish, French, Belgium French, Canadian French, Swiss French, Italian, Swiss Italian, Norwegian, Portuguese, Brazilian Portuguese, Spanish, Latin American Spanish, and Swedish. The Euro monetary symbol is enabled or disabled using the IBM Network Station Manager program, in Language settings. Note: If necessary, 5250 emulator sessions can override the Language setting. Edit the Launch Bar Content for the 5250 session: enter -EURO (enable) or -NOEURO (disable) in the Other parameters field. -EURO and -NOEURO are case sensitive. Exit 5250This option ends the 5250 session. Field Exit Key LocationThe 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. FontsThe 5250 session supports scaleable font sizes. You can change the 5250 font using the Fonts pull down choice or dragging the 5250 window borders or window corners (using the mouse). Your administrator can use the IBM Network Station Manager program to set your initial 5250 window location and size (the 5250 emulator may adjust the resulting window size to match the font used). Your administrator can use the IBM Network Station Manager program to specify fixed fonts should be used, which are not scaleable. Held Key Typing RateYou 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). HotspotsThe 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 keystroke 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 DisplayThe 5250 emulator supports display and printing of image and fax; the supported formats/algorithms are described below. Note: In order for the 5250 emulator to display image or fax, you must run an AS/400 application that is enabled for image or fax. Image/fax scrolling: You can use the mouse to scroll image/fax data by interacting with a local image/fax scroll bar. You can press the primary mouse button (usually the left one) on an image/fax and move the mouse pointer to scroll the data. You also can use the keyboard to scroll image/fax data by using Alt + the following numeric keypad keys: '2', '4', '6', and '8'. 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 or disabled for the 5250 session by using the IBM Network Station Manager program to set the system, group, or user default for image/fax support. 5250 Preferences can disable image/fax for all of your 5250 sessions. Desktop Launch Bar can enable or disable 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 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 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) 3) PCX format: The following compression algorithms are supported: - No compression 4) JPEG color/gray scale 8 bit baseline DCT (extended baseline is not supported). 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 SequencesSome 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' Screen Print: Shift + Print Screen (Miscellaneous Preferences can enable Screen Print 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 MacrosKeyboard 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 the emulator Playback pull down, a key sequence specified in the keyboard remapping program, or a keypad button. See the Playback topic for more information.. Keyboard RemappingThe 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 that you created using the Keyboard Remapping program (stored in your $NSMSHARED/NS5250/K directory; 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 SessionThe 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 Desktop, then Launch Bar. Edit the Launch Bar Content that starts the 5250 session. 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.
Note: A Network Station 5250 user can have multiple 5250 sessions in multiple languages. Large Screen Mode: 27 by 132You 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 using IBM Network Station Manager: click Desktop, click Launch Bar, and edit the Launch Bar Content for the 5250 session. The Screen Size setting can disable the 27 row by 132 column screen size. 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 typically be capable of (and set up to use) 1024x768 or greater resolution to display 27 rows by 132 columns. 27 rows by 132 columns is available with a monitor resolution of 800X600, in scrolling mode; the Additional parameter of 27X132_IN_800X600 must be set to ENABLE. Left/Right Handed MouseThe 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 from the IBM Network Station Manager program. MaximizeThe 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 PreferencesMiscellaneous 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. A System Administrator can use the IBM Network Station Manager program to set default preferences; see the topic "Additional Parameters" for more information. 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 FunctionsThe 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 re-tiles 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 SpeedYou 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 5250This 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 FunctionThe 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 SequencesMany 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: No default key sequence Required Tab: Alt + t Stop Code Insert: Alt + s Top of Page: Shift + Cursor Up (up pointing arrow) Word Underline: Alt + w Other ParametersA System Administrator can set 5250 emulator options in Launch Bar Other parameters in IBM Network Station: click Desktop, click Launch Bar, then edit the Launch Bar Content that starts the 5250 session. Enter the options in Other parameters. The minus sign ("-") is required at the beginning of each other parameter. Other parameters are case sensitive. Multiple Other parameter options must be separated by one space. Other parameter options are: -TITLE_OPTION is followed by TEXT_AND_SESSION_ID (default -- title text and session id), TEXT_ONLY (title text only), SESSION_ID_ONLY (session id only), TEXT_AND_HOST (title text and host name), or TEXT_HOST_AND_SESSION_ID (title text, host name, and session id). -LANGID is followed by the language of this 5250 session; for example en_US for US English. -EURO and -NOEURO enable or disable Euro for this 5250 session. -PLAYBACK (or -playback) is followed by a (case sensitive) auto-logon playback file name. -KEYPAD is followed by a (case sensitive) pop-up keypad file name. The keypad will be displayed when the 5250 session starts. -KEYFILE is followed by a (case sensitive) named keyboard mapping file. An administrator can use -KEYFILE to modify a default named keyboard mapping file. -DISPLAY_NAME specifies the name for this 5250 session. -ICONIC specifies that the 5250 session should start iconified. -SSL is followed by a (case sensitive) file name, or a directory and file name. SSL is Secure Sockets Layer. The file name does not have an extension when specified in Other parameters (the appropriate extension is automatically added by the 5250 emulator). If -SSL is specified, the default port changes from 23 to 992. -PORT is followed by an AS/400 port number. The default port number is 23 if -SSL is not specified. The default port number is 992 if -SSL is specified. -ECL enables Java Host Access Class Library (HACL) access to the 5250 session. PasteData 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. PlaybackPlayback 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 KeypadThe 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. Note: The Customize Keypad program is not available on a VGA-type monitor. VGA monitors are lower resolution (640x480) and typically older PC monitors. The Default Keypad Files topic describes how a System Administrator can create system, group, and user default keypad files for IBM Network Station users. RecordRecord 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. A playback file can be assigned to a key sequence in keyboard mapping. 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 SessionThe 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 a 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 SupportThe 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 PrintThe 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. Printing a portion of the 5250 session is supported. A screen print with a marked a copy area (linear or block; see the Copy topic for more information) prints only the marked data. 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):
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. Note: A connection status indicator is temporarily displayed as a 5250 session starts. 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 TitleEach 5250 session has a window title at the top of the 5250 window. The window title has two 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 last portion of the window title is your Network Station session ID. Your administrator can modify the contents of the window title (see the "Additional Parameters" topic for more information). 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. |
|
||
