2.2. MARCO LEGAL
2.3.14. DIRECTIVA DE LA COMUNA PECHICHE
Figure 4-1 shows the 5250 tab of the iSeries Access for Web.
Figure 4-1 5250 tab
iSeries Access for Web has the ability to start a 5250 session from multiple locations:
5250-> Start Session or 5250-> Active Sessions-> Start session: Selecting this
method always starts a new session to the default iSeries server. You may change the default server and start a session to an iSeries server not running iSeries Access for Web. Figure 4-2 shows the Start Session page.
Function iSeries Access for Web V5R2
Interface
Host Publisher XML Gateway
Requires Host Publisher V4.0 No Yes Multiple views Yes No Macro support Yes No Break message support No No Cursor positioning Yes No Special keystroke handling Yes No Workstation ID support Yes No Function key enhancements Yes No
Save configured sessions Yes Yes- XML Legacy Gateway Portal
Change interface colors Yes No 132 column support Yes No
Figure 4-2 5250 Start Session
5250-> Configured Sessions-> Start (in Action column): This method provides the ability
to start a configured session using saved configuration settings. The session settings have the ability to be changed and saved.
4.3 Configuring sessions
iSeries Access for Web provides multiple ways to configure a 5250 interface session. You can save the session for future usage once complete. iSeries Access for Web also provides the ability to reload the IBM default settings.
5250 interface configuration methods:
Configure new session: Creates a new session
Edit: Modifies an existing session in the configured sessions list
Active session settings: Modifies the configuration of the currently active session on the
active session page
Saving Active session settings
iSeries Access for Web provides the ability to update the values for the current session or a configured session.
Click the OK button to update the values for the current session.
Click the Save button to update the current session and save the values in a configured session.
Saving defaults
Save as Defaults stores the current settings as defaults. The default settings are used in the following scenarios:
When a new session is configured, the default values are used as initial values for the settings.
When a Start Session is configured, the default settings are used to start the session.
When a session is configured, you can click the Load Defaults button to replace the current settings with the saved defaults.
Loading shipped defaults
iSeries Access for Web provides the ability to load shipped defaults. This function replaces the current settings with the shipped default settings. Load Shipped Defaults replaces the current settings with the configured default settings if saved. If default values are not saved, this has the same effect as using Load Shipped Defaults. iSeries Access for Web uses the shipped default values if a saved version is not found.
4.3.1 Configuration options
The following sections describe the available configuration options:
General
Server
Workstation ID
View
General configuration options
Figure 4-3 shows the General configuration options. We explain each option in the following sections.
Figure 4-3 Editing the General session
Session
The session name identifies the session within the Configured sessions list.
Default view
This option specifies whether the Web view or the traditional view is used when this session is started:
Web view: Presents the 5250 the same as other Web pages. This is the default view used
by Start session. Web view uses links to handle menu options, cursor positioning, and messaging text help. The browser’s default colors are used for displaying the page.
Traditional view: Presents the 5250 in a traditional look and feel. Default colors include
the familiar 5250 color scheme. The traditional view also provides more command entry input that acts more like a typical 5250 user interface.
Enable advanced JavaScript functions for Internet Explorer
Certain keystrokes are handled by JavaScript. This requires a browser that supports JavaScript and that has JavaScript enabled. Opera and Konqueror browsers are unable to handle 5250 interface keystroke enhancements.
Enter key: Enter key handling for a 5250 session is always enabled for supported
browsers with JavaScript enabled. If your browser doesn’t support JavaScript, you can configure your browser to achieve the same result. Since most browsers support the first
button on the page as the default button, use
My keypads
to configure a single keypad with Enter as the first button. All other keypads cannot be shown. The function key bar must also be disabled usingSession configuration
.Page up, page down, 12 function keys (and shifted states): Enable advanced
JavaScipt functions must be enabled for the keys to function. This option is enabled by default. When this option is enabled, Microsoft Internet Explorer (version 5.0 and higher) handles the requested 5250 interface functions.
Server configuration options
Figure 4-4 shows the Server configuration options. We explain each option in the following sections.
Figure 4-4 Editing the session server
Server
Server identifies the TCP host name or the IP address for the iSeries being accessed by this 5250 user interface session. An iSeries that is not running iSeries Access for Web may also be specified.
Port
Port identifies the port number used by the iSeries Telnet server (TN5250) for incoming requests. The default port value is 23.
Code page
Code page identifies the translation table used to map EBCDIC data from the server to the appropriate character set for the browser. The default value is based on the Coded Character Set ID (CCSID) of the iSeries Access for Web authenticated user ID. Review the iSeries Access for Web 5250 User Interface Help text for a complete listing of code page values.
Workstation ID configuration options
Figure 4-5 shows the session workstation ID configuration options. We explain each option in the following sections.
The workstation ID identifies the device name used in the 5250 interface session. The maximum length of this value is ten characters. Additional characters are truncated. If a workstation device name is specified, system value QAUTOVRT must be set to 1, or the device must be manually created. If no workstation ID is specified, a system created virtual device is assigned. The 5250 interface creates a model 3477 device type by default.
Use user ID
The iSeries Access for Web user profile is used for the workstation ID.
Specify workstation ID
You may enter a workstation ID of your choice. If no value is entered, the system assigns a virtual device name.
Avoid duplicates for this user
This option avoids duplicate name conflicts for the current user. This option resolves conflicts within the servlet instance. iSeries Access for Web identifies the session ID and resolves it within the iSeries Access for Web code.
Potential device ID conflicts are avoided with the current user. A wildcard character is added to the device name. If the device name is longer than ten characters, the last character is truncated before adding the wildcard character. The 5250 interface only creates one session with the device name if this option is not enabled. Additional requests result in an error.
Avoid duplicates with other users
This option avoids device name conflicts with other users on the same server. This option resolves conflicts within the TN5250 server.
Potential device ID conflicts are avoided with other users, PC5250 sessions, or Host on Demand sessions. A wildcard character is added to the device name. If the device name is longer than ten characters, the last character is truncated before adding the wildcard character. The 5250 interface only creates one session with the device name if this option is not enabled. Additional requests result in an error. Table 4-2 shows the possible device names.
Table 4-2 Workstation ID and possible device names
Session view configuration options
Figure 4-6 shows the session view configuration options and demonstrates the difference between Web and Traditional view options.
Important: The workstation ID must not start with a number and cannot contain a blank or
any of the following characters: &, *, %, =, +
Workstation ID option enabled Possible device ID
None Bennie
Avoid duplicates for this users BennieA Avoid duplicates from other users Bennie1 Avoid duplicates for this user and from other users BennieA1
Figure 4-6 Session view
Show navigation bar
This option indicates whether the navigation bar is displayed when a 5250 interface session is active.
Display text using a fixed-width font
This option controls whether a fixed font or a proportional font is used for the 5250 user interface session. Figure 4-7 shows the proportional font in a Web view environment.
Figure 4-7 Web view with proportional font enabled
Figure 4-8 Web with fixed font enabled
Enable active function keys as buttons
This option specifies whether the active function keys are enabled as buttons or displayed as text. Function keys displayed as text are used by the function key bar, a configured keypad, or the function keys on the keyboard. Figure 4-9 shows the current option enabled for Web view.
Figure 4-9 Active function keys as buttons (enabled)
Figure 4-10 shows the current option disabled for Web view.
Figure 4-10 Active function keys as buttons (disabled)
Enable ‘More...’ as a button
This option specifies fields containing “More...” are enabled as buttons or displayed as text. If “More...” fields are displayed as text, additional pages can be retrieved using a page down on a keypad or the page down key on the keyboard. Figure 4-11 shows an example of the “More...” button option enabled.
Figure 4-11 Enabling the ‘More...’ as button (enabled)
Enable menu items as links
This option indicates whether menu option numbers on menus (1 through 99) are displayed as links. When this settings is disabled, users must enter the menu option number from a command line. Figure 4-12 shows the menu items as links.
Figure 4-12 Menu items as links (enabled)
Figure 4-13 Menu items as links (disabled)
Show function key bar
This option is used to display the function key bar beneath the 5250 interface session. The function key bar contains functions keys F1 through F24 displayed as buttons. The function key bar layout and content cannot be configured. You must use My keypads to display a customized keypad. Figure 4-14 shows the function key bar.
Figure 4-14 Function key bar
Enable macros
This option controls a user’s ability to play and record macros. Users can still access My macros.
Enable cursor positioning
This option indicates whether non-input fields are implemented as links or as plain text. If non-input fields are implemented as links, choosing a link updates the current cursor position. If the
Enable message text line as help text link
option is also enabled, the message text line option overrides the cursor positioning behavior. This option enables the support for 5250 interface functions F1, F4, F9, and other cursor positioning functions.Enable message text line as help text
This option enables the message text line as a link to the help for the message. The link places the cursor on the line and submits the F1 function. The message text line is at the bottom of the page. If this option is not enabled, the
Enable cursor positioning
option can be used to enable the link for help on a message. Figure 4-15 shows the enable message text line enabled.Figure 4-15 Enabled message text line
Show function key (Fxx=) on button
This option specifies whether “Fxx=” is included on the button text, when
Enable active
function keys as buttons
is enabled. IfEnable active function keys as buttons
is not enabled the value is ignored. The traditional view always includes “Fxx=” when active functions appear as buttons on the page. Figure 4-16 shows the option disabled.Figure 4-16 Show function key description on button (disabled)
Figure 4-17 shows the option enabled.
Figure 4-17 Show function key description on button (enabled)
Colors
This option specifies how 5250 session colors are mapped to browser colors when an active session is displayed. The foreground colors for fields and Operator Information Area (OIA) are fully configurable for both the Web view and the traditional view. The background colors for fields are fully configurable within the traditional view. The Web view always uses the current browser background colors.
4.4 Usage
This section discusses the usage information for the 5250 interface that is provided by iSeries Access for Web V5R2.
4.4.1 Synchronize
iSeries Access for Web may encounter situations when the browser window does not match the current state of the 5250 session. Figure 4-18 shows how this can happen when using the browser’s back button.
Figure 4-18 Browser back button
Figure 4-19 shows receiving a break message.
Figure 4-19 Break message
Figure 4-20 Automatic update
Figure 4-21 demonstrates a session timeout.
Figure 4-21 Session timeout
4.4.2 My Macros
The iSeries Access for Web 5250 user interface supports creating and saving macros. The macro support provided by iSeries Access for Web differs from the PC5250 product. PC5250 macros are comprised of a series of keystrokes. 5250 user interface macros are made up of a series of cursor position commands and user input. With My Macros, you can delete and edit recorded macros.
Important: To synchronize the browser page with the session state, use the Refresh
Recording a macro
To create a macro, use the Start Recording button on the active session page. The macro must be given a unique name within the My Macros list. Once a recording is started, all subsequent cursor position changes and user input are recorded in the macro. Recording can be paused with the Pause Recording button. Recording resumes when you click the Resume Recording button. To stop the recording process, click the Stop Recording button.
Figure 4-22 shows an example of the record macro page.
Figure 4-22 Record Macro
Playing a macro
To play a macro, choose the macro name from the drop-down list on the active session page and click the Play button. Macros are not restricted to the session in which they were created. You can play them from any session.
Edit
Use the Edit function to modify an existing macro. When you choose this action, the recorded cursor positioning commands and user input are displayed in an input area. Figure 4-23 shows the edit macro input area. You can change or delete these values, or you can add new values. The iSeries Access for Web 5250 User Interface Help text provides a complete list of supported cursor positioning commands.
4.4.3 My Keypads
iSeries Access for Web provides the ability to customize keypads. My Keypads configures the number, location, and content of keypads displayed on an active 5250 session page.
Figure 4-24 shows the My Keypad page.
Figure 4-24 My Keypads
Show Keypad
You can display keypads above the 5250 window, beneath the window, or next to the window. Multiple keypads can display at the same time. By default, only the bottom keypad is shown.
Keypad Layout
The keypad layout is configured by selecting the desired number of rows and columns. Once changes are made, you can click the Configure button to define the actions associated with each button. Decreasing the size of the keypad without configuring truncates keys from the keypad. Increasing the side of the keypad without configuring does not add any keys to the keypad.
Attention: The keypad configuration is used for all sessions and is not associated with a
Configure Keypad
Keypad configuration associates an action with each button in the keypad. The list of available actions is displayed in a drop-down list for each button. Macros may be configured as keys. A special value of None indicates a button should not be shown in this position. This is useful for making a button, near this position, more noticeable.
Adding a macro to the keypad
The following steps explain how to add a macro to the keypad: 1. Create a macro as explained in 4.4.2, “My Macros” on page 91.
2. Click My Keypads. The My Keypads page opens as shown in Figure 4-24.
3. Locate the keypad you want to configure. Click Configure. You can see a small piece of the bottom keypad configuration in Figure 4-25.
Figure 4-25 Configuring My Keypad
4. Locate the key to be edited. Select the down arrow and click the name of the macro. 5. Click OK.
6. Click Save.
4.4.4 Cursor positioning
Several iSeries functions use the current cursor position to carry out their tasks. Several examples include the F1, F4, and F9 keys. The 5250 user interface supports this functionality using links and JavaScript. Input fields and non-input fields are handled differently:
Non-input fields: Within the session view, you can see the
Enable cursor positioning
option. This option shows all non-blank and non-input fields as links. Selecting the link updates the current cursor position from the session. This current cursor position is also displayed in the lower right-hand corner of the window, in the OIA. When a
cursor-sensitive function is invoked, the current cursor position is used.
Input fields: The 5250 user interface uses JavaScript to handle cursor positioning for
input fields. This option is always enabled if the browser supports JavaScript and is configured to use it. The current cursor position is not updated in the OIA when the cursor is placed in an input field.
4.4.5 Active sessions
iSeries Access for Web contains an Active session link via the 5250 tab. This link provides users a list of active sessions. The following information is presented to the user.
Server
Session
Started
Last Accessed
Action
– Reconnect – Stop
Reconnect
A user may leave an active 5250 session by going to another URL or shutting down the browser, but the session remains active.
To reconnect to a session that is still active, click the Active Session link in the 5250 tab. All active sessions for the user are displayed. Click Reconnect to reconnect to the session.
Stop
To stop an active session, perform one of the following actions:
Click the Stop session link in the active session list.
Click the Stop session button from the interface page.
Cleaning up sessions
iSeries Access for Web provides an inactive session timeout based on user or group profiles. This customization function ends interactive sessions when the timeout is exceeded. The inactive session timeout is located under Customize-> User Profile or Group Profile-> 5250.
4.4.6 Limiting functionality
iSeries Access for Web provides users multiple ways to configure and start a 5250 interface session. Administrators can restrict access to this interface, using the Start 5250 sessions policy. When this policy is set to deny, users cannot configure or start 5250 sessions.
4.5 5250 shortcut
You can create a desktop shortcut to access the 5250 interface. We outline the process in the