SEMESS(3NCARG)

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.