next up previous 211
Next: Subroutine Specifications
Up: MERS (MSG and ERR) Message and Error Reporting Systems
Previous: ADAM-special system subroutines


C Interface Function Prototypes

Where T is one of d, i, l, r, and TYPE is the corresponding C type, the function prototypes for the C language interface are:
void errAnnul( int *status );
Annul the contents of the current error context.
void errBegin( int *status );
Begin a new error reporting environment.
void errClear( int *status );
Return the error table to the default context and flush its contents.
void errEnd( int *status );
End the current error reporting environment.
void errFacer( const char *token, int *status );
Assign the message associated with a Starlink status to a token.
void errFioer( const char *token, int iostat );
Assign the message associated with a Fortran I/O error to a token.
void errFlbel( int *status );
Deliver an ASCII BEL and flush the current error context.
void errFlush( int *status );
Flush the current error context.
void errLevel( int *level );
Inquire the current error context level.
void errLoad
( char *param, int param_length, int *parlen, char *opstr, int opstr_length, int *oplen, int *status);
Return error messages from the current error context.
void errMark( void );
Mark (start) a new error context.
void errRep( const char *param, const char *text, int *status );
Report an error message.
void errRlse( void );
Release (end) the current error context.
void errStart( void );
Initialise the Error Reporting System.
void errStat( int *status );
Inquire the last reported error status.
void errStop( int *status );
Close the Error Reporting System.
void errTune( const char *param, int value, int *status );
Set an ERR tuning parameter.
void msgBell( int *status );
Deliver an ASCII BEL character.
void msgBlank( int *status );
Output a blank line.
void msgFmtc( const char *token, const char *format, const char *cvalue );
Assign a CHARACTER value to a message token (formatted).
void msgFmtT( const char *token, const char *format, TYPE value );
Assign a value to a message token (formatted).
void msgIfget( const char *pname, int *status );
Get the MSG filter level from the ADAM parameter system.
void msgIflev( int *filter );
Return the current filter level for conditional message output.
void msgIfset( int filter, int *status );
Set the filter level for conditional message output.
void msgLoad
( const char *param, const char *text, char *opstr, int opstr_length, int *oplen, int *status );
Expand and return a message.
void msgOut( const char *param, const char *text, int *status );
Output a message.
void msgOutif( int prior, const char *param, const char *text, int *status );
Conditionally deliver the text of a message to the user.
void msgRenew( void );
Renew any annulled message tokens in the current context.
void msgSetc( const char *token, const char *cvalue );
Assign a CHARACTER value to a message token (concise).
void msgSetT( const char *token, TYPE value );
Assign a value to a message token (concise).
void msgSync( int *status );
Synchronise message output via the user interface.
void errSyser( const char *token, int systat );
Assign the message associated with an operating system error to a token.
void msgTune( const char *param, int value, int *status );
Set an MSG tuning parameter.



next up previous 211
Next: Subroutine Specifications
Up: MERS (MSG and ERR) Message and Error Reporting Systems
Previous: ADAM-special system subroutines

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