Next: Fortran Subroutine List
Up: EMS Error Message Service
Previous: Operating system specific routines
Include Files
The symbolic constants defined by the three include files used with EMS are
listed below. The way in which these files are included within Fortran or
C code is described in Section
.
- SAE_PAR (sae_par.h) Defines the non-specific status
codes for Starlink.
- SAI__ERROR - Error encountered.
- SAI__OK - No error.
- SAI__WARN - Warning.
- EMS_PAR (ems_par.h) Defines the Error Message Service
constants.
- EMS__BASE - The base context number.
- EMS__MXMSG - Maximum number of messages.
- EMS__MXOUT - Maximum length of output text.
- EMS__SZMSG - Maximum length of error message text.
- EMS__SZPAR - Maximum length of error message name.
- EMS__SZTOK - Maximum length of message token text.
- EMS__TOKEC - Message token escape character.
- EMS_ERR (ems_err.h) Defines the Error Message Service
error codes.
- EMS__BADOK - Status set to SAI__OK in call to
EMS_REP
(improper use of EMS_REP).
- EMS__BDKEY - Invalid keyword will be ignored (improper use
of EMS_TUNE).
- EMS__BTUNE - Conflicting actions (improper use of
EMS_TUNE).
- EMS__CXOVF - Error context stack overflow (EMS fault).
- EMS__EROVF - Error message stack overflow (EMS fault).
- EMS__NOENV - Error encountered reading environment variable
EMS_TUNE.
- EMS__NOMSG - No error messages pending output.
- EMS__NSTER - Error in nested calls to EMS_BEGIN
and EMS_END
(improper use of EMS).
- EMS__OPTER - Error encountered during message output.
- EMS__UNSET - No status associated with message (improper
use of EMS_REP).
Notes:
- 1.
- EMS__BADOK is the status returned if EMS_REP is called with
status SAI__OK whereas EMS__UNSET is the status associated with any
messages reported in this way and may therefore be returned by, for example,
EMS_STAT.
- 2.
- EMS__NOENV is provided for future developments - it is not used at
the moment.
Next: Fortran Subroutine List
Up: EMS Error Message Service
Previous: Operating system specific routines
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