next up previous 211
Next: ERR_RLSE - Release (end) the current error context
Up: Subroutine Specifications
Previous: ERR_MARK - Mark (start) a new error context


ERR_REP - Report an error message

Description:
Report an error message. According to the error context, the error message is either sent to the user or retained in the error table. The latter case allows the application to take further action before deciding if the user should receive the message. On exit the values associated with any existing message tokens are left undefined. On successful completion, STATUS is returned unchanged.

If STATUS is set to SAI__OK on entry, an error report to this effect is made on behalf of the application and STATUS is returned set to ERR__BADOK; the given message is still reported and has status ERR__UNSET associated with it.

If an output error occurs, STATUS is returned set to ERR__OPTER.


Invocation:
CALL ERR_REP( PARAM, TEXT, STATUS )

Arguments:

PARAM = CHARACTER * ( * ) (Given)
The error message name.
TEXT = CHARACTER * ( * ) (Given)
The error message text.
STATUS = INTEGER (Given and Returned)
The global status: it is left unchanged on successful completion, or is set an appropriate error value if an internal error has occurred.



next up previous 211
Next: ERR_RLSE - Release (end) the current error context
Up: Subroutine Specifications
Previous: ERR_MARK - Mark (start) a new error context

MERS (MSG and ERR) Message and Error Reporting Systems
Starlink User Note 104
P C T Rees
A J Chipperfield
22 October 2001
E-mail:ussc@star.rl.ac.uk

Copyright © 2001 Council for the Central Laboratory of the Research Councils