6 72 LceUseFunction

LANSA Open Guide

6.72 LceUseFunction

Instructs the session to use the function name specified for transaction stamping.

BOOL

LceUseFunction

(int

iSession,

 

 

 char far *

strValue )

  

Parameters

iSession

The session identifier as returned by LceGetSessionId.

strValue

The function's name. The length of this name should not exceed FUNCTION_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

When a record in a file is changed, LANSA can maintain a "stamped" audit trail.  A number of attributes, including date and time, can be automatically "stamped" in specified fields in the file.

If the field stamping attribute has been set to "FUNC" (i.e. insert function name) in the Repository, the value in strValue will be used when stamping the function. If this function is not used, the default value "LCOE" is inserted.

For more information about LANSA's field stamping attributes, refer to the section: Input Options when Creating a New Field in the LANSA for iSeries User Guide.

  • This function should be executed after the LceGetSessionId and before the LceOpenSession.
  • This function performs no communications to the host.

Related Functions

6.77 LceUseProcess