Next: Abstract

EMS
Error Message Service
Version 2.2-0
Programmer's Manual

Starlink User Note 4.14
P.C.T. Rees
A.J. Chipperfield
P.W. Draper
31 Jul 2008

CCLRC / Rutherford Appleton Laboratory
Particle Physics & Astronomy Research Council

Starlink Project

Retrieve hardcopy

Abstract
Introduction
When to Use the Error Message Service
Reporting Errors
Message Tokens
Reporting Status, Fortran I/O and Operating System Errors
Message Output
- No EMS_FLUSH
- EMS without an environment
- EMS within an environment
Intercepting Messages
C Language Interface
Compiling and Linking with the Error Message Service
References
Justification for EMS
Using EMS together with POSIX threads
Using EMS within ADAM system software
- Overview
- Message parameters
- Parameter references
- Reserved tokens
- Synchronising message output
- Routines specific to the ADAM fixed part
- ERR_CLEAR - Return the error table to the default context and flush its contents
- ERR_START - Initialise the Error Reporting System
- ERR_STOP - Close the Error Reporting System
Portability
- Porting prerequisites
- Operating system specific routines
Include Files
Fortran Subroutine List
C Interface Function Prototypes
Fortran Subroutine Specifications
- EMS_ANNUL - Annul the contents of the current error context
- EMS_BEGIN - Begin a new error reporting environment
- EMS_ELOAD - Return error messages from the current error context
- EMS_END - End the current error reporting environment
- EMS_EXPND - Expand and return a message
- EMS_FACER - Assign the message associated with a Starlink status value to a token
- EMS_FIOER - Assign a Fortran I/O error message to a token
- EMS_GTUNE - Inquire an EMS tuning parameter
- EMS_LEVEL - Inquire the current error context level
- EMS_MARK - Start a new error context
- EMS_MLOAD - (Deprecated) Expand and return a message
- EMS_RENEW - Renew any annulled message tokens in the current context
- EMS_REP - Report an error message
- EMS_RLSE - Release (end) an error context
- EMS_SETx - Assign a value to a message token (concise)
- EMS_STAT - Inquire the last reported error status
- EMS_SYSER - Assign an operating system error message to a token
- EMS_TUNE - Set an EMS tuning parameter
About this document ...

Next: Abstract

EMS [1ex
Starlink System Note 4
P.C.T. Rees
A.J. Chipperfield
P.W. Draper
31 Jul 2008
E-mail:ussc@star.rl.ac.uk

Copyright © 2001 Council for the Central Laboratory of the Research Councils
Copyright © 2008 Science and Technology Facilities Council

EMS Error Message Service Version 2.2-0 Programmer's Manual

CCLRC / Rutherford Appleton Laboratory Particle Physics & Astronomy Research Council

Starlink Project

Contents

EMS
Error Message Service
Version 2.2-0
Programmer's Manual

CCLRC / Rutherford Appleton Laboratory
Particle Physics & Astronomy Research Council