last modified: 05-FEB-2002 | catalog | categories | new | search |

NESC0988 XERROR.

XERROR, FORTRAN Library Error Message Processing Routines

top ]
1. NAME OR DESIGNATION OF PROGRAM:  XERROR.
top ]
2. COMPUTERS
To submit a request, click below on the link of the version you wish to order. Only liaison officers are authorised to submit online requests. Rules for requesters are available here.
Program name Package id Status Status date
XERROR NESC0988/02 Arrived 05-FEB-2002

Machines used:

Package ID Orig. computer Test computer
NESC0988/02 Many Computers
top ]
3. DESCRIPTION OF PROBLEM OR FUNCTION

XERROR is a collection of portable FORTRAN routines which serves as a central facility for processing error messages associated with errors occurring in libraries of FORTRAN routines.
top ]
4. METHOD OF SOLUTION

An internal table of messages which have been reported is kept in several local arrays in a lower level routine. The performance of the package upon occurrence of an error is dependent on the contents of this internal message table and current values of certain user-adjustable flags (global variables), which are stored as local variables in a bottom level routine. Five routines are provided to set or clear global variables, and there are four routines which may be used to ascertain the current values  of the global variables.
top ]
5. RESTRICTIONS ON THE COMPLEXITY OF THE PROBLEM

The internal message table is normally set to a maximum length of 10 messages.
top ]
6. TYPICAL RUNNING TIME

NESC executed the test program in 2 CPU second on an IBM4331.
top ]
7. UNUSUAL FEATURES OF THE PROGRAM

XERROR has the ability to place a  limit on the number of times any one message is printed, to request  error messages to be printed on up to five logical units, and to provide a summary of the number of times each message has been printed. Four levels of message severity are available.
top ]
8. RELATED AND AUXILIARY PROGRAMS

XERROR is the error-handling package used with the SLATEC3.2 Mathematical Subroutine Library (NESC 820).
top ]
9. STATUS
Package ID Status date Status
NESC0988/02 05-FEB-2002 Masterfiled Arrived
top ]
10. REFERENCES

- P.A. Fox, A.D. Hall, and N.L. Schryer:
  The PORT Mathematical Subroutine Library
  Association for Computing Machinery Transactions on Mathematical
  Software, Vol. 4, No. 2, pp. 104-105, June 1978.
- XERROR, NESC NO. 988.MPLN, XERROR Tape Description,
  NESC Note 91-17, November 27, 1990.
NESC0988/02, included references:
- R.E. Jones and D.K. Kahaner:
  XERROR, The SLATEC Error-Handling Package
  SAND82-0800 (May 1982) Preprint.
top ]
11. MACHINE REQUIREMENTS

254 Kbytes of memory are required to execute  XERROR with the test programs provided on an IBM4331.
top ]
12. PROGRAMMING LANGUAGE(S) USED
Package ID Computer language
NESC0988/02 FORTRAN-77
top ]
13. OPERATING SYSTEM UNDER WHICH PROGRAM IS EXECUTED:  VM/CMS (IBM4331).
top ]
14. OTHER PROGRAMMING OR OPERATING INFORMATION OR RESTRICTIONS

Dummy
routines are supplied for missing FDUMP and XERABT utilities, which  provide traceback and abort facilities in the Sandia computing environment. Suitable replacements for these routines will be required for the local computing environment.
The source includes the Bell Laboratories' I1MACH routine to determine the few particular machine-specific constants needed by the XERROR package. The appropriate machine constants must be enabled prior to execution.
top ]
15. NAME AND ESTABLISHMENT OF AUTHOR

          R.E. Jones
          Division 2614
          Sandia National Laboratories
          P. O. Box 5800
          Albuquerque, New Mexico 87185

          D.K. Kahaner
          Scientific Computing Division 713
          National Bureau of Standards
          Washington, DC 20234, U. S. A.
top ]
16. MATERIAL AVAILABLE
NESC0988/02
source program   mag tapeXERROR FORTRAN-77 Source                   SRCTP
source program   mag tapeSample Driver FORTRAN-77 Source            SRCTP
test-case output mag tapeSample Problem Output Unit 17              OUTTP
test-case data   mag tapeControl Information IBM VM/CMS EXEC        DATTP
test-case output mag tapeSample Problem Output Unit 6               OUTTP
report                   SAND82-0800 (May 1982) Preprint            REPPT
top ]
17. CATEGORIES
  • P. General Mathematical and Computing System Routines

Keywords: FORTRAN, data processing, libraries, utility routines.