next up previous 204
Next: Fortran Subroutine Specifications
Up: EMS Error Message Service
Previous: Fortran Subroutine List


C Interface Function Prototypes

void emsAnnul ( int *status );
Annul the contents of the current error context.
void emsBegin ( int *status );
Begin a new error reporting environment.
void emsEload ( char *parstr, int *parlen, char *opstr, int *oplen, int *status );
Return messages from the current error context.
void emsEnd ( int *status );
End the current error reporting environment.
void emsErrno ( const char *token, int errval );
Assign the message associated with a C errno to a token.
void emsExpnd
( const char *text, char *opstr, const int maxlen, int *oplen, int *status );
Expand and return a message.
void emsFacer ( const char *token, int facerr );
Assign the messages associated with a Starlink status value to a token.
void emsLevel ( int *level );
Inquire the current error context level.
void emsMark ( void );
Start a new error context.
void emsMload
( const char *param, const char *text, char *opstr, int *oplen, int *status );
(Deprecated) Expand and return a message.
void emsRenew ( void );
Renew any annulled message tokens in the current context.
void emsRep ( const char *param, const char *text, int *status );
Report an error message.
void emsRlse ( void );
Release (i.e. end) the current error context.
void emsSetc ( const char *token, const char *cvalue, ... );
Concise encoding of a given null-terminated string. String cvalue must be null-terminated. (For historical reasons, additional arguments are permitted but have no effect.)
void emsSetnc ( const char *token, const char *cvalue, int maxchar );
Concise encoding of a given CHARACTER value - maximum maxchar characters.
void emsSetd ( const char *token, double dvalue );
Concise encoding of a given DOUBLE PRECISION value.
void emsSeti ( const char *token, int ivalue );
Concise encoding of a given INTEGER value.
void emsSetl ( const char *token, int lvalue );
Concise encoding of a given LOGICAL value.
void emsSetr ( const char *token, float fvalue );
Concise encoding of a given REAL value.
void emsStat ( int *status );
Inquire the last reported error status.
void emsSyser ( const char *token, int systat );
Assign an operating system error message to a token.
void emsTune ( const char *key, int value, int *status );
Set an EMS tuning parameter.



next up previous 204
Next: Fortran Subroutine Specifications
Up: EMS Error Message Service
Previous: Fortran Subroutine List

EMS Error Message Service
Starlink System Note 4
P C T Rees
A J Chipperfield
28 September 2001
E-mail:ussc@star.rl.ac.uk

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