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

Creating a Customized Version of DataLoader/MX
DataLoader/MX Reference Manual—543544-001
5-24
User Messages—COBOL
User Messages—COBOL
This 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:
DTLFATALERRCOB
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 least on stderr.
After the message has been written, DTLFATALERRCOB calls the TERMINATING
user exit, passing 0 as the argument. Then it closes the error file (the -E file or
stderr). Finally, it stops the process with completion code 3. DTLFATALERRCOB
does not return.
The syntax is:
DTLPROMPTUSERCOB
This procedure writes a message to the process stderr and then accepts input from
the user.
Specify Answersize should be specified as the number of bytes available in Answer.
The MsgLen characters in Msg are the message displayed on the process stderr.
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 );
void DTLFATALERRCOB( char* Msg, short* MsgLen );