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

NAME

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

SYNOPSIS

9       CALL ENTSR(IROLD,IRNEW)
10

C-BINDING SYNOPSIS

12       #include <ncarg/ncargC.h>
13
14       void c_entsr(int *irold, int irnew)
15

DESCRIPTION

17       The FORTRAN statement "CALL ENTSR(IROLD,IRNEW)" is normally used to
18       enter recovery mode and save the previous value of the internal error-
19       recovery flag, but it can also be used to exit from recovery mode and
20       save the previous value of the flag, or to just get the value of the
21       flag, without changing it.
22
23       If recovery mode is turned off by a call to ENTSR 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 arguments of ENTSR are as follows:
29
30
31       IROLD       (an output variable of type INTEGER) - Receives the old
32                   value of the internal flag that indicates whether recovery
33                   mode is in effect or not.  In the former case, the returned
34                   value will be a 1; in the latter case, it will be a 2.
35                   Normally, the value returned is saved for a later call to
36                   RETSR.
37
38
39       IRNEW       (an input expression of type INTEGER) - Specifies what is
40                   to be done to the internal flag that indicates whether
41                   recovery mode is in effect or not.  If IRNEW is a 1 or a 2,
42                   it becomes the new value of the internal recovery-mode
43                   flag: the value 1 turns recovery mode on and the value 2
44                   turns it off.  Other non-zero values are illegal, but, if
45                   IRNEW is zero, the state of the internal recovery-mode flag
46                   is not changed.
47

C-BINDING DESCRIPTION

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

EXAMPLES

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

ACCESS

57       To use ENTSR or c_entsr, load the NCAR Graphics libraries ncarg,
58       ncarg_gks, and ncarg_c, preferably in that order.
59

SEE ALSO

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

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