|
The Reserve function locks the keyboard that is associated with the host-connected presentation space to block input from the terminal operator.
The reserved host presentation space remains locked until one of the following occurs:
| • | Connect (1) function is executed to a new session. |
| • | Disconnect Presentation Space (2) function is executed. |
| • | Release (12) function is executed. |
| • | Reset System (21) function is executed. |
| • | Start Keystroke Intercept (50) function is executed. |
| • | EHLLAPI application program is terminated. |
Prerequisite Calls
Connect Presentation Space (1)
Call Parameters
|
Standard Interface
|
Enhanced Interface
|
Function Number
|
Must be 11
|
|
Data String
|
NA
|
|
Length
|
NA
|
|
PS Position
|
NA
|
|
Return Parameters
Return Code
|
Explanation
|
0
|
The Reserve function was successful.
|
1
|
Your program is not connected to a host session.
|
5
|
Presentation space cannot be used.
|
9
|
A system error was encountered.
|
Remarks
| 1. | If your EHLLAPI application program is sending a series of transactions to the host, you might need to prevent the user from gaining access to that session until your application processing is complete. |
| 2. | The keyboard input that a user makes while the keyboard is locked by this function is enqueued and processed after the session is terminated. |
| 3. | This function locks both the mouse and the keyboard input. The application program must unlock the presentation space to enable either the mouse or the keyboard input. |
|