6.46 LceOpenSession

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.

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

6.71 LceUseFile

6.72 LceUseFunction

6.73 LceUseLanguage

6.74 LceUsePartition

6.75 LceUsePassword

6.76 LceUsePriority

6.77 LceUseProcess

6.78 LceUseSystem

6.79 LceUseTmpDrive2