Spooler Programmer's Guide

Spooler Programmer’s Guide—522287-002
C-1
C Spooler-Related Errors
This appendix explains the error codes returned by the spooler interface, print, and
utility procedures. These codes are listed numerically by type.
Each spooler procedure is a type INT function that returns an octal spooler error code
indicating its outcome. The leftmost part of the error number indicates the source of
the error:
%1000 = File-system errors
%2000 = Collector file errors
%3000 = Spool control file errors
%4000 = Device errors
%5000 = Print errors
%100000 = NEWPROCESS errors or PROCESS_CREATE_ errors
You can extract the relevant file-system error number from most of these error codes
by examining bits <8:15>. For example, if the error code returned is %1074, bits
<8:15> contain file-system error %074 (device has been downed).
Some of the common file-system error codes are described in this appendix. All other
file-system error codes are described in the System Procedure Errors and Messages
Manual.
The NEWPROCESS error codes and the PROCESS_CREATE_ errors are described
in the Guardian Procedure Errors and Messages Manual. The NEWPROCESS error
codes should not be confused with the PROCESS_CREATE_ errors. For example,
when a NEWPROCESS error is encountered, the cause is often included in bits
<8:15> of the error code. With PROCESS_CREATE_ errors, the cause of the error is
often returned in the error-detail parameter.
Interface Errors
The following error codes are returned by the spooler interface procedures.
Cause. The operation was completed.
Effect. None.
Recovery. None.
Cause. The collector encountered a file-system error.
Effect. The spooler ignores the request.
0 (%0)
512-767 (%1000 - %1377)