Z and I Emulator for Web on iSeries: Installation and TN5250 emulation
Note: Before using this information and the product it supports, read the information in Notices. |
First Edition (March 2020 )
This edition applies to Version 1.0 of HCL Z and I Emulator for Web and to all subsequent releases and modifications until otherwise indicated in new editions.
(C) Copyright HCL Technologies Limited 2020. All rights reserved.
The following icons are used in this document:
Points out important notes. | |
Highlights tips. |
Features and benefits of Z and I Emulator for Web
The Web browser-based access of HCL Z and I Emulator for Web gives your users a simple way to reach critical host data. Just click a hyperlink to launch the Z and I Emulator for Web 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 Z and I Emulator for Web is based on Java technology, its interface has the same look and feel across various operating environments.
Z and I Emulator for Web provides access to host applications from a Web browser. The browser downloads the Z and I Emulator for Web Java applet from the Web server and then connects to most standard Telnet servers to access host applications. With Z and I Emulator for Web, 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 Z and I Emulator for Web configuration server.
Using Z and I Emulator for Web 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 Z and I Emulator for Web on many server platforms, accommodating various-size organizations and branch offices.
As software updates occur, the latest version of HCL Z and I Emulator for Web 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.
The HCL Infocenter for Z and I Emulator for Web has more information on these packages:
- Infocenter:
- This document provides information about installing HCL Z and I Emulator for Web Version 1.0 on an
iSeries or eServer i server and using TN5250 emulation. This document is available as a tutorial in the Z and I Emulator for
Web Version 1.0 Infocenter. The HCL Z and I Emulator for Web product has many additional functions that are described in the
Infocenter located on the web at:
https://zieweb.hcldoc.com/help/index.jsp
Installing and Configuring Z and I Emulator for Web for TN5250 Emulation
Here is a high-level overview of steps to install and configure Z and I Emulator for Web for TN5250 emulation.
- Verify access to the OS/400 operating system
- Verify personal computer operating system
- Verifying OS/400 operating system prerequisites
- Installing Z and I Emulator for Web
- Testing the configuration
- Configuring a Z and I Emulator for Web session
- Loading the files to the server and deploying
- Loading the TN5250 client
Details on the steps to install and configure Z and I Emulator for Web on TN5250 emulator.
-
Verify access to the OS/400 operating system
Verify your have access to the iSeries or eServer i, with QSECOFR authority.
-
Verify personal computer operating system
You will also need a personal computer with one of the Microsoft Windows operating Systems.
-
Verifying OS/400 operating system prerequisites
Confirm the operating system level and prerequisites licensed programs are installed on the OS/400 operating system.
Confirm that the server operating system level is supported by the Z and I Emulator for Web level you are installing.Use the dspptf
command on the system to determine the level of operating system installed. Recent cumulative service is recommended. You can use thego 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 Z and I Emulator for Web TSL connections, refer to the Infocenter. Confirm a supported Web Server is installed Verify one of the following HTTP servers is installed:
- IBM HTTP Server for iSeries
- HTTP Server (powered by Apache)
- Lotus Domino for iSeries
Verify that the server operating system has the latest level of fixes for Java.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 Z and I Emulator for Web 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:
Table 2. Java PTF Levels
i/OS PTF V5R1 SF99069 V5R2 SF99169 V5R3 SF99269 -
Installing Z and I Emulator for Web
Use the following procedure to remotely install Z and I Emulator for Web 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.
Z and I Emulator for Web is installed using the IBM installation Manager.Administrators. You must first install IBM Installation Manager on the system where Z and I Emulator for Web will be installed. It must be installed in Administrator Mode. Then install the Z and I Emulator for Web using the Installation Manager.
IBM Installation Manager Version 1.8.3 or higher is required to install Z and I Emulator for Web V1.0.
You need the following check list to ensure before installing Z and I Emulator for Web V1.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.
Click Next Z and I Emulator for Web installation continues.
The initial version of ZIEWeb and above install requires that an empty path be available. Therefore, you need to either rename or delete any existing folders or directories where ZIEWeb was previously installed.
Install Z and I Emulator for Web using the IBM Installation Manager. It is recommended not to click Cancel when an installation is in progress.
Restore the private directory to the Z and I Emulator for Web folders or directories.
Edit any clients created with the Deployment Wizard with the Z and I Emulator for Web Deployment Wizard and deploy to the ZIE server. You can install Z and I Emulator for Web using installation manager on all the supported platforms.
After the Installation Manager is successfully installed, use the following steps to install Z and I Emulator for Web.
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 Z and I Emulator for Web is not listed.
Click Browse and navigate to the location of the extracted Z and I Emulator for Web 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 Z and I Emulator for Web 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 Z and I Emulator for Web 1.0 feature. Click Next.
Review and specify all information under the Z and I Emulator for Web 1.0 tab. For details, refer to the section Installing the Z and I Emulator for Web of Planning, Installing, Configuring Z and I Emulator for Web.
Review the summary information, and click Install.
IBM HTTP Server (powered by Apache)
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 /zieweb and the Host directory to /QHCL/ProdData/zieforweb/zieweb.
Select Edit Configuration File (located in the bottom right). Add the following text lines to the configuration, just before the < line.
< Directory /QHCL/ProdData/zieforweb/zieweb> <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. -
Testing the configuration
Open a browser on a Windows machine and type the following address: http://hostname/zieweb/dashboard.html.If you see the Z and I Emulator for Web HTML page, the HTTP Web server has found the Z and I Emulator for Web publish directory.
-
Configuring a Z and I Emulator for Web session
Z and I Emulator for Web provides a sample HTML file generated by the Z and I Emulator for Web Deployment Wizard. This sample file provides 3270, 5250, VT, and FTP sessions, which include download client and Java auto-detection components.
Locate the ziewebclients.zip file on your Z and I Emulator for Web server in the /< ZIEWeb install directory>/ZIEWeb/samples/html directory.
Copy this zip file to your /< ZIEWeb install directory>/ZIEWeb directory.
If you would like to create your own Z and I Emulator for Web Deployment Wizard files, or use other Z and I Emulator for Web options, see the HCL Infocenter for Z and I Emulator for Web. Reference the information about using Z and I Emulator for Web clients. -
Loading the files to the server and deploying
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: /< ZIEWeb install directory>/lib/samples/DWunzip/ The file is called DWunzip-AS400.sh. To load the ziewebclients.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:
- Location of the JRE
- Location of the Z and I Emulator for Web publish directory on the server
- Target paths specified within the command file
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 Z and I Emulator for Web published directory.
DWunzip-AS400 ziewebclients
-
Loading the TN5250 client
The following procedure loads the Z and I Emulator for Web, TN5250 emulator.
Open a browser window.
To download the Z and I Emulator for Web client, type the URL of the Web server in the browser address bar. For example, if you use the ziewebclients.zip file, and my.host is the Web server's host name, the URL will be as follows:
http://my.host/zieweb/ziewebclients.html
The Z and I Emulator for Web client will begin downloading to your personal computer. You should see the Z and I Emulator for Web Desktop, which has session icons, a Z and I Emulator for Web 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 Z and I Emulator for Web client and the host telnet server. Refer to the online Help for information on the emulator functions.
Infocenter
The HCL Infocenter for Z and I Emulator for Web is at the following address:
https://zieweb.hcldoc.com/help/index.jsp
The Infocenter includes the following:
- Product documentation
- Tutorials
- Troubleshooting
- Links to related product pages
You can also search across any or all of the HTML documents in the Infocenter.
Appendix.Notices
This information was developed for products and services offered in the U.S.A. HCL may not offer the products, services, or features discussed in this document in other countries. Consult your local HCL representative for information on the products and services currently available in your area. Any reference to an HCL product, program, or service is not intended to state or imply that only that HCL product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any HCL intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-HCL product, program, or service.
HCL 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:
HCL 330 Potrero Ave. Sunnyvale, CA 94085 U.S.A. Attention: Office of the General Counsel
HCL TECHNOLOGIES LTD. 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 jurisdictions 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. HCL may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.
Any references in this information to non-HCL documentation or non-HCL Web sites are provided for convenience only and do not in any manner serve as an endorsement of those documents or Web sites. The materials for those documents or Web sites are not part of the materials for this HCL product and use of those documents or Web sites is at your own risk.
HCL may use or distribute any of the information you provide in any way it believes appropriate without incurring any obligation to you.
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:
HCL 330 Potrero Ave. Sunnyvale, CA 94085 U.S.A. Attention: Office of the General Counsel
Such 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 HCL under terms of the HCL Customer Agreement, HCL International Program License Agreement, or any equivalent agreement between us.
Information concerning non-HCL products was obtained from the suppliers of those products, their published announcements or other publicly available sources. HCL has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-HCL products. Questions on the capabilities of non-HCL products should be addressed to the suppliers of those products.
This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to actual people or business enterprises is entirely coincidental.
Trademarks
HCL, the HCL logo, and hcl.com are trademarks or registered trademarks of HCL Technologies Ltd., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM ® or other companies.