How to Deliver Custom Desktop Shortcut Icons with Served Desktop Client

Introduction

When using BlueZone Web-to-Host with the Served Desktop Client option, it is possible to deliver multiple BlueZone sessions with multiple desktop icons.

NOTE  This procedure can not be accomplished using the Web-to-Host Wizard.  It must be performed manually as described below.

Requirements

This procedure assumes that you have BlueZone Web-to-Host, version 3.1 or higher, installed on a web server, with the Served Desktop Client delivery option configured and working.

Objective

With the Served Desktop Client option enabled, by default, when you select the BlueZone Mainframe Display session link, the BlueZone Mainframe emulator will install, with one desktop shortcut icon, which will launch one BlueZone Mainframe Display session.

The object of this exercise, is to demonstrate how you can configure BlueZone Web-to-Host Served Desktop Client mode to install BlueZone with multiple sessions and with corresponding desktop shortcut icons for each session.

Overview

The first part of this procedure, will show you how to configure BlueZone Web-to-Host to install three BlueZone Mainframe Display sessions. Then, in the second part, the procedure will show you how to create and deliver a custom desktop icon for each of these sessions.

NOTE  This procedure will show you how to configure three Mainframe Display sessions with three corresponding shortcuts.  If you want to launch more than three sessions, simply modify the Object Tag accordingly.  BlueZone can launch up to 99 sessions.  Also, if you want to launch BlueZone emulators other than Mainframe Display, simply modify the accordingly.

Procedure - Part 1

1. Create configuration files for the three sessions that you wish to install on the End Users workstation.

2. Rename them, S1.zmd, S2.zmd and S3.zmd.

3. Copy or FTP these files to the bz3270 folder on the web server where BlueZone Web-to-Host is installed.

4. Also located in the bz3270 folder, edit the obj_d_3.htm file with Notepad.

5. Add the additional session numbers to the “Sessions” PARAM NAME value, to both Object Tags, as shown in red below.

NOTE  This example only shows the Internet Explorer Object Tag. If you want to support Netscape browsers as well, you will have to make the same modifications to the Netscape Object Tag as well.

<OBJECT ID="Seagull Web-to-Host Control Module v3"

CLASSID="clsid:037790A6-1576-11D6-903D-00105AABADD3"

CODEBASE="../sglw2hcm.ocx#Version=-1,-1,-1,-1" HEIGHT=0 WIDTH=0>

<PARAM NAME="IniFile" VALUE="default.ini">

<PARAM NAME="Sessions" VALUE="MD_S1,MD_S2,MD_S3">

<PARAM NAME="MD_DistFile" VALUE="display.e3d">

<PARAM NAME="MD_S1" VALUE="mfdisp1.zmd">

<PARAM NAME="MD_S1_Save" VALUE="Yes">

</OBJECT>

6. Add the lines necessary to launch two additional sessions, as shown in red.

<OBJECT ID="Seagull Web-to-Host Control Module v3"

CLASSID="clsid:037790A6-1576-11D6-903D-00105AABADD3"

CODEBASE="../sglw2hcm.ocx#Version=-1,-1,-1,-1" HEIGHT=0 WIDTH=0>

<PARAM NAME="IniFile" VALUE="default.ini">

<PARAM NAME="Sessions" VALUE="MD_S1,MD_S2,MD_S3">

<PARAM NAME="MD_DistFile" VALUE="display.e3d">

<PARAM NAME="MD_S1" VALUE="mfdisp1.zmd">

<PARAM NAME="MD_S1_Save" VALUE="Yes">

<PARAM NAME="MD_S2" VALUE="S2.zmd">

<PARAM NAME="MD_S2_Save" VALUE="Yes">

<PARAM NAME="MD_S3" VALUE="S3.zmd">

<PARAM NAME="MD_S3_Save" VALUE="Yes">

</OBJECT>

7. Change the name of the S1 session from mfdisp1.zmd to S1.zmd, as shown in red.

<OBJECT ID="Seagull Web-to-Host Control Module v3"

CLASSID="clsid:037790A6-1576-11D6-903D-00105AABADD3"

CODEBASE="../sglw2hcm.ocx#Version=-1,-1,-1,-1" HEIGHT=0 WIDTH=0>

<PARAM NAME="IniFile" VALUE="default.ini">

<PARAM NAME="Sessions" VALUE="MD_S1,MD_S2.MD_S3">

<PARAM NAME="MD_DistFile" VALUE="display.e3d">

<PARAM NAME="MD_S1" VALUE="S1.zmd">

<PARAM NAME="MD_S1_Save" VALUE="Yes">

<PARAM NAME="MD_S2" VALUE="S2.zmd">

<PARAM NAME="MD_S2_Save" VALUE="Yes">

<PARAM NAME="MD_S3" VALUE="S3.zmd">

<PARAM NAME="MD_S3_Save" VALUE="Yes">

</OBJECT>

8. Also located in the bz3270 folder, find the display.e3d file, and edit it with Notepad.  The default file will look something like this:

bzmd32C3.cab,1

mfdisp1.zmd,1

seaglapl.ttf,1

../seagull.saf,1

9. Make the following changes shown in red.

bzmd32C3.cab,1

S1.zmd,1

S2.zmd,1

S3.zmd,1

seaglapl.ttf,1

../seagull.saf,1

10. Save the file and exit Notepad.

You now have an Object Tag that will install three Mainframe Display sessions (S1, S2 and S3) using three configuration files (S1.zmd, S2.zmd, S3.zmd).

Procedure - Part 2

1. From a test workstation, access the BlueZone Web-to-Host web site and install BlueZone Mainframe Display Served Desktop Client.  Immediately after the installation is complete, all three sessions will launch, but you will only have one BlueZone desktop shortcut icon.

2. Using Windows Explorer, navigate to the place where Windows installs the desktop icons.

For example: In Windows XP, it’s: C:\Documents and Settings\All Users\Desktop

3. Locate the Mainframe Display shortcut and highlight it.

4. Copy the shortcut (CTRL-C then CTRL-V) two times.

5. Rename the shortcuts as follows: Mainframe Display S1, Mainframe Display S2, Mainframe Display S3.

6. Highlight the Mainframe Display S1 shortcut, right click, and select Properties.

7. Add a “space” followed by /S1 to the end of the Target line as shown here:

"C:\Program Files\SEAGULL\BlueZone\BZMD.EXE" /S1

8. Repeat this process for the other two shortcuts by adding /S2 and /S3 respectively.

9. Copy or FTP all three shortcuts to the bz3270 folder on your web server.

10. Add the files names of the shortcuts to the display.e3d file as shown here in red.

bzmd32C3.cab,1

S1.zmd,1

S2.zmd,1

S3.zmd,1

seaglapl.ttf,1

../seagull.saf,1

Mainframe Display S1.lnk,1

Mainframe Display S2.lnk,1

Mainframe Display S3.lnk,1

CAUTION!  Shortcuts have a file extension of .lnk, even though Windows does not display them.  This feature will not work unless you include the file extensions as shown in the above example.

11. Save the file and exit Notepad.

Congratulations! You have successfully completed this exercise.