Back|Forward

DCL:MATH1:SYSLIB : Internal Variable Management and Message Output: Explanation of Subroutines

2.4.4 rtpget/rtcget

1.

Function

Gets an internal variable from runtime option.

2.

Call

rpara = NumRu::DCL.rtpget(cpfix,cps)
cpara = NumRu::DCL.rtcget(cpfix,cps)

3.

Explanation of Parameters

cpfix	(C*(*))	Prefix for a variable name
cp	(C(*)*8)	Name of a variable
ipara	(I,R,L(*))	Value of a variable.
cpara	(C(*)*80)	Value of a variable
n	(I)	Number of internal variables

4.

Notes

(a)

Prefixes consist of a combination of the  'xx' portion of xxpget/xxpset , and ':', for example,  'GL:' of the variable managed by glpget/glpset.

(b)

The character-type array specified as CP, CPARA must have lengths of 8 and 80 characters, respectively, for 1 element.

(c)

If no variable corresponding to the runtime option is not specified, IPARA, CPARA cannot be changed.

(d)

It is assumed that a runtime option is basically gotten though environmental variables, command line arguments, and an external file, but the actual implementation is machine-dependent. Therefore, on the presumption that the OSLIB (See Chapter 3) is correctly installed, the following routines actually carry out the operation.

lpara = NumRu::DCL.rtpenv(cpfix,cp)	Gets the value of an environmental variable
rpara = NumRu::DCL.rtpopt(cpfix,cp)	Gets the value of an command line option
lpara = NumRu::DCL.rtpxfl(cpfix,cp)	Gets the option value from an external file
cpara = NumRu::DCL.rtcenv(cpfix,cp)	Gets the value of an environmental variable (character type)
cpara = NumRu::DCL.rtcopt(cpfix,cp)	Gets the value of an command line option (character type)
cval = NumRu::DCL.rtcxfl(cpfix,cp)	Gets the option value (character type) from an external file

(e)

When environmental variables, command line arguments, and an external file can be used to specify runtime options, their effect in descending order is command line arguments, environmental variables, and external file (if all three types are specified, the specification by the command line arguments is adopted).

(f)

For machines on which runtime options cannot be specified, the runtime option is considered as 'not specified'.