6 77 LceUseProcess

LANSA Open Guide

6.77 LceUseProcess

Instructs the session to use the process name specified in strValue for transaction stamping.

BOOL

LceUseProcess

(int

iSession,

 

 

 char far *

strValue )

  

Parameters

iSession

The session identifier as returned by LceGetSessionId.

strValue

The process name to be inserted with. The length should not exceed PROCESS_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 "PROC" (i.e. insert process name) in the Repository, the value in strValue will be used when stamping the function. If this function is not used, the default value "LANSA" 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 must execute after LceGetSessionId and before LceOpenSession.
  • This function performs no communications to the host.

Related Functions

6.72 LceUseFunction