Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls Reference Manual—522629-013
C-1
C Completion Codes
This appendix lists the completion codes returned after execution of a process or, in
some instances, a job step. These codes indicate the degree of success of a program
in a standard manner, thus making it possible to create or build further steps based on
these codes.
Completion codes -32768 through -1 are reserved for HP use. The caller must be
privileged to have a negative completion code returned to its ancestor. Completion
codes 0 through 999 are reserved and are shared by the customer and HP.
Completion codes from 1000 through +32767 are reserved for customers. HP
subsystems will not use these completion codes.
The following completion codes are defined and should be used according to these
definitions for uniformity:
Completion
Code Definition
0 Normal, voluntary termination with no errors. This code is the default
code for PROCESS_STOP_ (if abnormal termination is not specified)
and STOP if no completion code is specified, and for the OSS exit()
function if the exit status is 0.
1 Normal, voluntary termination with WARNING diagnostics. For
example, if the process is a compiler, the compilation terminated with
WARNING diagnostics after building a complete object file.
2 Abnormal, voluntary termination with FATAL errors or diagnostics. For
example, if the process is a compiler, the compilation terminated with
FATAL diagnostics and either an object file was not built or, if built,
might be incomplete. A complete listing is generated.
3 Abnormal, voluntary, but premature termination with FATAL errors or
diagnostics. For example, if the process is a compiler, the compilation
terminated with FATAL diagnostics, with either no object file or an
incomplete object file being built and an incomplete listing generated
(the compiler quit compiling prematurely).
4 Process never got started. This completion code exists primarily for
the use of the command interpreter or other command language
interpreters that can act as the executor process of a batch job. This
code allows the executor process to detect that a process associated
with a RUN statement never got started. In that sense, this completion
code is a “fake” completion code. The command interpreter acts as
though it received a termination message from the process that it tried
to create, when in fact it received an error returned by the procedure
or OSS function that launched the process. The command interpreter
then makes the completion code and the error returned by the
procedure or OSS function that launched the process available for
evaluation, for example, by a batch job executor process.