ENTSR(3NCARG)

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.