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

DISCONNECT PRESENTATION SPACE (2)

Purpose

Drops the connection between your HLLAPI application program and the host Presentation Space (PS).

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

func Specifies the number of the function called; must be 2 for the DISCONNECT PRESENTATION SPACE 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 Indicates the attempt to disconnect was successful.
1 Indicates your program was not connected to the host PS.
9 Indicates a system error occurred.

Remarks

The DISCONNECT PRESENTATION SPACE function drops the connection between your HLLAPI application program and the host PS. Once the DISCONNECT PRESENTATION SPACE function has been called, functions that interact with the host PS, such as the SEND KEY (3), WAIT (4), and RESERVE (11) functions are no longer valid.

The DISCONNECT PRESENTATION SPACE function does not reset the session parameters to the defaults. Your HLLAPI application must call the RESET SYSTEM (21) function to reset the defaults. Your HLLAPI application should disconnect from all connected host PSs before exiting.

Related Information

CONNECT PRESENTATION SPACE (1) function, RESERVE (11) function, RESET SYSTEM (21) function, SEND KEY (3) function and WAIT (4) function.


[ Previous | Next | Contents | Search ]