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