This facility was provided for use with (now-obsolete)
devices like CalComp plotters that hijack STDOUT
.
MXDESC3=60
lines of length at most
MXDLIN3=80.
MXDLIN3=80.
with default value
CMISS3="????????????????"
setenv IOAPI_OFFSET_64 YES
), then
netCDF is told to create files that can have timesteps larger
than 2 GB. Note that MXVARS3=2048
variables on
a 100×100×25 grid (or 21 variables on a
1000×1000×25 grid) occupies slightly less than
2GB, so we're talking "quite large" model runs in order to
need this...).
DSCGRID()
and
DSCOORD()
.
The following environment variable controls whether routines GETDBLE(), GETMENU(), GETNUM(), GETREAL(), GETSTR(), GETYN(), PROMPTFFILE(), and PROMPTMFILE(), prompt the user for the value requested, or not. Setting PROMPTFLAG to "N" can be used, in conjunction with the selection of "smart" defaults within programs, to make it easier to write scripts for running various programs.
Note that for environment variables with multi-word values (i.e., values containing blanks), you will need to quote the value in order for setenv to handle it correctly—for examaple:
setenv EXECUTION_ID 'This run will pling the Inghams' setenv MYLIST '1, 2, 3, 4, 5, 6, 7'
OMP_NUM_THREADS
to control how many
parallel threads/processors are used for program execution. In
particular, this applies to "m3tools" programs M3AGMASK,
M3AGMAX, M3COMBO, M3TPROC
and VERTINTEGRAL
for
I/O API version 3.1 later than Nov. 21, 2013, and
programs built with I/O API routines BILIN()
,
BMATVEC()
, DMATVEC
, CBARNES1()
,
and CBARNESN()
using I/O API versions later than
Sept. 12, 2014.
ENVDBLE()
, ENVINT()
, ENVREAL()
, ENVSTR()
, and ENVYN()
can be used from programs to find
values of types DOUBLE PRECISION, INTEGER, REAL, CHARACTER
string, or LOGICAL
; ENVGET()
is a generic routine for single-value environment variables of any of these types.
For environment variables whose values are
comma-delimited lists INTLIST(), REALLIST(),
, and
STRLIST()
are type-specific for lists of types
INTEGER, REAL,
or CHARACTER
string;
ENVLIST()
is the generic. All of thes routines log the
value retrieved, convert it to the indicated type, and return it to the
caller.
Routine NAMEVAL()
, which
performs a similar function for CHARACTER
STRINGs, but does
not log the transaction, is used internally by the I/O API; this
should not be used by modeling codes, for log-integrity
reasons.
Routine SETENVVAR()
can be used
to set environment variables for the currently-executing program.
Next Section: Grids and Coordinate Systems
To: Models-3/EDSS I/O API: The Help Pages