Communicating Error Conditions

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 ]