The success or failure of a function call can be communicated to
Net.Data by the return value of an interface function. How
Net.Data processes the error code depends on the interface function
that is called.
- dtw_initialize()
- A positive or zero return code means that processing continues; a
negative return code means that processing does not continue. If the
return code is not zero and a default message is defined in the
default_error_message field of the dtw_lei_t structure, Net.Data issues
the default message; if no default message is exists, Net.Data
issues an error message.
- dtw_cleanup()
- If the return code is non-zero and a default message is defined in the
default_error_message field of the dtw_lei_t structure, Net.Data issues
the default message; if no default message exists, Net.Data issues
a warning message.
- dtw_execute() and dtw_getNextRow()
- A positive or zero return code means that processing continues; a
negative return code means that processing does not continue. If the
return code is not zero, Net.Data processes the MESSAGE blocks.
If you do not specify a MESSAGE block or do not have an entry in a specified
MESSAGE block to handle the return code, Net.Data displays the contents
of the default_error_message field of the dtw_lei_t structure. This
field can be set by the language environment at any time in the dtw_execute()
or dtw_getNextRow() routines. The setErrorMessage() routine in the
program template (Appendix B, Language Environment Template) shows an example of how to set the default_error_message
field.
[ Top of Page | Previous Page | Next Page | Index ]