6 69 LceUseExceptionalArguments

LANSA Open Guide

6.69 LceUseExceptionalArguments

Instructs the session to use the exceptional arguments when opening a session. This function is optional and is only valid when used against LANSA hosts which support X_RUN exceptional arguments.

BOOL

 

(int 

iSession,

 

 

 char far *

strValue )

  

Parameters

iSession

The session identifier as returned by LceGetSessionId.

strValue

The list of exceptional arguments. The length of this parameter should not exceed EXCEPTIONAL_ARGS_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

Not all arguments are allowed in this argument list. Some arguments are set by calls to other LANSA Open functions (For example, the partition is set by calling LceUsePartition) and others are not allowed due to the context in which the LANSA request processor runs.

The following X_RUN arguments are supported in this function:

DBID=, DBII=, DBIT=, DBUS=, DBUT=, FXQF=, FXQM=, HSKC=, INIT=, ITHP=, ITRC=, ITRL=, ITRM=, ITRO=, ODBI=, PPTH=, PRTR=, PSWD=, RPTH=, TERM=, TPTH=, WPDF=, WPDS=, WPEN=, WPFD=, WPFO=, WPPD=.

Arguments not supported will be ignored by the host.

Names assigned to DBID and DBII must be enclosed in double quotes (") if the name contains spaces. For example (in C):

LceUseExceptionalArguments( iSession, "DBID=\"LX Trunk\" DBUS=DBA PSWD=SQL" );

  

Related Functions

6.13 LceEndSession

6.46 LceOpenSession

6.72 LceUseFunction

6.73 LceUseLanguage

6.74 LceUsePartition

6.75 LceUsePassword

6.76 LceUsePriority

6.77 LceUseProcess

6.78 LceUseSystem

6.80 LceUseUserId