Z and I Emulator for Web Entry readme

Z and I Emulator for Web Entry provides a subset of the functions available in Z and I Emulator for Web and is available to those who purchase IBM Communications Servers.

Z and I Emulator for Web Entry is a client only; it does not include any Z and I Emulator for Web server capability.

Prerequisites

Before you can use Z and I Emulator for Web Entry, you must have:

  • A Web server (Z and I Emulator for Web Entry must be installed on the same machine)
  • Supported browsers:
    • Netscape Navigator 4.6, 4.7, 6.0, and 7.0
    • Netscape Navigator (OS/2) 4.61 and IBM Mozilla Web Browser for OS/2
    • Microsoft Internet Explorer 4.01 (with SP1), 5.0, 5.1, 5.5, and 6.0
    • Other browsers that support the JRE 1.3 plug-in

What is included in Z and I Emulator for Web Entry

  • 3270 emulation
  • 5250 emulation
  • VT emulation
  • Cut/copy/paste
  • Keyboard mapping
  • Keypad
  • Print screen
  • Toolbar
  • Trace
  • National language support

NOTE: With Z and I Emulator for Web Entry, you can start a maximum of two sessions at one time.

What is included in full-function Z and I Emulator for Web

The full-function version of Z and I Emulator for Web includes many features not found in the Entry version.

Some of the features found only in the full-function Z and I Emulator for Web are:

  • Host printing
  • Database On-Demand
  • File transfer
  • Macro record/play
  • SSL support
  • User and Group management
  • Host Access Beans for Java
  • Host Access Class Library
  • Unrestricted number of emulator sessions

Full-Function Z and I Emulator for Web

Z and I Emulator for Web is a Java-based, function-rich product that allows you to integrate Web-to-host access through a Web browser. Z and I Emulator for Web is not just an emulator; it is an industrial-strength, client-communication platform that provides secure access to host data, using standard emulation capabilities. It also provides:

  • SQL access to iSeries databases
  • An API that enables the creation of applications with user interfaces that integrate easily into a Web browser

Z and I Emulator for Web is a complete solution that allows Z and I Emulator for Web Server administrators to easily set up the access required by their end users.

To purchase Z and I Emulator for Web, contact your HCL sales representative.

Using Z and I Emulator for Web Entry

To use Z and I Emulator for Web Entry:

  1. Make sure the directory in which you have installed ZIEWeb Entry has been published (made available to Web users). The suggested alias for the path to the published directory is /zie.
  2. Load ZIEWebEntry.html; for example, if the name of your server is myserver, the URL is:
    
    
     http://myserver/zie/ZIEWebEntry.html
    
  3. Select 3270 Display, 5250 Display, or VT Display.
  4. On each tab, change the required information.
  5. Click Start Session to start the session.

Configuring sessions using HTML

You can configure and launch a Z and I Emulator for Web Entry session entirely through the HTML file.

To create an HTML page:

  1. Open HODEntry.html with an ASCII text editor.
  2. Change the <Applet> tag to:
    
    
    <APPLET archive="hodlight.jar" CODE="com.ibm.eNetwork.HOD.SessionLauncher.class" WIDTH=584 HEIGHT=450>
    
  3. Add or change additional parameter values as necessary.
  4. Save your changes and copy the file to the publish directory on your Web server.
  5. Test the page to verify that it works correctly.

If you are configuring a new session in this way, you need to include only the parameters you want to change from the default values.

<Applet> Tag Parameters

Parameter name Description Valid values Default value
SessionName The name you want to assign to this session; it appears at the top of the window Any string None
Host Host name or IP address of the target telnet server Host name or IP address None
WorkstationID Name of this workstation Unique name for this workstation None
SessionType The type of session you want to configure 1 = 3270 2 = 5250 3 = VT 1
SessionID The short name you want to assign to this session; it appears in the OIA. It must be unique to this configuration. One character A
Port The port number on which the target telnet server is listening Any valid TCP/IP port number 23
TNEnhanced Enable TN3270E support true, false true
LUName The name of the LU or LU Pool, defined at the target server, to which you want this session to connect. If you do not specify this, the session connects to the first available LU. The name of an LU or LU Pool None
ScreenSize The number of rows and columns on the screen 2 = 24x80 3 = 32x80 (3270 only) 4 = 43x80 (3270 only) 5 = 27x132 (3270, 5250 only) 6 = 24x132 (VT only) 2
CodePage The code page of the system to which the session will connect A supported host code page 037 (z/OS and iSeries) United States (VT)
AutoConnect The session connects automatically when it starts true, false true
AutoReconnect The session reconnects automatically if the link recovers after failure true, false true
OIAVisible The OIA (operator information area) is visible in the session window true = On false = Off true
Keypad The keypad is visible in the session window true = Show the keypad false = Do not show the keypad false
Toolbar The toolbar is visible in the session window. true = Show the toolbar false = Do not show the toolbar true
ToolbarText Show text that explains the purpose of each toolbar button true = Show the text false = Do not show the text true
VTTerminalType (VT only) The terminal-type required by the server to which the session will connect 1 = VT420_7_BIT 2 = VT420_8_BIT 3 = VT100 4 = VT52 1
VTNewLine (VT only) New-line operation true = CR false = CRLF true
VTBackspace (VT only) Backspace mode true = Delete false = Backspace false
VTLocalEcho (VT only) Local-echo mode true = On false = Off false
VTCursor (VT only) Cursor mode true = Application false = Normal false
VTKeypad (VT only) Keypad mode true = Application false = Normal false
VTAutowrap (VT only) Auto-wrap true = On false = Off false
LightPenMode Light-pen support true = On false = Off false
Embedded Run the session embedded in an HTML page or in a separate window true = Run embedded within the browser page false = Run in a separate window false
NumeralShape (bidirectional only) Numeral Shape NOMINAL, NATIONAL, CONTEXTUAL NOMINAL
TextType (bidirectional only) Text type VISUAL, LOGICAL VISUAL
TextOrientation (bidirectional only) Text Orientation LEFTTORIGHT, RIGHTTOLEFT LEFTTORIGHT
printDestination Choose whether the output should go to a printer or to a file. When true, it goes to printer. true, false true
printerName The name of the port for the printer to be used. Any valid printer names LPT1
printFileName The path and name of the file when the print destination is a file. Any valid path name none
separateFiles When the print destination is a file, choose whether you want to save each print job to a unique file or have jobs appended to each other in one file. true, false false