Establishes a connection between a HLLAPI application program and a specified host Presentation Space (PS).
This function requires no prerequisite calls to other functions.
hllc (func, apistring, len, ret) int *func; char *apistring; int *len; int *ret;
Supply the following parameters to invoke the CONNECT PRESENTATION SPACE function:
|func||Specifies the number of the function called; must be 1 for the CONNECT PRESENTATION SPACE function.|
|apistring||Specifies the address of the parameters of the calling function; must be the one-character short session ID of the host PS.|
|len||Specifies the address of the length of the parameter of the calling function; does not apply to the CONNECT PRESENTATION SPACE function (1 is implied).|
|ret||Specifies the address of the returned value of the calling function; does not apply to the CONNECT PRESENTATION SPACE function.|
The CONNECT PRESENTATION SPACE function sets the return code to indicate the status of the attempt and, if successful, the status of the host PS.
|ret|| Specifies the address of the returned value of the calling function; does not apply to the CONNECT PRESENTATION SPACE function. The following return codes are valid:
When establishing a connection between your HLLAPI application and a specific host PS, remember that the HLLAPI application can connect to multiple PSs, but not concurrently. The connections must be sequential, and the application cannot go back and forth between connections without reconnecting. Calls requiring the CONNECT PRESENTATION SPACE function as a prerequisite use the currently connected PS. For example, if an application connects to PSs A, B, and C in that order, the application must connect to B or A again in order to issue functions against that PS. PSs not connected to this application are available for use by other HLLAPI applications.
Note: The maximum number of connected sessions per program is 10. A user can connect and disconnect several sessions as long as the maximum connects never exceeds 10.
A user connecting to an HCON session must be a valid HCON user with configured sessions. Connection to other users is not allowed.
The RESET SYSTEM (21) function causes the HLLAPI application to disconnect from its Presentation Space.
DISCONNECT PRESENTATION SPACE (2) or RESET SYSTEM (21) function.