Web-to-Host Wizard

BlueZone Web-to-Host

Basic Configuration Tutorial

The purpose of this tutorial is to walk you through the complete process of creating a Site, a Launch Folder and one BlueZone 3270 Mainframe emulation client session that will automatically connect to your host when launched.  We will not be discussing any of BlueZone Web-to-Host's more advanced features here.

This tutorial assumes that you do not have a web server running on this machine and that you want to use the built-in web server that is provided with the Web-to-Host Wizard.

NOTE  You can substitute a different BlueZone emulation client like the iSeries Display or BlueZone VT Display.  However, you should be aware that the BlueZone configuration screens may look slightly different.

Tutorial

  1. Launch the Web-to-Host Wizard by double clicking the BlueZone Web-to-Host Wizard icon that was created during the installation process.  The Sites dialog will be displayed as shown here:

  1. Click the Create button.  A Windows common file dialog will be displayed with the default path for the location of the site as shown here:

  1. If the default location is acceptable, proceed with the next step.  Otherwise, use this dialog to navigate to the location where you want to store the Site.

  2. Once you have decided upon a location, give the Site a name and click the Open button as shown here:

  1. A confirmation box will be displayed as shown here:

  1. Click the OK button.  In this example, a Site called MySite will be created

  2. The Sites dialog will be displayed as shown here:

NOTE  The Site Language setting controls the language version of the BlueZone emulation client for that particular site.  For example, it is possible to create one site that launches the English version of the BlueZone Mainframe Display emulator and another site that launches the French version of the BlueZone Mainframe Display emulator.

  1. Click the Next button.  The Launch Folders dialog will be displayed as shown here:

  1. Click the Create button.  The New BlueZone Launch Folder dialog will be displayed as shown here:

  1. Give the new Launch Folder name.  In this exercise we will call it TestFolder as shown here:

  1. Leave the Folder Options set to "Distribute as Standard Web-to-Host".

To learn more about the Folder Options (Deployment Mode Options) click here

  1. Click the OK button.  The Launch Folder will be created and the Launch Folders dialog will be displayed as shown here:

  1. Click the Next button.  The Sessions dialog will be displayed as shown here:

  1. Click the Create button.  A New BlueZone Session dialog will be displayed as shown here:

  1. Choose Mainframe Display session from the drop down list box and click the OK button.  A new dialog box will be displayed prompting you for the Session Name as shown here:

  1. Give the session a name.  In this example I called my session Mainframe.  Do not check the "Use existing profile?" checkbox.  In the Options section, leave the "Allow Local Save?" checkbox selected.

  2. Click the OK button.  At this point, since you created a BlueZone Mainframe Display profile that did not previously exist by typing in the session name "Mainframe", a BlueZone Mainframe Display session will automatically be launched so that you can configure this brand new session.  A progress bar will be displayed and when finished, the BlueZone session will launch and automatically prompt you to define a new connection.  Enter the necessary information in the Define New Connection dialog as shown here:

  1. Enter a Connection Name, Host Address, LU Name (if required) and change the TCP Port if it's not port 23, then click the OK button.  Click the OK button again to exit the TN3270E Properties dialog.  You should now be on the Session Configuration dialog.

  2. Place a check the Auto-Connect Session checkbox.  Click the OK button.

  3. Now that the BlueZone session is running, this is where you would make any customizations to the BlueZone emulation client.  If you are not that familiar with BlueZone or you don't want to spend the time to completely customize the BlueZone session now, that's okay because you can come back to this point and finish the customization process any time you wish.

  4. Close down the BlueZone Mainframe Display session being sure to answer Yes to the "Save changes to session settings? message box.

  5. The Sessions dialog will be displayed with the name of the session you just created at the top of the Sessions window as shown here:

  1. Click the Next button.  The Advanced Settings page will be displayed as shown here:

This page has buttons which allow you to make advanced configuration changes to your sessions.  For this tutorial, we're not going to make any changes on this page.

  1. Click the Next button.  The Test Launch Folders dialog will be displayed as shown here:

  1. In the Available Sites section, make sure that the "Make selected site accessible via built-in web server?" checkbox is enabled.

  2. Also, enable the "Use built-in web server?" checkbox.

NOTE  If you get the following message, you probably have a web server running on this machine.

You can't have two web servers using the same listening port.  If you still want to use the built-in web sever for testing, change the port to something other than port 80 (try 8080 for example) and try enabling the checkbox again.

  1. Click the Test BlueZone button.  Your default web browser will launch and open the Launch Folder you have selected in the listbox.

  2. After a few seconds you will be presented with a Security Warning asking if you want to install the Web-to-Host Control Module v4 as shown here:

  1. Click the Install button.  The Web-to-Host Control Module will install, then display a progress bar showing the downloading of the BlueZone emulation client files as shown here:

  1. The Launch Page you created page will contain a Launch Pad with an icon representing the BlueZone session that you created as shown here:

  1. To launch the session you created, double click the Mainframe session icon.  You will be presented with another Security Warning asking if you want to run "BlueZone Mainframe Display" as shown here:

  1. Click the Run button.  Your BlueZone session will immediately launch and if configured correctly, automatically connect to your host.

NOTE  These security warnings will only be presented the first time you download and launch a particular BlueZone emulation session.

Congratulations!  You have successfully created and launched your first BlueZone session using the Web-to-Host Wizard.

To exit from the Wizard, click the Quit button.

Related Topics

Wizard How To Guide

The Local Launch Feature