Designing with Default HTML Translation

How to:

Default HTML translation automatically translates your terminal screens into HTML pages. The HTML translation mode manages the various Telnet sessions (connections) to the mainframe.

With default HTML translation, you have the option of creating a generic template that can surround the translated mainframe screens. It provides a customized look to the web application, but is restricted to cosmetic changes only. To move fields or completely redesign the screen, you must use JavaServer Pages, described later in this section.

The two main servlets that drive the default HTML translation feature are:

To create the default HTML translation of a mainframe application, you can use Telnet Designer to open a connection to the mainframe application, navigate through the application and identify the screens that you want to appear in the web application as you proceed, and save the application session. You can then view the web application by accessing the saved session from a web browser.

When creating a web mode session with default HTML translation, you must identify the screens that you want to be part of the web application. This allows the iWay Emulation Adapter (3270/5250) to determine the appropriate action to take when that screen in encountered as part of the 3270/5250 data stream. The screens you must identify are:

Formatted. Screen that you navigate through and want to appear in the web application.

Hidden. Screens that are not identified are automatically parsed through with the appropriate key strokes, but are not displayed in the web application. For example, you may want to hide the screens to logon to CICS or to enter a VM system.

Blank. Screen that is blank and is not used in the web application. In web mode, you must identify all blank screens.

The following sections explain how to create a default HTML translation using Telnet Designer, and how to apply a generic template to an HTML translation. The steps required for your site may differ, but the concept is the same.


Top of page

x
Procedure: How to Use Default HTML Translation to Create a Web Application

To create a web application using default HTML translation:

  1. In Telnet Designer, click Tools and then, select Emulator.

    The Terminal Emulator opens with the Connection tab active, as shown in the following image. The Connection tab provides fields for the host name, terminal, port number, and deployment mode.

    1. From the Host drop-down list, type or select the host name of the mainframe you want to emulate.
    2. From the Terminal drop-down list, select the terminal type (tn3270 or tn5250) for the emulation.
    3. In the Port field, type the port number to access the host.
    4. For the deployment mode, select Web.
    5. For more options, click the Advanced tab.

      The Advanced tab of the Terminal Emulator opens. Make a selection from the Language drop-down list. The Language selection determines the national language character set that will be used in your emulation session.

      If you want to use a specific terminal name (LU) or pool name (LU pool) with your mainframe connection, type this value in the LU Name field. This option allows the mainframe to dedicate specific connections and privileges to specific telnet ports.

  2. Click Run.

    A connection is made to the mainframe online system.

  3. Logon to the mainframe application that you want to use in your web application.
  4. Right-click the top literal field or a region that uniquely identifies the screen.
  5. From the drop-down list, select Add Screen Identifier.

    The following image shows Telnet Designer and the display of the VTAM screen in the right pane. The Sessions tab is active, and the left pane lists the sessions. The bottom right pane is a console window.

    The Screen Identifier dialog box opens, as shown in the following image. The Field Number and Field Text fields are populated with values appropriate to the cursor placement.

    1. In the Screen Name field, type a name for the screen.
    2. Select a match operation.

      When a match is made, the iWay Emulation Adapter (3270/5250) proceeds with the keystroke that is pressed (for example, the Enter key or PFKEY). As a result, the screen is not revealed to the user during run time.

  6. Click OK.

    The screen is now recognized by the iWay Emulation Adapter (3270/5250), as shown in the following image.

  7. Add screen identifiers for all screens that you want to identify. This includes formatted, hidden, and blank screens.

    The screen name appears in the left pane under the Server(WEB) screens folder.

    Note: To identify a blank screen, right-click in the screen and select Add Blank Screen Identifier from the menu. The following image shows a blank screen with the drop-down list of options.

    The following image shows that the screens that were recognized are added to the database.

  8. Continue identifying the appropriate screens for the web session.
  9. Log off the mainframe application. For example, to log off CICS, enter the command, CESF LOGOFF.
  10. Close the mainframe application by clicking the X in the upper right of the application window.
  11. In the left pane, right-click the Server (WEB) folder under Sessions and select Save As.

    The Save As dialog box opens as shown in the following image.

    1. In the Name field, type a name, for example, WEB2.
    2. In the Remarks field, type instructions or comments.
  12. To save the web application session, click Save.

    The saved web application appears under the web folder in the left pane of Telnet Designer, as shown in the following image.

For information on how to package and deploy the web application, see Deploying Your Application on a Web Application Server.


Top of page

x
Procedure: How to View the iWay Emulation Adapter (3270/5250) Web Application

To view the iWay Emulation Adapter (3270/5250) web application:

  1. In a web browser, enter the appropriate URL to access the machine where the iWay Emulation Adapter (3270/5250) web application is deployed, for example:
    http://localhost:8080/ibitelnet/index.html

    For deployment instructions, see Deploying Your Application on a Web Application Server.

    The default HTML window for the iWay Emulation Adapter (3270/5250) opens.

  2. Click the Management Console link and log on using admin as the user name and password.

    The following page is displayed.

  3. Click the Templates tab.

    The Templates tab is displayed, which contains a list of any available iWay Emulation Adapter (3270/5250) web applications. For example:

  4. Click the web application you want to view, for example, WEB2.xml.

    A window opens and displays the default HTML translation. For example:


iWay Software