Contents

Figures
Tables
About This Book
Who Should Read This Book
Where To Find More Information
Notation
Introduction to Emulator APIs
Using API Header Files
Critical Sections
Stack Size
Windows x64 Platform Support
Sample Programs
Introduction to IBM Standard EHLLAPI, IBM Enhanced EHLLAPI and WinHLLAPI Programming
EHLLAPI Overviews
IBM Standard EHLLAPI
WinHLLAPI
WinHLLAPI and IBM Standard EHLLAPI
IBM Enhanced EHLLAPI and IBM Standard EHLLAPI
Languages
EHLLAPI Call Format
Data Structures
Memory Allocation
EHLLAPI Return Codes
Compiling and Linking
Static Link Method
Dynamic Link Method
Multithreading
Presentation Spaces
IBM Enhanced 32-Bit Interface Presentation Space IDs
Types of Presentation Spaces
Size of Presentation Spaces
Presentation Space IDs
Host-Connected Presentation Space
Presentation Space ID Handling
Sharing EHLLAPI Presentation Space between Processes
Using mouse actions to select, copy, and paste text in the Presentation Space
ASCII Mnemonics
Debugging
A Simple EHLLAPI Sample Program
Standard and Enhanced Interface Considerations
Host Automation Scenarios
EHLLAPI Functions
Page Layout Conventions
Prerequisite Calls
Call Parameters
Return Parameters
Notes on Using This Function
Summary of EHLLAPI Functions
Allocate Communications Buffer (123)
Cancel File Transfer (92)
Change PS Window Name (106)
Change Switch List LT Name (105)
Connect for Structured Fields (120)
Connect Presentation Space (1)
Connect Window Services (101)
Convert Position or Convert RowCol (99)
Copy Field to String (34)
Copy OIA (13)
Copy Presentation Space (5)
Copy Presentation Space to String (8)
Copy String to Field (33)
Copy String to Presentation Space (15)
Copy Presentation Space to Clipboard (35)
Paste Clipboard to Presentation Space (36)
Disconnect from Structured Fields (121)
Disconnect Presentation Space (2)
Disconnect Window Service (102)
EditKey Intercept
Find Field Length (32)
Find Field Position (31)
Free Communications Buffer (124)
Get Key (51)
Get Request Completion (125)
Lock Presentation Space API (60)
Lock Window Services API (61)
Pause (18)
Post Intercept Status (52)
Query Additional Field Attribute (45)
Query Close Intercept (42)
Query Communications Buffer Size (122)
Query Communication Event (81)
Query Cursor Location (7)
Query Field Attribute (14)
Query Host Update (24)
Query Session Status (22)
Query Sessions (10)
Query System (20)
Query Window Coordinates (103)
Read Structured Fields (126)
Receive File (91)
Release (12)
Reserve (11)
Reset System (21)
Search Field (30)
Search Presentation Space (6)
Send File (90)
Send Key (3)
Set Cursor (40)
Set Session Parameters (9)
Start Close Intercept (41)
Start Communication Notification (80)
Start Host Notification (23)
Start Keystroke Intercept (50)
Start Playing Macro (110)
Stop Close Intercept (43)
Stop Communication Notification (82)
Stop Host Notification (25)
Stop Keystroke Intercept (53)
Wait (4)
Window Status (104)
Write Structured Fields (127)
WinHLLAPI Extension Functions
Summary of WinHLLAPI Functions
WinHLLAPI Asynchronous Functions
WinHLLAPIAsync
WinHLLAPICancelAsyncRequest
Initialization and Termination Functions
WinHLLAPI Startup
WinHLLAPI Cleanup
Blocking Routines
WinHLLAPIIsBlocking
WinHLLAPISetBlockingHook
WinHLLAPIUnhookBlockingHook
WinHLLAPICancelBlockingCall
PCSAPI Functions
How to Use PCSAPI
Page Layout Conventions
Function Type
Parameter Type and Description
Return Code
pcsConnectSession
Function Type
Parameter Type and Description
Return Code
pcsDisconnectSession
Function Type
Parameter Type and Description
Return Code
pcsQueryConnectionInfo
Function Type
Parameter Type and Description
Return Code
ConnectionInfo
Example
pcsQueryEmulatorStatus
Function Type
Parameter Type and Description
Return Code
pcsQuerySessionList
Function Type
Parameter Type and Description
Return Parameters
Example
pcsQueryWorkstationProfile
Function Type
Parameter Type and Description
Return Code
pcsSetLinkTimeout
Function Prototype
Parameter Type and Description
Return Code
pcsStartSession
Function Type
Parameter Type and Description
Return Code
pcsStopSession
Function Type
Parameter Type and Description
Return Code
Page Setup Functions
Restrictions
pcsGetPageSettings
pcsRestorePageDefaults
pcsSetPageSettings
Printer Setup Functions
Restrictions
pcsGetPrinterSettings
pcsSetPrinterSettings
Troubleshooting for Emulator programming
Partial EHLLAPI input on Z and I Emulator for Windows host screen
HCL Z and I Emulator for Windows VBHLLAPI sample does not run in FDCC Windows Vista
Appendix A. Query Reply Data Structures Supported by EHLLAPI
The DDM Query Reply
DDM Application Name Self-Defining Parameter
PCLK Protocol Controls Self-Defining Parameter
Base DDM Query Reply Formats
The IBM Auxiliary Device Query Reply
Optional Parameters
Direct Access Self-Defining Parameter
PCLK Protocol Controls Self-Defining Parameter
The Product-Defined Query Reply
Optional Parameters
Direct Access Self-Defining Parameter
The Document Interchange Architecture Query Reply
Appendix B. Differences from Communication Manager/2 EHLLAPI
Set Session Parameter (9)
Set Options
Return Parameters
EAB Option
Copy OIA (13)
Copy String to PS (15)
Storage Manager (17)
Copy String to Field (33)
Get Key (51)
Window Status (104)
Query Sessions (10)
Connect for Structured Fields (120)
Allocate Communications Buffer (123)
ASCII Mnemonics
Get Request Completion (125)
Appendix C. Notices
Trademarks
Index