Introduction; Procedure Errors; G-Series And Later Procedure Errors - HP Guardian Errors Manual

1 Introduction

This manual describes the Guardian messages associated with the NonStop operating system.
This manual is dual-threaded, covering both G-series and H-series releases. For each message,
the description provides an explanation of the cause, a discussion of the effect on the system, and
suggestions for corrective action or response.
Several types of messages can be returned to your program:

Procedure errors

Interprocess messages
Error lists
Traps and signals
This introductory section explains each of these message categories.
Note that Sections 2- 1 8 describe the messages associated with specific procedures. Each of these
sections describes procedure errors or error lists or both. Section 19 and Section 20 describe
interprocess messages. Section 21 describes traps and signals. Section 22 describes how to find
more information on Open System Services (OSS) errors.
Procedure Errors
Procedure errors are values returned to your program after your program calls procedures such
as file-system procedures. Your application program should test for possible errors and take
appropriate action when necessary.
Your program detects procedure errors in two ways, depending on the procedure being called.
Errors returned by D-series procedures are not in the same format as those returned by C-series
procedures. The names of D-series procedures can be recognized by their trailing underscore; the
names of most C-series procedures do not contain the underscore character.

G-Series and Later Procedure Errors

ManyG-series procedures return procedure error values through an output parameter of the
procedure. For these procedures, you simply check the value of the error or status parameter to
determine whether an error occurred. For example, an error returned in the error parameter of the
procedure FILE_CREATE_ is a simple file-system error code giving the status of the operation.
Some G-series procedures return additional information through an error-item or error-detail
parameter. Depending on the procedure, this information can supply the ordinal number of the
parameter in error or other detailed information about the error encountered.
All G-series operating-system procedures have an integer returned value called error or status. If
the error might have associated information, the extra information is returned in an integer
error-detail output parameter. If error is a returned value, it is always possible to obtain it or return
it. Bounds checking is not required.
When error-detail is used, most error values share the error designations shown in
Table 1 Error Designations
Value Meaning
0 Successful operation
1 File-system error other than 0, 2, or 3; error-detail contains the file-system error number
2 Parameter error
Table 1.
Procedure Errors 15