NAME

       SEMESS - Called by a user to get a specified portion of the current error message.

SYNOPSIS

       MESSG = SEMESS(ITRIM)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       char *c_semess(int itrim)

DESCRIPTION

       In any routine that references SEMESS, it must be declared to be of type CHARACTER*113.

       If the internal error flag of SETER is non-zero, the value of the character expression
       "SEMESS(ITRIM)" is the remembered error message associated with that error flag, trimmed
       as indicated by the value of the input quantity ITRIM.  Otherwise, it is a string of
       blanks.

       When ITRIM = 0 or less, no trimming is done; the whole error message is returned.  When
       ITRIM = 1, prepended routine names and the associated slashes are trimmed off.  When ITRIM
       = 2 or greater, all leading routine names are trimmed off; just the error description is
       returned.

       Example: Assume that the current error message is the string "CPCLAM/AREDAM - AREA-MAP
       ARRAY OVERFLOW"; then, SEMESS(0) is that entire string, while SEMESS(1) = "AREDAM - AREA-
       MAP ARRAY OVERFLOW", and SEMESS(2) = "AREA-MAP ARRAY OVERFLOW".

       The argument of SEMESS is as follows:

       ITRIM       (an input expression of type INTEGER) - Says what part of the error message is
                   to be returned, as detailed above.

C-BINDING DESCRIPTION

       The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

EXAMPLES

       Use the ncargex command to see the following relevant examples: tseter, arex02.

ACCESS

       To use SEMESS or c_semess, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c,
       preferably in that order.

SEE ALSO

       Online: entsr, eprin, errof, error_handling, fdum, icfell, icloem, nerro, retsr, seter,
       ncarg_cbind

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.