Appendix B. Differences from Communication Manager/2 EHLLAPI

This appendix describes the differences between EHLLAPI of Z and I Emulator for Windows and EHLLAPI for Communication Manager/2.

The following EHLLAPI functions are different from those with the same names in Communication Manager/2. You need to understand the differences when you use these functions:

Set Session Parameter (9)

Set Options

Z and I Emulator for Windows does not provide the following set options provided by Communication Manager:

Return Parameters

When the Set Session Parameter (9) function is terminated, Communication Manager returns a length of the valid data string as the third parameter, the data string length. However, Z and I Emulator for Windows returns a number of the valid set options as the data string length.

EAB Option

In Communication Manager/2, a color remap affects the value of the character color in the EAB attribute copied by Copy PS (5) or Copy PS to String (8) function when the EAB option is specified in the Set Session Parameter (9) function.

In Z and I Emulator for Windows, however, the value of the character color in the EAB attribute depends on the contents of the presentation space regardless of a color remap, and it is not affected by a color remap.

Copy OIA (13)

The Copy OIA (13) function has the following differences between Communication Manager/2 and Z and I Emulator for Windows. For more information of the group and the column positions, refer to Copy OIA (13).

Copy String to PS (15)

In Communication Manager/2, the EAB option of the Set Session Parameter (9) function affects the Copy String to PS function. When you specify the EAB option, pass the attribute data that has the same size as the text data to the function with the text data.

In Z and I Emulator for Windows, however, the data to be passed is only text data regardless of EAB option. If you want to use the same interface with Communication Manager/2, use the PUTEAB option of Set Session Parameter (9).

Storage Manager (17)

Storage Manager (17) function provided by Communication Manager/2 is not supported by Z and I Emulator for Windows. Use the APIs provided by Windows to allocate the memory for the applications.

Copy String to Field (33)

In Communication Manager/2, when the EAB option of the Set Session Parameter (9) function is specified, the attribute data is passed to the function as a part of the data. Therefore, when you specify the EAB option, pass the attribute data that has the same size as the text data to the function with the text data.

In Z and I Emulator for Windows, however, the EAB option does not affect the data contents of the Copy String to Field (33) function. The data to be passed is not the attribute data, but only the text data. If you want to use the same interface with Communication Manager/2, use the PUTEAB option of Set Session Parameter (9).

Get Key (51)

Communication Manager/2 returns shift state using @A, @S, or @r, if the shift state of a passed key is not a key or function recognized by the emulator session. Z and I Emulator for Windows does not support these ASCII mnemonics.

Window Status (104)

EHLLAPI function 104 (PM_WINDOW_STATUS) ‘query extended status’ command (0x03) will return the handle of the emulator presentation space window. This is consistent with the definition of the function and the Communication Manager/2 implementation. However, Z and I Emulator for Windows EHLLAPI returns the handle of the frame window. EHLLAPI applications written for Z and I Emulator for Windows using this function need to use the parent of the window handle returned.

Query Sessions (10)

In Communication Manager/2, the descriptor for personal computer is returned. However, the descriptor is not returned in Z and I Emulator for Windows.

Connect for Structured Fields (120)

The event object for communication connection status provided by Communication Manager/2 is not in Z and I Emulator for Windows.

Allocate Communications Buffer (123)

In Communication Manager/2, the maximum value of the requested buffer size is 64 KB minus 8 bytes (X'FFF8').

In Z and I Emulator for Windows, however, it is 64 KB minus 256 bytes (X'FF00').

ASCII Mnemonics

The following ASCII mnemonics are not supported in Z and I Emulator for Windows:

Mnemonics Meaning
@A@N Get Cursor
@A@O Locate Cursor
@A@X Hexadecimal
@A@Y Cmd (Function) Key
@A@a Destructive Backspace
@S@A Erase EOL
@S@B Field Advance
@S@C Field Backspace
@S@D Valid Character Backspace
@S@P POR (For sending only)
@S@T Jump to Task Manager
@/ Overrun of queue (Only in the Get Key function)

Get Request Completion (125)

Z and I Emulator for Windows does not support a blank or null session ID.