next up previous 204
Next: Message Output
Up: EMS Error Message Service
Previous: Message Tokens


Reporting Status, Fortran I/O and Operating System Errors

Three subroutines are provided by the Error Message Service to enable a message token to be built from the error flag value returned from standard Starlink library routines, system routines or Fortran I/O operations. (For C programmers, emsErrno is also provided, see Section [*].) It is important that the correct routine is called, otherwise the wrong message or, at best, only an error number will be obtained.

It should be noted that the messages returned using these subroutines will depend upon the operating system in use. The error messages returned by operating systems vary considerably in their clarity and so should not be relied upon as the sole source of information in error reports.

The subroutines are:

EMS_FACER( TOKEN, STATUS )
where STATUS is a standard Starlink facility status value,
EMS_FIOER( TOKEN, IOSTAT )
where IOSTAT is a Fortran I/O status code, and
EMS_SYSER( TOKEN, SYSTAT )
where SYSTAT is a status value returned from a system routine.

In each case the message associated with the given error code is assigned to the specified message token. On completion, each of these subroutines returns its second argument unchanged.



next up previous 204
Next: Message Output
Up: EMS Error Message Service
Previous: Message Tokens

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