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 .
- This function should be executed after the LceGetSessionId and before the LceOpenSession.
- This function performs no communications to the host.
Related Functions