6 78 LceUseSystem

LANSA Open Guide

6.78 LceUseSystem

Instructs the session which host system to use. This function is not necessary if you only have one host system.

BOOL

LceUseSystem

(int

ISession,

 

 

 char far *

strValue )

  

Parameters

iSession

The session identifier as returned by LceGetSessionId.

strValue

The host system name. The length should not exceed SYSTEM_LENGTH as defined in the LCOE.H header file.

  

Return Values

TRUE is returned if the session can accept the value.

FALSE is returned if an error occurs.

Notes

If you are using any Windows version of LANSA Open with Client Access/400, this function is optional. The default host system will be the one used when the communications to the host was started.

Refer to Configuration File for more details.

  • This function must be executed after the LceGetSessionId and before the LceOpenSession. The host cannot be changed once the session is open.
  • This function performs no communications to the host.

Related Functions

6.74 LceUsePartition

6.80 LceUseUserId

6.75 LceUsePassword