[ Previous | Next | Contents | Search ]
3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference

RESERVE (11)

Purpose

Blocks the currently connected host presentation space (PS) from user input.

Prerequisite Calls

This function requires a prerequisite call to the CONNECT PRESENTATION SPACE (1) function.

Syntax

hllc (func, apistring, len, ret)
int *func;
char *apistring;
int *len;
int *ret;

Supplied Parameters

Supply the following parameters to invoke the RESERVE function:

func Specifies the number of the function called; must be 11 for the RESERVE function.
apistring Does not apply for this function.
len Does not apply for this function.
ret Does not apply for this function.

Returned Parameters

ret The following codes are valid:
0 Specifies that the RESERVE function was successful.
1 Specifies that your program was not connected to the host session.
5 Specifies that the PS was inhibited.
9 Specifies that a system error occurred.

Remarks

The RESERVE function blocks the currently connected host PS from user input. When your HLLAPI program sends a series of transactions to the host, you can use the RESERVE function to prevent the user from gaining access to that session until your program finishes.

The reserved host PS remains blocked until one of the following occurs:

Keyboard input entered by the user while the RESERVE function is in effect is lost.

The RESERVE function blocks out both mouse and keyboard inputs. The application must release the PS before any mouse or keyboard inputs will be accepted.

Related Information

CONNECT PRESENTATION SPACE (1) function, DISCONNECT PRESENTATION SPACE (2) function,RELEASE (12) function and RESET SYSTEM (21) function.


[ Previous | Next | Contents | Search ]