aserrorcode - array services error information


SYNOPSIS

       #include <arraysvcs.h>

       extern aserror_t aserrorcode;

       #define aserrnoc(errorcode)
       #define aserrwhatc(errorcode)
       #define aserrwhyc(errorcode)
       #define aserrextrac(errorcode)

       #define aserrno    ...
       #define aserrwhat  ...
       #define aserrwhy   ...
       #define aserrextra ...


DESCRIPTION

       aserrorcode  is  a global variable maintained by the array
       services library, libarray.  Many array services functions
       store detailed status in this variable when they complete.
       The variable aserrorcode is made up of four fields,  which
       can be accessed with the following macros:

       aasseerrrrnnoo
            Summarizes  the results of the most recent array ser­
            vices function.  This is similar to the libc variable
            errno  in  that  it is only set if some sort of error
            condition occurred.

       aasseerrrrwwhhaatt
            For certain values of aserrno, this  field  describes
            the particular component that experienced trouble.

       aasseerrrrwwhhyy
            For  certain  values of aserrno, this field describes
            why the error occurred.

       aasseerrrreexxttrraa
            Certain combinations  of  aserrno,  aserrwhat  and/or
            aserrwhy  may cause some additional information to be
            stored in this field.  The exact information  depends
            on the particular combination.

The  specific  values  that  can  be  stored  in these fields are
described in the file <arraysvcs.h>.

The individual fields of an error code can be extracted  from  an
arbitrary  value  using  the  aserrnoc, aserrwhatc, aserrwhyc and
aserrextrac functions respectively.

       aserrorcode is defined in the library  "libarray.so",  and
       will  be loaded if the option "-larray" is used with cc(1)
       or ld(1).


SEE ALSO

       asmakeerror(3X), asperror(3X), asstrerror(3X),  array_ses­
       sions(5).


Man(1) output converted with man2html