ENTSR(3NCARG)

✨ ENTSR — it's giving "recovery mode, bestie" ✨

okay so this is a page from NCAR GRAPHICS, and it's all about ENTSR, the lil subroutine you call when you want to flip your error-recovery vibes on (or off, or just peek at them 👀). manual section 3NCARG, let's go 💅

---

🌸 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 💖

so basically, the FORTRAN statement CALL ENTSR(IROLD,IRNEW) is normally what you use to enter recovery mode and save the previous value of the internal error-recovery flag. but bestie, it's flexible like that — you can also use it to exit recovery mode and save the previous value of the flag, or literally just get the value of the flag without changing anything at all. multitasking queen 👑

⚠️ okay important one: if recovery mode gets turned off by a call to ENTSR at a time when the internal error flag is non-zero, that's treated as a fatal error. the error message gets printed, the dump routine FDUM is called, and a STOP is executed. so like. don't do that 💀

the arguments of ENTSR are as follows:

• IROLD — (an output variable of type INTEGER) — receives the old value of the internal flag that says whether recovery mode is in effect or not. if it is in effect, the returned value will be a 1; if it's not, it'll be a 2. normally you save that returned value for a later call to RETSR 🫶
• IRNEW — (an input expression of type INTEGER) — specifies what's gonna happen to the internal flag that says 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 — plot twist — if IRNEW is zero, the state of the internal recovery-mode flag is not changed. zero = we're just vibing, no touchy 🙈

---

🌈 C-BINDING DESCRIPTION 🌈

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. same energy, different language, slay ✨

---

⭐ EXAMPLES ⭐

use the ncargex command to see the following relevant examples: tseter, arex02. go look, they ate 🔥

---

👑 ACCESS 👑

to use ENTSR or c_entsr, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. order matters, don't fight it 🎀

---

💜 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.

---

and that's the whole page, bestie 💖 this was the UNIX flavor, from way back in March 1994, living under the name ENTSR(3NCARG) — iconic then, iconic now. no cap. periodt. 🌸✨