NAGWare Fortran Tools - f77 Tools - nag_lvi

Index

NAME
DESCRIPTION
OPTIONS
RESTRICTIONS
SEE ALSO

NAME

nag_lvi - Local Variable Initialiser

DESCRIPTION

nag_lvi is the NAGWare f77 Tools Local Variable Initialiser. This tool can be used as an aid to debugging a program which is producing incorrect numerical results. It inserts assignment statements that initialise every local variable in each program unit to a given value. In this way, after compilation of the output from the tool, it is possible to see in a debugger, if any variables initialised by the tool are being used before being set by the program. This may highlight that a mistake in the original code may be due to a variable not being initialised and thus an incorrect result being generated.

Values are set in assignment statements which are inserted immediately after the declaration statements of each program unit. These values can be specified by the user and are treated as strings so any valid syntax may be used.

OPTIONS

"INTEGER Initial Value" (-integer value): INTEGER local variables will be set to value. The default if this option is not specified is -2147483648.
"INTEGER*2 Initial Value" (-short value): INTEGER*2 local variables will be set to value. The default if this option is not specified is -32768.
"REAL Initial Value" (-real value): REAL local variables will be set to value. The default if this option is not specified is 1.0E38.
"DOUBLE PRECISION Initial Value" (-double value): DOUBLE PRECISION local variables will be set to value. The default if this option is not specified is 1.0D308.
"COMPLEX Initial Value" (-complex value): Both real and imaginary parts of COMPLEX local variables will be set to value. The default if this option is not specified is 1.0E38.
"DOUBLE COMPLEX Initial Value" (-dble_complex value): Both real and imaginary parts of DOUBLE COMPLEX local variables will be set to value. The default if this option is not specified is 1.0D308.

RESTRICTIONS

nag_lvi uses variables with the names AR1111, M11111, M11112, M11113, M11114, M11115, M11116, M11117 for code generation and thus the names should not be present in the users program. If any of these variables are present in the program the program will terminate.