View Source

Opens a communications session with the host.

BOOL

LceOpenSession

(int

iSession)

Parameters

iSession	The session identifier returned by LceGetSessionId.

Return Values

TRUE is returned if the session can be opened.

FALSE is returned if an error occurs.

Notes

LceOpenSession is used in conjunction with a number of LANSA Open "session definition" functions that set the session's options.

The time taken to open a session will depend upon many factors including the client and host system's hardware and software.

The more fields and files used, the longer the time it will take to open the session. A theoretical maximum of 256 files and 2800 fields may be used in a session.
This function must be executed after an LceGetSessionId function.

Tip:

For consecutive file processing, set the fResume parameter to TRUE when calling LceEndSession. This keeps the communications session with the host system active. You can then use the same session identifier (for processing the other files) in LceOpenSession.

You can also have more than one session open (via LceOpenSession) if you need to access more than one file concurrently when using the *RECEIVEIMMED option for selecting records.

Related Functions

6.39 LceGetSessionId

6.13 LceEndSession

6.69 LceUseExceptionalArguments