Reserve (11)

Reserve (11)

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.

3270	5250
Yes	Yes

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

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.

The keyboard input that a user makes while the keyboard is locked by this function is enqueued and processed after the session is terminated.

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.