1RETSR(3NCARG)                    NCAR GRAPHICS                   RETSR(3NCARG)
2
3
4

NAME

6       RETSR - Called by a user to return to a saved state of the recovery
7       mode in NCAR Graphics.
8

SYNOPSIS

10       CALL RETSR(IROLD)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_entsr(int irold)
16

DESCRIPTION

18       The FORTRAN statement "CALL RETSR(IROLD)" is normally used to return
19       the internal error flag of SETER that says whether or not recovery mode
20       is in effect to the state that it was in before some past call to
21       ENTSR.
22
23       If recovery mode is turned off by a call to RETSR at a time when the
24       internal error flag is non-zero, this is treated as a fatal error; the
25       error message is printed, the dump routine FDUM is called, and a STOP
26       is executed.
27
28       The argument of RETSR is as follows:
29
30
31       IROLD       (an input expression of type INTEGER) - Specifies a desired
32                   value for the internal flag that indicates whether recovery
33                   mode is in effect or not.  The value 1 turns recovery mode
34                   on and the value 2 turns it off.  Normally, one uses a
35                   value of IROLD that was previously returned by a call to
36                   ENTSR.
37

C-BINDING DESCRIPTION

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

EXAMPLES

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

ACCESS

47       To use RETSR or c_retsr, load the NCAR Graphics libraries ncarg,
48       ncarg_gks, and ncarg_c, preferably in that order.
49

SEE ALSO

51       Online: entsr, eprin, errof, error_handling, fdum, icfell, icloem,
52       nerro, semess, seter, ncarg_cbind
53

55       Copyright (C) 1987-2007
56       University Corporation for Atmospheric Research
57
58       This documentation is free software; you can redistribute it and/or
59       modify it under the terms of the GNU General Public License as
60       published by the Free Software Foundation; either version 2 of the
61       License, or (at your option) any later version.
62
63       This software is distributed in the hope that it will be useful, but
64       WITHOUT ANY WARRANTY; without even the implied warranty of
65       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
66       General Public License for more details.
67
68       You should have received a copy of the GNU General Public License along
69       with this software; if not, write to the Free Software Foundation,
70       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
71
72
73
74UNIX                              March 1994                     RETSR(3NCARG)
Impressum