DataLoader/MX Reference Manual (H06.03+, J06.03+)

Creating a Customized Version of DataLoader/MX
DataLoader/MX Reference Manual—543544-001
5-21
User Messages—C
There are no error returns. Errors are handled by DataLoader/MX.
DTLWrite
This procedure writes up to Len bytes from the buffer pointed to by Buf to the file
FileNum.
The syntax is:
If FileNum is -2, the data is written to the file specified in the -O= parameter.
The value returned by this procedure is the actual number of bytes written. This value
is usually the number of bytes requested to be written, but can be smaller, if writing to a
file whose record length is smaller than Len, or greater, if the file is an unstructured file
without the ODDUNST attribute and Len is odd.
If the KEYRANGE interpretation is used for output, the DTLWrite utility always calls the
BUILDKEY exit.
There are no error returns. Errors are handled by DataLoader/MX.
User Messages—C
Use these procedures to communicate with the user. In all cases, the message to be
written is specified by using the standard C print format, as indicated by
(char* Format, ... ).
DTLContinue
This procedure writes the message to the process stderr and then displays a prompt
asking if the user would like to continue. If the user indicates yes, the return value of
this procedure is nonzero. If the user indicates no, the return value of the procedure is
0 (zero).
The syntax is:
DTLFatalErr
This procedure writes the message to stderr and to stdout (unless stdout is the
same as stderr). It ignores -Q so that the message appears, at a minimum, on
stderr. After the message is written, DTLFatalErr calls the TERMINATING user exit,
long DTLWrite( short FileNum, char* Buf, long Len );
short DTLContinue( char* Format, ... );