Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ perror(3f) — Ultrix WS 2.0 VAX

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

intro(2)

perror(3)

perror(3f)

NAME

perror, gerror, ierrno − get system error messages

SYNTAX

subroutine perror (string)
character*(*) string subroutine gerror (string)
character*(*) string character*(*) function gerror() function ierrno()

DESCRIPTION

The perror subroutine will write a message to Fortran logical unit 0 appropriate to the last detected system error. The string will be written preceding the standard error message. 

The gerror subroutine returns the system error message in character variable string.  The gerror subroutine may be called either as a subroutine or as a function.

The ierrno subroutine will return the error number of the last detected system error. This number is updated only when an error actually occurs. Most routines and I/O statements that might generate such errors return an error code after the call. That value is a more reliable indicator of what caused the error condition.

RESTRICTIONS

The string in the call to perror can be no longer than 127 characters.

The length of the string returned by gerror is determined by the calling program.

NOTES

ULTRIX system error codes are described in intro(.). The f77 I/O error codes and their meanings are:

100“error in format”
101“illegal unit number”
102“formatted io not allowed”
103“unformatted io not allowed”
104“direct io not allowed”
105“sequential io not allowed”
106“can’t backspace file”
107“off beginning of record”
108“can’t stat file”
109“no * after repeat count”
110“off end of record”
111“truncation failed”
112“incomprehensible list input”
113“out of free space”
114“unit not connected”
115“invalid data for integer format term”
116“invalid data for logical format term”
117“’new’ file exists”
118“can’t find ’old’ file”
119“opening too many files or unknown system error”
120“requires seek ability”
121“illegal argument”
122“negative repeat count”
123“illegal operation for unit”
124“invalid data for d, e., f, or g format term”

FILES

/usr/lib/libU77.a

SEE ALSO

intro(2), perror(3)
“Introduction to the f77 I/O Library,” ULTRIX-32 Supplementary Documents, Vol. II:Programmer

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026