G 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.

int emsGtune ( const char *key, int *status );

Get the value of a tuning parameter

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.

int emsStune ( const char *key, int value, int *status );

Set an EMS tuning parameter, returning previous value.

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 );

(Deprecated use emsStune) Set an EMS tuning parameter.