connectPresentationSpace

Top  Previous  Next

 

The connectPresentationSpace function establishes a connection between your hllapi.js application program and the host presentation space.

 

3270

5250

Yes

Yes

 

Prerequisite Calls

 

There are not prerequisite calls for this function.

 

 

Call Parameters

 

Parameter name

Explanation

psId

1-character short name of the host presentation space.

success

A callback function that takes one parameter (the _jsro object) and is called upon successful connection with the host Presentation Space.

failure

A callback function that takes one 'data' parameter and is called upon a failed connection attempt

disconnect

A callback function that takes one 'data' parameter and is called upon a disconnection event.

 

 

Return Value

 

This function always returns 0.

 

Remarks

 

1.This function is equivalent to HLLAPI Function Number 1.
2.An hllpapi.js web application cannot be connected to multiple presentation spaces concurrently. Calls requiring the connectPresentationSpace function as a prerequisite use the currently connected presentation space. For example, if an application is connected to presentation space A, B, and C in that order, the application must connect to B or A again to issue functions.
3.Each process that requests a connectPresentationSpace must have a corresponding disconnectPresentationSpace.
4.More than one hllapi.js application can share a presentation space, if the applications support sharing (that is, if they were developed to work together and if they exhibit predictable behavior).