This function is used to display and modify variables within the debugger when a Natural object has been interrupted.
For the interrupted Natural object, the Variable maintenance function
displays user-defined variables, global variables and the database-related system variables
*COUNTER, *ISN and
*NUMBER together with Natural data formats, lengths and
contents.
This section covers the following topics:
This section provides instructions for invoking either the Display Variables (summary) screen with a list of all variables, or the Display Variable (individual) screen with all details on a particular variable.
To display a summary of user-defined, global and database-related system
variables
In the Debug Main Menu or in the Debug
Break window, enter function code V.
Or:
Enter the following direct command:
DISPLAY VARIABLE variable,variable,...
The Display Variables (summary) screen provides a list of the variables specified for the interrupted Natural object. Long values may be displayed truncated on the screen. For arrays, only the contents of the first occurrence are displayed.
To switch between alphanumeric and hexadecimal representation of the variable contents, choose PF10 (Alpha) and PF11 (Hex).
To toggle between the truncated display of a variable and the full name display with the group name, variable name and indices (if relevant), choose PF5 (Zoom).
For variable, a system variable can also be specified. See Display System Variables for more information.
To display an individual variable in its entirety
From the Display Variables (summary) screen, select a
variable by marking it with the line command DI.
Or:
Enter the following direct command:
DISPLAY VARIABLE variable
Or:
On the List Object Source screen, in the
Source column, position the cursor at a variable name and
choose PF18 (Di Va).
The following restrictions apply when using PF18 (Di Va):
If a variable name (including the occurrences of an array) spans more
than one line, only the contents of the first line are evaluated.
If an array name is not followed by an index, the entire array is
displayed.
If the index of an array is constant, for example, array (3,2,6), only
this occurrence is displayed.
If the index of an array is variable, for example, array (i,j) or
array (3:i), the variables are evaluated before the respective occurrences
of the array are displayed.
Or:
On the List Object Source screen, in the
Source column, position the cursor at a variable name and
choose ENTER.
When using ENTER, the same restrictions apply as for PF18, see above. However, the variable or array occurrence is displayed in a window instead of using the Display Variable (individual) screen, if the index for an array does not denote more than one occurrence. If the index for an array denotes more than one occurrence, data is displayed using the Display Variable (individual) screen.
Or:
Instead of positioning the cursor manually and choosing ENTER you can also use
Entire Connection for ease of use. Here, a double click with the left mouse button
positions the cursor and simulates the ENTER key.
The Display Variable (individual) screen, or a window appears with all relevant specifications for the particular variable.
If data is displayed using a window and the length of the contents of the variable exceeds 256 bytes, only the first 256 bytes are displayed. For the Display Variable (individual) screen there is no such limit and you can navigate through the entire contents of the variable as described in the instructions below.
To display the entire contents of the variable or navigate within the contents
Choose PF22 to page backward or PF23 to page forward.
Or:
In the Position field, enter a numeric value to start the
display at a particular position.
You can choose PF10 (Alpha) and PF11 (Hex) to switch between alphanumeric and hexadecimal representation of the variable contents.
To display all occurrences of an array using screen functions
From the Display Variables screen, select a variable by
marking it with the line command DI.
Or:
Choose PF7 (-) and PF8 (+) to page between the individual
occurrences.
To display one or more occurrences of an array using direct commands
Use the following direct command:
DISPLAY VARIABLE variable-name(index-specification)
where variable-name denotes the name of
the variable, and index-specification
denotes any of the following: an index notation, an index range, or asterisk (*)
for all occurrences of a dimension. Variables that are part of the
index-specification are evaluated before the
respective occurrences are displayed.
Examples:
DISPLAY VARIABLE ARRAY1(*) |
One-dimensional array:
Displays all occurrences of
the one-dimensional array |
DISPLAY VARIABLE ARRAY1(1)
or
|
One-dimensional array:
Displays the first
occurrence of the one-dimensional array |
DISPLAY VARIABLE ARRAY2(2,3:4) |
Two-dimensional array:
Displays the second
occurrence of the first dimension and the index notation of the second
dimension of the two-dimensional array |
DISPLAY VARIABLE
ARRAY3(1,3:4,*) |
Three-dimensional array:
Displays the first
occurrence of the first dimension, the index notation of the second
dimension, and all occurrences of the third dimension of the
three-dimensional array |
DISPLAY VARIABLE ARRAY4(I,J +
1) |
Two-dimensional array:
Displays the occurrence of
the two-dimensional array |
To display system variables (except database-related system variables)
Enter the following direct command:
SYSVARS
The System Variables screen appears with a limited set of system variables.
To display a single system variable
Use the following direct command:
DISPLAY VARIABLE system-variable-name
where system-variable-name is the name of the system variable which can also be displayed using the SYSVARS direct command.
For variables of the type Handle, the name of the class of the instance that the Handle
refers to is displayed in alphanumeric representation. If the class name is not available,
the Globally Unique Identifier (GUID) is displayed instead. If the class was defined
within Natural, the class name or GUID is suffixed with (NAT).
The contents of properties of an instance of a class cannot be displayed within the debugger.
This function does not apply to system variables.
This function is used to change the value of user-defined and global variables and the database-related system variables.
To modify the contents of a variable from the Modify Variable screen
Invoke the Modify Variable screen by marking the variable with
the line command MO.
Or:
On the Display Variable screen, choose PF5
(Mod).
On the Modify Variable screen, in the Contents field, change the value of the variable.
The new contents must be valid for the Natural data format of the modified variable since the format of a variable cannot be modified within the debugger.
On the Modify Variable screen, you can toggle between alphanumeric and hexadecimal representation of the variable value using PF10 (Alpha) and PF11 (Hex).
To modify the contents of a variable via direct command
Enter the following direct command:
MODIFY VARIABLE variable = new value
A message appears that confirms modification of the variable value.
Note
The Modify Variables function or the MODIFY
VARIABLE command can be disallowed by Natural Security as described in
Components of an
Environment Profile in the Natural Security
documentation.
