FSTOPC

RMNLIB

(FSTOPC)

FSTD


INTEGER FUNCTION FSTOPC( option, value, getmode)
DESCRIPTION

For control variables: MSGLVL, TOLRNC
If getmode = 1, then it will obtain(get) and print out the existing value of a global variable specified in "option". If getmode = 0, then it will set a global variable specified in "option" as given in the "value".


Authors: M. Lepine - M. Valin - 2000
ARGUMENTS

Input:
FSTOPC	0 if no error, else error code
option	the global variable which controls all fstd or xdf functions. There are two controls: 'MSGLVL': message level (how informative) 'TOLRNC': error tolerance level (before program crashes)
value	the value to give for "option" if getmode=0. There are 7 values available and here are their functions related to each option: for 'MSGLVL' option: 'DEBUG' - print all messages 'INFORM' - print any informative messages and more 'WARNIN' - print warning messages and more 'ERRORS' - print simple error messages and more 'FATALE' - print fatal error messages and up 'SYSTEM' - print system (internal) error messages only 'CATAST' - print catastrophe error messages only (same as SYSTEM) for 'TOLRNC' option: 'DEBUG' - no tolerance to error 'INFORM' - tolerate debugging level 'WARNIN' - tolerate informative level and lower 'ERRORS' - tolerate warning level and lower 'FATALE' - tolerate error level and lower 'SYSTEM' - tolerate fatal error level and lower 'CATAST' - tolerate fatal error level and lower (same as SYSTEM)
getmode	1: to obtain existing value of "option" and print a message to standard out 0: to set the "value" into the "option"


EXAMPLE
(in Fortran)

character*6 option,value
integer getmode,ier
getmode = 1
option = 'MSGLVL'
ier = fstopc( option, value, getmode )
ier = fstopc('TOLRNC','DEBUGS',0)

(in C)

char option[7],value[7];
int getmode,ier;
getmode = 0;
strcpy(option,"TOLRNC");
strcpy(value,"ERRORS");
ier = fstopc( option, value, getmode);
ier = fstopc("MSGLVL","FATALE",0);


SEE ALSO
 fstopi, fstopl

Return to product index