Creating sites, launch folders, and sessions

These steps describe the process of creating a site, launch folder, and session that automatically connects to your host when started.

1. Click Start → All Programs → BlueZone Web-to-Host → BlueZone Web-to-Host Wizard 7.1.
2. Click Create.

   The Create Site Installation Folder window opens with the default location and site name of C:\InetPub\WWWRoot\7.1.2.2641.

   1. Optional: Change the site location.
   2. Optional: Change the site name.
   3. Click Open.
   4. Click OK to create the site.
      In this example, the site name was changed to bzweb1.

      The Sites window will contain the new site.

      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 starts the English version of the BlueZone Mainframe Display emulator and another site that starts the French version of the BlueZone Mainframe Display emulator.
3. Click Next to open the Launch Folders window.
4. Click Create.
   1. The Folder Name field will be filled in with w2h, but you can type any name you wish.
      This example uses the folder name TestFolder.
   2. Leave the Folder Options set to Distribute as Standard Web-to-Host.
      Refer to Deployment mode options for more information about the folder options.
   3. Click OK.
      You return to the Launch Folders window. The Launch Folders list contains the new launch folder.
5. Click Next to open the Sessions window.
6. Click Create.
   1. In the menu, select the session type. For example, select Mainframe Display and click OK.
   2. Type a session name. For example, Mainframe.
   3. Do not select the Use existing profile? check box.
   4. In the Options section, leave the Allow Local Save? check box selected.
      For more information on the local save feature, refer to Setting the local save feature.
   5. Click OK.
      A status bar opens and the BlueZone Mainframe Display profile is created. When complete, the session starts and the Define New Connection window opens. You must configure the new session.

      Note: If you need more information on configuring a session, click the Help icon at the bottom of any window. The BlueZone Display and Printer Help file opens to the relevant topic.
   6. Type a Connection Name and Host Address.
   7. If required, type an LU Name.
   8. Change the TCP Port if necessary.
   9. Click OK to exit the Define New Connection window.
   10. Click OK to exit the TN3270E Properties window.
   11. Click OK.
7. At this point, you can customize the BlueZone session. If you do not want to do this now, you can customize the session at any time in the future.
8. Close the BlueZone Mainframe Display session.
   You will return to the Sessions window. The Sessions list now contains the new session.
9. Click Next to open the Advanced Settings window.

   You can make advanced configuration changes to a launch folder in the Advanced Settings window. The advanced configurations are not covered in this topic. Refer to Advanced configuration for more information

10. Click Next. You will be prompted to set the server URL.
11. Click Yes. You will now be taken to the Test Launch Folders window.
    1. If you have IIS running on this machine, all you have to do is click the Test BlueZone button. If you do not have IIS running on this machine, you can use the built-in web-server by clicking the Start Web Server button.
       Note: If you get a "Port in use" message when you click the Start Web Server button, you may have a web server running on your machine.

       You cannot have two web servers using the same listening port.

       If you want to use the built-in web server for testing, change the port to something other than port 80, for example 8080, and try selecting the check box again.

    2. Click Test BlueZone.
       Your default web browser starts and opens the launch folder that you selected in the Folder menu.

       If your default browser is a non-IE browser, you will be prompted to download the bzw2h.jnlp file or bzw2h.bzlp file by clicking the OK button.

       The BlueZone Session Manager will launch and will contain a launch pad with an icon representing the BlueZone Mainframe session that you created.

       If you are using Internet Explorer, you will be prompted to allow the installation of the BlueZone Web-to-Host Control Module v7.1 (ActiveX Control) and you will be prompted to add your IP address to your Trusted Sites in Internet Explorer.

    3. Download the JNLP file or BZLP file or allow the Web-to-Host ActiveX Control.
       Note: When using Internet Explorer, you must add the IP address of your Web-to-Host server (even if it's your own local machine) in order for the ActiveX Control to install. If you click the Allow button and Install button without adding your IP address, you will get a message at the bottom of your IE session, "An add-on for this website failed to run." To correct this situation, follow the instructions on the web page and add your IP address to your list of Trusted Sites. Once this is done, press F5 to refresh the web page. Now you will be able to install the ActiveX Control by clicking the Install button.

       Respond to the Internet Explorer Add-on Installer – Security Warning by clicking the Install button. The launch page opens and contains a launch pad with an icon representing the BlueZone Mainframe session that you created.
    4. Double-click the Mainframe session icon.
       Another security warning opens asking if you want to run BlueZone Mainframe Display.
    5. Click Run.
       Your BlueZone session starts and automatically connects to your host.

       Note: These security warnings are only presented the first time that you download and start a particular BlueZone session.
12. Click Home to return to the Sites window or click Quit to exit the Wizard.