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: 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