Last Updated: March 2019
|
Note: Before using this information and the product it supports, read the information in Notices. |
Fourth Edition (March 2019)
This edition applies to Version 14.0 of IBM(R) Host On-Demand (program number 5724-I20) and to all subsequent releases and modifications until otherwise indicated in new editions.
(C) Copyright International
Business Machines Corporation 1997, 2019. All rights reserved.
U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
The following icons are used in this document:
|
Points out important notes. |
|
Highlights tips. |
The Web browser-based access of IBM Host On-Demand gives your users a simple way to reach critical host data. Just click a hyperlink to launch the Host On-Demand Java(TM) applet. This Web-to-host connectivity solution helps provide secure Web-browser access to host applications, so you can take existing host applications to the Web without programming.
With support for TN3270E, TN5250, VT52, VT100, VT220, VT320, VT420 and CICS(R) Transaction Gateway access, along with Database On-Demand and FTP, users can have a single interface to their key host data. Because Host On-Demand is based on Java technology, its interface has the same look and feel across various operating environments.
Host On-Demand provides access to host applications from a Web browser. The browser downloads the Host On-Demand Java applet from the Web server and then connects to most standard Telnet servers to access host applications. With Host On-Demand, the client applet contains the emulation functionality. The host configuration information can be provided to the applet from an HTML file or by using the Host On-Demand configuration server.
Using Host On-Demand eliminates the need to deploy the software to individual user desktops. Users can connect directly to a host system, such as IBM iSeries or eServer i systems, without the need for extra hardware and software between the client and the Telnet server. You can install Host On-Demand on many server platforms, accommodating various-size organizations and branch offices.
As software updates occur, the latest version of IBM Host On-Demand is downloaded each time a user accesses the software, helping eliminate the need to install code on client workstations. With the cached client feature, users download only once, after the initial installation or once after a software update. Subsequent uses then originate from user hard drives, while code updates are handled in the background through the cached client. Users can be productive and have the newest version of code, with low distribution costs for your business.
IBM Host On-Demand is sold as part of the IBM Host Access Client Package for Multiplatforms, and the Host Integration Solution. The Host On-Demand Knowledge Center has more information on these packages:
This document provides information about installing IBM Host On-Demand Version 14.0 on an iSeries or eServer i server and using TN5250 emulation. The IBM Host On-Demand product has many additional functions that are described in the Knowledge Center located on the web at:http://www-01.ibm.com/support/knowledgecenter/SSS9FA_14.0.0/com.ibm.hod.doc/WebSphereHOD.htm
The most recent version of this document is available as a tutorial in the Host On-Demand Version 14.0 Knowledge Center. Use the Knowledge Center feedback form to send us your comments. We appreciate your suggestions!
For more information about Host On-Demand, refer to the following address:
http://www-03.ibm.com/software/products/en/rationalhostondemand/
Here is a high-level overview of steps to install and configure Host On-Demand for TN5250 emulation.
Details on the steps to install and configure Host On-Demand for TN5250 emulation.
Verify your have access to the iSeries or eServer i, with QSECOFR authority.
You will also need a personal computer with one of the Microsoft Windows operating Systems.
Confirm the operating system level and prerequisites licensed programs are installed on the OS/400 operating system.
|
Use the dspptf command on the system to determine the level of operating system installed. Recent cumulative service is recommended. You can use the go licpgm command on the system. Select option 10 to display all, then press F11 twice to display the option number. |
Confirm a Telnet server that is configured to accept a non-secure connection. The instructions in this document are for a non-secure connection. For information about Host On-Demand TSL connections, refer to the Knowledge Center. Confirm a supported Web Server is installed Verify one of the following HTTP servers is installed:
| Toolbox level | Option number |
|---|---|
| 1.2 | 3 |
| 1.1.8 | 4 |
| 1.3 | 5 |
| 1.4 | 6 |
Java PTFs are ordered separately from the cumulative OS/400 or i/OS fixes. For more information, refer to the Server requirements for Host On-Demand on i/OS and OS/400 operating systems, in the Planning,Installation, and Customization Guide. Java PTFs are ordered separately from the cumulative OS/400 or i/OS fixes.
The recommended minimum PTF levels are as follows:
| i/OS | PTF |
|---|---|
| V5R1 | SF99069 |
| V5R2 | SF99169 |
| V5R3 | SF99269 |
Use the following procedure to remotely install Host On-Demand onto an OS/400 or i/OS operating system, from a personal computer. Refer to the Planning, Installation, and Customization Guidefor additional details about installing on i/OS and OS/400.
If there is a previous Host On-Demand installation, use the ENDHODSVM command (from a command line) to stop the Host On-Demand Service Manager.
Host On-Demand is installed using the IBM installation Manager.Administrators must first install IBM Installation Manager on the system where Host On-Demand will be installed. It must be installed in Administrator Mode. Then install the Host On-Demand using the Installation Manager.
IBM Installation Manager Version 1.8.3 or higher is required to install Host On-Demand V14.0.
You need the following check list to ensure before installing Host On-Demand V14.0:
Ensure that IBM Installation Manager v1.8.3 or higher is installed.Machine should have minimum 1.2 disk space for installation (Installed and temporary space) for 32-bit architecture and one language. If installing more than one language this value increases 4 to 8 MB for each language.
User must be logged on with the Administrator privileges.
A supported version of HTTP server (for example, IBM HTTP Server or Apache server) is installed on the system.
If you have a previous version of Host On-Demand installed, there is no direct migration path from HOD v11 to HOD 12 and above. You will be instructed to uninstall it.You must take a backup of any customized files from the previous Host On-Demand directories, specifically the private directory and any client pages created with the Deployment Wizard. These can be reused on HOD. Click Next to automatically delete the previous version. After the previous version is deleted, Host On-Demand installation continues.
The initial Host On-Demand and above install requires that an empty path be available. Therefore, you need to either rename or delete any existing folders or directories where HOD was previously installed.
Install Host On-Demand using the IBM Installation Manager. It is recommended not to click Cancel when an installation is in progress.
Restore the private directory to the Host On-Demand folders or directories.
Edit any clients created with the Deployment Wizard with the Host On-Demand Deployment Wizard and deploy to the HOD server. You can install Host On-Demand using installation manager on all the supported platforms.
After the Installation Manager is successfully installed, use the following steps to install Host On-Demand.
Start Installation Manager according to instructions for the platform.
Select File > Preferences
Select Repositories on the left. This will show the available repositories that have been added to Installation Manager.
Select Add Repository if Host On-Demand is not listed.
Click Browse and navigate to the location of the extracted Host On-Demand path and select the diskTag.inf file present in disk1 folder. Click OK and the new repository location should be listed.
Click Test Connections to ensure that the Repository URL is available.
From the Installation Manager Start page, click Install. The Installation Manager searches its defined repositories for available packages.
Select the Host On-Demand package. Click Next.
Read the license agreements, then if you agree to the terms of the license agreement, click I accept the terms of the license agreement, and click Next to continue.
Select Create a new package group and choose the Architecture. If the operating system is 64-bit, select 64-bit or 32-bit to install the product in the corresponding bit mode. Then click Next.
Select the languages you want to install. The default is English. Click Next.
Select the Host On-Demand 14.0 feature. Click Next.
Review and specify all information under the Host On-Demand 14.0 tab. For details, refer to Installing the Host On-Demand server and related software of Planning, Installing, Configuring Host On-Demand.
Review the summary information, and click Install.
|
The IBM HTTP Server (powered by Apache) Web site IBM i For Power Systems (including AS/400, iSeries, and System i) provides information on the basic configuration for the HTTP server and discusses instance configuration. |
In a Web browser, connect to the Administrative port for the iSeries or eServer i, at the following address:
http://hostname:2001 The *admin instance must be started. You must have proper authority on the server to access this page.
Select Administration and Manage HTTP Servers. Select the instance to be configured.The HTTP server selected must be APACHEDFT with Apache type. If the type is Original, this is IBM HTTP Server.
Under Web Site Definition, select Aliases and Redirection.
Click Add in the Map URLs to the host file system section.
Select Alias. Set the URL path to /hod and the Host directory to /QIBM/ProdData/hostondemand/hod.
Select Edit Configuration File (located in the bottom right). Add the following text lines to the configuration, just before the < line.
< Directory /QIBM/ProdData/hostondemand/hod>
<LimitExcept GET POST>
order deny,allow
deny from none
</LimitExcept>
AllowOverride None
UseCanonicalName Off
HostNameLookups Off
Options +FollowSymLinks
</Directory>
Start the IBM HTTP server with the STRTCPSVR SERVER(*HTTP) command.
|
You can use the WRKACTJOB command to see if the instances are running. All of the instances that are running will appear under the QHTTPSVR subsystem. |
Open a browser on a Windows machine and type the following address: http://hostname/hod/HODMain.html.If you see the Host On-Demand HTML page, the HTTP Web server has found the Host On-Demand publish directory.
Host On-Demand provides a sample HTML file generated by the Host On-Demand Deployment Wizard. This sample file provides 3270, 5250, VT, and FTP sessions, which include download client and Java auto-detection components.
Locate the hodclients.zip file on your Host On-Demand server in the /<HOD install directory>/hod/samples/html directory.
Copy this zip file to your /<HOD install directory>/hod directory.
|
If you would like to create your own Host On-Demand Deployment Wizard files, or use other Host On-Demand options, see the Host On-Demand Knowledge Center. Reference the information about using Host on-Demand emulator clients. |
Web pages from the Deployment Wizard can be distributed to servers using the DWunzip tool. DWunzip is located in the following directory on the iSeries or eServer i: /<HOD install directory>/lib/samples/DWunzip/ The file is called DWunzip-AS400.sh. To load the hodclients.zip file to the server using DWunzip, do the following:
Open the DWunzip-AS400.sh file. Verify that the runtime variables are correct and correspond with your environment. Change the default values of the runtime variables if they do not correspond with your environment.These include the following:
Confirm that DWunzip is authorized with the needed execute permissions and authorized to write to the publish directory on the server.
From the server OS command prompt, use the QSH command to run QSHELL.
|
QSH commands are case-sensitive. You can print the QSH scroller to place the information into a job log for future reference. |
Run the DWunzip command file for your operating system, from the Host On-Demand published directory.
DWunzip-AS400 hodclientsHere, hodclients is the name of the sample file to be deployed, without the .zip extension or path. When DWunzip is running, it will display status messages, showing the files and folders that were extracted, overwritten, or created. It will also display a message when the command is complete. If you have run this tool once and are running it again on the same .zip file, you will be asked whether you want to overwrite the files. If you do not overwrite the files, the tool will close.
The following procedure loads the Host On-Demand TN5250 emulator.
Open a browser window.
To download the Host On-Demand client, type the URL of the Web server in the browser address bar. For example, if you use the hodclients.zip file, and my.host is the Web server's host name, the URL will be as follows:
http://my.host/hod/hodclients.html
The Host On-Demand client will begin downloading to your personal computer. You should see the Host On-Demand Desktop, which has session icons, a Host On-Demand banner, and a gray background.
Right-click on the 5250 session icon. Click Properties to modify the session properties (such the destination address) for your iSeries or eServer i Telnet server and port. Click OK to exit.
Double-click on the 5250 session icon. A TN5250 Emulator window will appear. You can log onto the host system using the Host On-Demand client and the host telnet server. Refer to the online Help for information on the emulator functions.
To download the latest service updates or fix packs for Host On-Demand, you must register with the IBM Support Portal, at the following address:
https://www-947.ibm.com/support/entry/portal/support
Some of the available information includes the following:
After registering, you need to add the Service Key to your registration. You can then download the product that matches the key you have entered.
You can register multiple keys for the registration ID. The Service Key is the 10-digit number located on the Service Key Card for Host On-Demand Version.
The Service Key provides access to code that contains encryption technologies. Therefore, it must be treated with the same care given to the base product, in terms of Export and Import regulations. You should read and comply with the information on the download authorization Web page. You must agree to the terms before you are allowed to download.
For more information on service updates, see the Host On-Demand Knowledge Center.
To receive Host On-Demand support news flashes, do the following:
The Host On-Demand Knowledge is at the following address:
http://www-01.ibm.com/support/knowledgecenter/SSS9FA/hod_family_welcome.html
The Knowledge Center includes the following:
You can also search across any or all of the HTML documents in the Knowledge Center.
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of LicensingFor license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
Intellectual Property LicensingThe following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:
Site CounselSuch information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.
The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us.
Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
If you are viewing this information softcopy, the photographs and color illustrations may not appear.
The following terms are trademarks of the IBM Corporation in the United States, other countries, or both:
|
CICS
Domino IBM i/OS iSeries Lotus OS/400 WebSphere |
Java, JavaBeans, and all Java-based trademarks and logos are trademarks of Oracle Corporation in the United States, other countries, or both.
Microsoft, Windows, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.
Other company, product, and service names may be trademarks or service marks of others.