DataLoader/MX Reference Manual (G06.24+)

Creating a Customized Version of DataLoader/MX
DataLoader/MX Reference Manual—525872-002
5-23
User Messages—COBOL
The syntax is:
If this is the first message written to the error file, a message is written to stderr (and
to stdout if it is different from stderr) to indicate that errors are occurring. If the -Q
argument is specified, the write to stderr is skipped, and if stdout is the same as
stderr, the message is not written.
This procedure does not increment the error count.
DTLWriteToUser
This procedure writes the message to stderr and to stdout (unless stdout is the
same as stderr).
The syntax is:
If the -Q parameter is specified, the write to stderr is skipped, and if stdout is the
same as stderr, the message is not written.
This procedure does not increment the error count.
User Messages—COBOL
The following procedures can be used to communicate with the user.
DTLCONTINUECOB
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:
void DTLWriteToErr( char* Format, ... );
void DTLWriteToUser( char* Format, ... );
Note. There are two versions of each User Messages routine: one is designed for use with C,
and the other is designed for use with COBOL. Two versions exist because, although it is
common practice for C routines that print messages to accept a variable parameter list,
COBOL cannot call routines that have variable parameter lists. Therefore, for each C User
Message routine, a corresponding one exists for use by COBOL. Its name is the same as the
name of the C routine except that it is all uppercase, has the letters COB appended, and its
parameters are the message and the length of the message. The calling COBOL program
must format the message.
short DTLCONTINUECOB(char* Question, short* QuestionLen );