Dataloader/MP Reference Manual

Creating a Customized Version of DataLoader/MP
DataLoader/MP Reference Manual—424148-003
5-12
T7900D41_DEFAULTEXITS_C
T7900D41_DEFAULTEXITS_C
T7900V00-DEFAULTEXITS-COBOL
This exit is present only in the nonnative mode version of DataLoader/MP.
This exit is not an exit in the normal sense in that it is never called, and, if by mistake it
is called, it does nothing. Its purpose is to assist in determining what user exits are
bound into a given DataLoader/MP object file.
When run, DataLoader/MP uses the EXITSDESCRIPTION user exit to print a
description of the user exits. However, there are times when you need to know the
version of the user exits without running the program. If you change the
_DEFAULTEXITS_C in the name of this procedure to match the text returned by your
EXITSDESCRIPTION user exit, VPROC can be used to see which version of your user
exits are in a particular DataLoader/MP object file. If you customize it, do not change
the first nine characters of the procedure name.
If you use COBOL to write your user exits, this procedure is T7900U00-
DEFAULTEXITS-COBOL.
The syntax for this procedure follows:
UPDATEIT
The UPDATEIT exit is called when you explicitly request it by specifying the letters u,
U, h, or H in the list of user exits called through the -X parameter. Its function is to
attempt to update a row in the database.
The syntax for this procedure follows:
If the update is successful, it should return a positive value in Status. If the update is
not successful, it should return a negative value. If the record should not be processed
any more by DataLoader/MP, UPDATEIT should return a zero (0) value.
To make it easy to collect statistics on row deletions, a utility procedure named
DTLUpdatedResult is provided and should be called immediately after the execution of
the embedded SQL update. This utility procedure does a number of things:
•
Checking SQLCODE
•
Checking the SQLCA
•
Updating DataLoader/MP’s internal statistics
•
Returning a value appropriate for the Status return from UPDATEIT.
void T7900U00_DEFAULTEXITS_C( void )
void UPDATEIT( char*Rec, long* RecLen, short* Status )