View Source

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