About This Book

HCL Z and I Emulator for Windows reference books are comprised of this Administrator's Guide and Reference and an Emulator User's Reference. These volumes provide information for using HCL Z and I Emulator for Windows operating systems (hereafter called PC400).

  1. PC/3270 refers to the 3270 portion of the combined package.
  2. Workstation refers to all supported personal computers.
  3. Windows refers to Windows 8, Windows 8.1, Windows 10, Windows 10 x64 and Windows Server 2008. When information is applies only to a specific operating systems, this is indicated in the text.

Who Should Read This Book

This book is intended for administrators of Z and I Emulator for Windows.

How to Use This Book

This book contains reference information that you might need to refer to when installing or operating Z and I Emulator for Windows.

Z and I Emulator for Windows is designed to use various communication adapters and to work with other workstation and host system software. Refer to the appropriate documentation for the products you use.

Command Syntax Symbols

Parentheses, brackets, ellipses, and slashes have the following meanings or uses:

( )
Parentheses enclose operands that govern the action of certain command options.
[ ]
Brackets indicate an optional command argument. If you do not use the optional item, the program selects a default.
Ellipsis after an argument indicates that you can repeat the preceding item any number of times.
For 3270, a slash must precede the Time Sharing Option Extensions (TSO/E) password. A slash must also precede parameters of DOS commands entered from the command line. For 5250, a slash must precede parameters of IBM® DOS commands entered from the command line.
A backslash is included as part of any directory name. An initial backslash indicates the first-level directory, and an additional backslash is inserted in the directory name to indicate another level.

All directives, operands, and other syntax can be typed in either uppercase or lowercase, unless otherwise indicated.

Where to Find More Information

The following sections discuss getting help when you are installing, configuring, or using Z and I Emulator for Windows.

Information Center

You can find documentation and links to other resources at the Z and I Emulator for Windows Information Center, at the following address:


The Z and I Emulator for Windows Information Center provides information in English.

Online Help

The help facility describes how to install, configure, and use Z and I Emulator for Windows. Online help is very extensive and includes information about every aspect of configuring and using Z and I Emulator for Windows.

Use help to obtain the following information:

To display online help, select choices from the Help menu or press F1.

You can use Z and I Emulator for Windows online help just as you use the online help for Windows.

Messages and Alerts

Online messages are displayed by Z and I Emulator for Windows, but a message does not always mean an error occurred. For example, a message might tell you that an operation is in progress or has been completed. A message can also prompt you to wait for the completion of an operation.

Messages That Appear in Pop-Up Windows

While using Z and I Emulator for Windows, you may see messages appear in popup windows, but not necessarily as a direct result of your actions. These messages can appear for a number of reasons, outlined in the following sections.

System-Fault Messages

If a message does appear in a pop-up window, you can paste its contents into the Windows clipboard. To do this:

  1. Click Details on the pop-up window.
  2. Mark the text that you want to copy.
  3. Click the marked text with the right mouse button and then click Copy.
  4. Start an editor, such as Notepad, and click Paste from the Edit menu.
  5. Save the file in case an IBM Service Representative needs this information to diagnose your problem.
Security-Related Messages

Z and I Emulator for Windows optionally utilizes Secure Sockets Layer (SSL) or Transport Layer Security (TLS) to establish sessions with servers; this may require input from you (for example, a password). See Configuring and Using Security for Z and I Emulator for Windows for details.

System-Policy-Related Messages

Your Z and I Emulator for Windows workstation configuration can be controlled centrally using facilities for managing system policies. See System Policy Support for details.

OIA Messages

Z and I Emulator for Windows displays messages in the operator information area (OIA) or in a pop-up window. Messages from Z and I Emulator for Windows are displayed in the message window; messages from the host system regarding the condition of the session are displayed in the OIA of the session window.

The OIA is the bottom line of the session window. An OIA message indicates the status of Z and I Emulator for Windows as well as information about the workstation, host system, and attachment method.

All of the OIA indicators, reminders, and messages are described in the online help. To view this information:

  1. Click Index from the Help menu.
  2. Select The operator information area messages.

    To look up a specific OIA message, select Search. When the Search window appears, type the letters that appear in the OIA. For example, MACH or PROG. If a lightning bolt appears, type COMM.

  3. Double-click the index entry that matches your search.
  4. Scroll through the window until you find the number that appears in your OIA.


Alerts may be generated which correspond to specific Z and I Emulator for Windows messages. See Appendix B. Alerts for more information.

Z and I Emulator for Windows Library

The Z and I Emulator for Windows library includes the following publications:

In addition to the printed books, there are HTML documents provided with Z and I Emulator for Windows:

Host Access Class Library for Java
This HTML document describes how to write an ActiveX/OLE 2.0-compliant application to use Z and I Emulator for Windows as an embedded object.

General Information