Web-to-Host Wizard

BlueZone Web-to-Host

Web-to-Host Wizard Architecture

The Web-to-Host Wizard uses a hierarchical file structure.  At the top level it starts with the creation of a Site.  A Site is actually a folder which contains one or more Launch Folders which contain Launch Pages which contain the code necessary to launch the desired BlueZone Sessions.

The Site is the top level in the hierarchy.  When you start the Web-to-Host Wizard for the first time, there are no configured Sites, Launch Folders, or Sessions.

The Site Folder

When you use the Wizard to create a Site, you are actually creating a Site Folder along with several sub folders which contain the files necessary to serve up the BlueZone emulation clients.  These files are shared among all the Launch Folders.  

The name of the Site Folder is the same as the Site name which is chosen by the Web-to-Host Administrator when the Site is created.

The Wizard requires that you create at least one Site.  You may however, create multiple Sites.  If you do, keep in mind that Site is the top level.  If you create more than one Site, and you want to make a change to all your Sites, you will have to make that change to each Site individually.

When you use the Wizard to create a Site, these are the sub-folders that will automatically be created:

\cabs

\configs

\controls

\images

\shared

\template

These sub-folders contain; the BlueZone emulation clients; client configuration files that you will create; the Web-to-Host Control Modules, which are used to control the downloading of the BlueZone emulation clients, as well as other files; any images used in the Launch Pages; a "shared" folder where certain shared files are stored; the Launch Page templates, which control the "look" of the Launch Pages.

In addition to the sub-folders, the Site Folder contains:

bzstring.dl_ - A file which controls the language of the BlueZone emulation clients (compressed)

bzstring.dll - The same file as above but uncompressed

ezclear.exe - A utility for Administrator's called eZClear

seagull.saf - The Software Activation File (SAF)

The Launch Folder

Below the Site Folder are Launch Folders.  When you use the Wizard to create a Launch Folder, you are creating a folder that contains several web pages called Launch Pages which contain data necessary to launch the desired BlueZone emulation client sessions.  In addition, there are several other files stored at the Launch Folder level.  The name of the Launch Folder is

When a Launch Folder is created, the Wizard copies all the files from the \template folder, which is located in the at the Site Folder into the newly created Launch Folder.

The name of the Launch Folder is chosen by the Web-to-Host Administrator when the Launch Folder is created.

The Wizard requires that you create at least one Launch Folder.  You may however, create multiple Launch Folders.  If you do, keep in mind that if you want to make a change to all your Launch Folders, you will have to make that change to each Launch Folder individually.

When you use the Wizard to create a Launch Folder, these are the files that will automatically be copied from the \templates folder to the newly created Launch Folder:

default.dst - Used to control the version of the downloaded files.

default.htm - Contains a JavaScript that determines the browser type

default.ini - Controls the downloading of the BlueZone emulation client files

desktop.ini - Controls the downloading of the BlueZone emulation client files for Served Desktop Mode only.

launch_j.htm - Contains an Embed Tag for Non-IE browsers.

launch_x.htm - Contains an Object Tag for IE browsers.

As the BlueZone Administrator, you have complete control over the look of the Launch Pages.  To control the "look" of the Launch Pages, we provide a customizable "template" (located in the Site Folder) that can be tailored to your particular needs.  You can add your own company logo and otherwise change the look of the web pages in the \template folder.  When a Launch Folder is created, the Wizard copies the launch_x.htm and launch_j.htm pages from the \template folder to the new Launch Folder.  By customizing these web pages, you can customize the look and content of your Launch Pages.

BlueZone Emulation Client Sessions

When you use the Wizard to create a Session, you are actually modifying the Object Tag and Embed Tag located on the launch_j.htm and launch_x.htm pages.  These pages are located in the Launch Folder.

The Wizard requires that you create at least one Session in a Launch Folder.  You may however, create multiple Sessions.  If you do, keep in mind that if you want to make a change to all your Sessions, you will have to make that change to each Session individually.

Launch Pages created by the Wizard, can be configured to launch a single BlueZone emulation client session or many sessions.  The Launch Page can be very simple, or it can be configured to use the Launch Pad feature which is used to manage multiple sessions.  By default, when you create a Launch Folder, the Launch Pad feature is enabled for all Sessions associated with that Launch Folder.


How the Wizard Works

When you create an new Launch Folder, the Web-to-Host Wizard actually creates a folder inside the Site folder.  in the root of the web server.

For example, on a Microsoft IIS web server, if you created a Site named "MySite", a folder will be created in:

C:\inetpub\wwwroot\MySite\

 

When you create a Launch Folder, the Wizard creates the Launch Folder inside the Site folder as shown here:

C:\inetpub\wwwroot\MySite\MyLaunchFolder\

 

When a Launch Folder is created, the Wizard copies all the files from the \template folder, which is located at the Site level into the newly created Site Folder.

These are the Launch Folder files that are created:

default.dst - Used to control the version of the downloaded files.

default.htm - Contains a JavaScript that determines the browser type

default.ini - Controls the downloading of the BlueZone emulation client files

desktop.ini - Controls the downloading of the BlueZone emulation client files for Served Desktop Mode only.

launch_j.htm - Contains an Embed Tag for Non-IE browsers.

launch_x.htm - Contains an Object Tag for IE browsers.

The next step is to add Sessions.  When you add a Session, the Wizard modifies the Object Tag and Embed Tag which are located on the launch_x.htm and launch_j.htm pages.  These pages are called Launch Pages.

One Launch Page for ActiveX browsers (launch_x.htm), like Internet Explorer, and one Launch Page for Java capable browsers (launch_j.htm), like Netscape and Mozilla.

The Wizard uses the values supplied by the BlueZone Web-to-Host Administrator, and converts those values to parameters that get written to the Launch Pages.

In the ActiveX Launch Page (launch_x.htm) the Wizard modifies the existing Object Tag which contains all the parameters and values necessary to launch the emulation sessions that have been configured on this web page.

In the Java Launch Page (launch_j.htm) the Wizard modifies the existing Embed Tag and an Object Tag which contain all the parameters and values necessary to launch the BlueZone emulation client Sessions that are configured in the Wizard.


Related Topics:

Basic Web-to-Host Wizard Operations

Deployment Mode Options