Museum

ERROR_$INTRO                      Domain/OS                       ERROR_$INTRO


NAME
     intro - Domain/OS error reporting

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/error.h>

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/error.ins.pas';

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/error.ins.ftn'

DESCRIPTION
     Most Domain/OS calls return a completion status in an argument of type
     status_$t.  The error_$ calls facilitate the interpretation of completion
     statuses and the printing of appropriate error messages.

     The following is a list of the error_$ calls.

        error_$code              return the error code from a completion
                                 status
        error_$fail              test the fail bit in a completion status
        error_$find_text         find error reporting text
        error_$get_text          get error reporting text
        error_$init_std_format   initialize standard error reporting
        error_$module            return the module code from a completion
                                 status
        error_$print             print an error message
        error_$print_format      print an error message in standard format
        error_$print_name        print error text with a name
        error_$std_format        print a standard error message
        error_$subsys            return the subsystem code from a comple-
                                 tion status

   Data Types
     error_$integer32
          A 32-byte integer.

     error_$string_ptr_t
          A pointer to type error_$string_t.

     error_$string_t
          An array of 80 bytes used for string arguments to error_$ calls.