garr
Purpose:
-
Display array variables from shared memory with options to format output for quiet mode, units, and delimiters.
Enter:
-
garr [-q] [-u] [-d delim] [-h] [array] [:enum_str]
or
garr [array] [?int_var]
Where:
-
:
The : symbol designates that the following index is either a constant integer or an enum defined in the array_specs file.
?
The ? symbol designates that the following string is the label of an integer variable whose value will be used as an index.
-q
Optional. Specify -q (quiet) to only print values.
-u
Optional. Specify -u to include units in the output.
-d delim
Optional. -Specify d delimiter to separate the values in quiet mode. Delimiter options are:
- c is ‘,’
- t is tab
- s is space
- n (default) is newline
array
Optional. Specify the array variable name.
-h
Optional. Specify -h to display help.
:enum_str
Optional. Specify the colon symbol followed by an enum string or integer to for the array index.
?int_var
Optional. Specify the question mark symbol followed by an integer variable whose value will be used as an index.
Example:
-
garr
The above command displays all the array variables. It displays only the labels of their associated maximum range for each dimension. No values will be displayed.garr my_vrbl
The above displays all the values for array variable <my_vrbl>garr my_vrbl:TC15
The above displays all the values for array variable <my_vrbl> that are associated with enum <TC15>.garr my_vrbl:TC15:STATUS
The above displays all the values for array variable `my_vrbl` that are associated with enums <TC15> and <STATUS>.garr my_vrbl?indx1?indx2
The above displays all the values for array variable <my_vrbl> that are associated with the values in integer variables <indx1> and <indx2>
Notes:
-
If an enum string is entered as a dash, then any element associated with that enum will NOT BE DISPLAYED.