Integration Guide

Table Of Contents

Customizing the PSS System Software

______________________________________________________________________________

WaveWorks PSS, Integration Guide, 1.10 Page 108

9.5 Available User Exit Functions

Following is a complete list of the User Exit routines as called by the standard PSS Software,

along with a brief description of the intended purpose of the User Exit routine and a description

of how the base PSS software reacts to the return code received from the User Exit. For the most

recent information on functionality and more details about specific arguments passed to the User

Exit routines, review the header file PssUserExits.h.

9.5.1 UE_PreProcessItemFile

This function is called before processing of Item Record File is performed. It receives the file

path of the item file as an argument.

The base PSS software handles the following return codes from the User Exit as follows:

UE_CONTINUE: PSS processes the item record file as if no Pre-Processing was performed

UE_DONE: PSS performs no Item record file processing

UE_ERROR: PSS logs an error then proceeds as with UE_DONE

9.5.2 UE_PreProcessItemRecord

This function is called after an item record is read from the file, but before PSS performs any

processing of the record. It is anticipated that this UE function will be used to either replace all

PSS Item record processing or to alter the input buffer that PSS processes.

The base PSS software handles the following return codes from the User Exit as follows:

UE_CONTINUE: PSS processes the item record as if no Pre-Processing was performed, validating the

item record and loading it into the PSS database.

UE_DONE: PSS performs no record processing and proceeds to read the next record

UE_ERROR: PSS logs an error then proceeds as with UE_DONE

Note: If a UE_DONE is returned, the POS_Item_Flag field of the record in table PSS_Item

must have been updated to "Y" or the record for that item will be deleted from the database by

PSS end of file processing.