About This Book

This book provides necessary programming information for you to use the HCL Z and I Emulator for Windows Emulator High-Level Language Application Program Interface (EHLLAPI), and Z and I Emulator for Windows Session API (PCSAPI), and. The Host Access Class Library is described in Host Access Class Library.

EHLLAPI/PCSAPI is used with Z and I Emulator for Windows to provide a way for users and programmers to access the host presentation space with a set of functions that can be called from an application program running in a workstation session.

In this book, Windows refers to Windows 7, Windows 8/8.1, Windows 10, Windows Server 2008, and Windows Server 2012. When information is relevant only to a specific operating system, this will be indicated in the text.

Who Should Read This Book

This book is intended for programmers who write application programs that use the APIs documented in this book.

A working knowledge of Windows is assumed. For information about Windows, refer to the list of publications under Where To Find More Information.

The programmer must also be familiar with connecting to a host system from a terminal or from a workstation with terminal emulation software.

This book assumes you are familiar with the language and the compiler that you are using. For information on how to write, compile, or link-edit programs, refer to Where To Find More Information for the appropriate references for the specific language you are using.

Where To Find More Information

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

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

Host Access Class Library

The HACL Java HTML files describe how to write an ActiveX/OLE 2.0-compliant application to use Z and I Emulator for Windows as an embedded object. These files can be accessed from the Docs_Admin_Aids zipped folder delivered along with Z and I Emulator for Windows product documentation in the following path : ZIEWin_1.0_Docs_Admin_Aids.zip\publications\en_US\doc\hacl

Following is a list of related publications:


A table at the beginning of each section explains API functions in EHLLAPI Functions, PCSAPI Functions, and WinHLLAPI Extension Functions. It shows whether a function is supported for the products that provide the function described in the section. Yes means it is supported for a host type, and No means not supported. For example, the following table indicates that a function is available for 3270 and VT sessions but not for 5250 sessions.

3270 5250 VT
Yes No Yes