Museum

ERROR_$PRINT_NAME                 Domain/OS                  ERROR_$PRINT_NAME


NAME
     error_$print_name - print error text with a name

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

     void error_$print_name(
          status_$t &status,
          error_$string_t source_name,
          pinteger &name_length)

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

     procedure error_$print_name(
          in status: status_$t;
          in source_name: univ error_$string_t;
          in name_length: pinteger);

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

           integer*4 status
           integer*2 name_length
           character source_name*80

           call error_$print_name(status, source_name, name_length)

DESCRIPTION
     Error_$print_name looks up the text associated with the status code and
     writes it to the error output stream, along with the supplied
     source_name.

     If there is text associated with all fields in the status code (subsys-
     tem, module, and code), output appears with source_name first, followed
     by a hyphen and a descriptive error message corresponding to the status
     code, followed by the subsystem and module names in parentheses.

     If the text for any of the three fields is not found, the status code is
     displayed in hexadecimal, along with the subsystem and module names, if
     known.

     status
          A status code returned from a Domain/OS call.

     source_name
          A string to be printed at the beginning of the error message.  This
          is usually the name of the souce of the error.

     name_length
          The number of bytes in source_name.