NAME

       ENTSR - Called by a user to set recovery mode in NCAR Graphics.

SYNOPSIS

       CALL ENTSR(IROLD,IRNEW)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_entsr(int *irold, int irnew)

DESCRIPTION

       The FORTRAN statement "CALL ENTSR(IROLD,IRNEW)" is normally used to enter recovery mode
       and save the previous value of the internal error-recovery flag, but it can also be used
       to exit from recovery mode and save the previous value of the flag, or to just get the
       value of the flag, without changing it.

       If recovery mode is turned off by a call to ENTSR at a time when the internal error flag
       is non-zero, this is treated as a fatal error; the error message is printed, the dump
       routine FDUM is called, and a STOP is executed.

       The arguments of ENTSR are as follows:

       IROLD       (an output variable of type INTEGER) - Receives the old value of the internal
                   flag that indicates whether recovery mode is in effect or not.  In the former
                   case, the returned value will be a 1; in the latter case, it will be a 2.
                   Normally, the value returned is saved for a later call to RETSR.

       IRNEW       (an input expression of type INTEGER) - Specifies what is to be done to the
                   internal flag that indicates whether recovery mode is in effect or not.  If
                   IRNEW is a 1 or a 2, it becomes the new value of the internal recovery-mode
                   flag: the value 1 turns recovery mode on and the value 2 turns it off.  Other
                   non-zero values are illegal, but, if IRNEW is zero, the state of the internal
                   recovery-mode flag is not changed.

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 ENTSR or c_entsr, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c,
       preferably in that order.

SEE ALSO

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

COPYRIGHT

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