This function can be used to register an external function to be used to deliver an error message and (optionally) an accompanying status value to the user.

If this function is not called prior to the first error occuring within AST, then the external error handling function selected at link-time (using the ast_link command) will be used. To use an alternative error handler, call this function before using any other AST functions, specifying the external error handling function to be used. This will register the function for future use.

void astSetPutErr( void ($\ast$fun)(int,const char$\ast$) )

fun

The supplied external function should deliver the supplied error message and (optionally) the supplied status value to the user or to some underlying error system. It requires the following interface:

void PutErr( int status_value, const char $\ast$message )

• status_value - The error status value.

• message - Pointer to a null-terminated character string containing the error message to be delivered.