Information Center

IBM Host On-Demand Update Site Utility

The IBM Host On-Demand Update Site Utility is a utility to generate a Host On-Demand Plugin for a Workplace Client Technology (WCT) environment. This utility can be used to do the following:

  1. Create an appropriate directory structure at the specified directory.
  2. Download Host On-Demand jar files from the specified Host On-Demand server.
  3. Build the Host On-Demand feature. The Host On-Demand feature consists of the Host On-Demand plugin and its fragments. They are built using the downloaded Host On-Demand jar files and information provided by administrators on the Utility GUI.
  4. Place the contents in a file system that can be used as an Eclipse Update Site.
  5. Create an XMLAccess script that can be used to install the Host On-Demand plugin and create a page layout on Workspace Collaboration Services (WCS).

Administrators must first run the Host On-Demand Deployment Wizard and create an HTML-model page to define the sessions they want accessed by a client running in a WCT environment before running this utility. After providing the appropriate information, click the "Generate and Deploy Plugin" button in the bottom row of buttons to complete the task.

For additional information about WCT support, refer to the Planning, Installing, and Configuring Host On-Demand Guide.

Basic Information

Field Description
Update Site Destination Directory Specifies a local directory where the output of the tool should be placed. You should specify a directory that is accessible via an HTTP connection if you intend the location to be used as an Eclipse Update Site.
HOD Code Base Informs the tool of the URL were the Host On-Demand archive files are installed. When the tool runs, files will be downloaded from this web server. The Host On-Demand client code will also use the URL so a fully qualified URL is preferable.
Deployment Wizard Output File This field must match the name of the Deployment Wizard generated HTML file. This will also be the name of the Eclipse feature that is generated.
Feature Version Specifies the version number of the generated feature.
User JAR File Path Customers wanting to include custom code to interact with the Host On-Demand sessions need to have their code in jar files. Jar files specified in this field will be bundled with the Host On-Demand Plugin. If multiple jar files are required, place a comma between the paths to each jar or use the Browse button.
User Configuration Factory Class (If shown) Class name of code provided by customers to be called when the Host On-Demand Plugin is loaded. This class would provide:
  • Name of the Deployment Wizard generated file to access
  • Properties object containing HTML parameters to be passed to the Host On-Demand client code
This class must exist in a jar file specified in the "User JAR File Path" field.
Alternate Publish Directory (If shown) For customers who install Deployment Wizard generated pages and files in a publish directory different than the Host On-Demand publish directory, the URL to the separate alias is needed. The Host On-Demand client code will also use the URL to retrieve session information so a fully qualified URL is preferable.

Runtime Code

Component Description
Base All Host On-Demand Plugins must include this component in order for the plugin to load. It cannot be de-selected.
5250 Extension Component providing support for 5250 File Transfer and an iSeries JDBC driver. If these capabilities are not required, this component should be de-selected to reduce the size of the feature.

Code Pages

Display and printer sessions have a property that specifies the code page of the host they will be communicating with. Host On-Demand has grouped the code pages by country or region. By checking the check box next to each group, support for that particular host code page will be included in the generated feature. You must include all code pages needed in your environment in order for the emulator sessions to work properly. Optionally, you may uncheck groups that are not needed in order to reduce the size of the feature.