Some high-level languages might allow you to
declare more than one variable with the same fully qualified name (although
you generally are not able to refer to these variables in the high-level language
program after they are declared). If you attempt to refer to such a variable
using an i5/OS® test facility
command, the system selects one of the variables and uses it for the operation.
No error is reported when a duplicate fully qualified name is selected.
Qualified-Name
>>--+-/ODV-number------------------------------+---------------><
| .------------------------. |
| V | |
'-variable-+----+-OF-+--variable-------+-+-'
| '-IN-' |
| .---------------. |
| V | |
'---variable-------+----------'
Note: The maximum is 19 repetitions.
Rules for qualified name description
- An ODV number is a slash (/) followed by 1 to 4 hexadecimal digits (0
through 9, and A through F).
- The variable-name must be the name of a variable in the program. This
name must be specified the same way in the high-level language. Some high-level
languages introduce qualifier variable names in addition to the ones you specified
in the source for your program. See the appropriate high-level language manual
for more information about variable names.
- Blanks must separate the variable-names from the special words OF and
IN.
- When a period is used to form a qualified name, no blanks can appear between
it and the variable-names.
- The ordering of the variable names must follow these rules:
- For qualified names that contain no embedded period, the variable names
are assumed to be specified from the lowest to the highest levels in the structure.
- For qualified names that contain one or more embedded periods, the variable
names are assumed to be specified from the highest to the lowest levels in
the structure.
- When an ODV number is not used for the qualified name, enough qualifier
variable names must be specified so that a single unique variable can be identified
in the program. Whether the qualified name is a simple name (only one variable
name specified) or a name with multiple qualifier variable names, the variable
in the program is uniquely identified if either of the following conditions
is true (these conditions may require you to specify more qualifier variable
names for i5/OS test facility
commands than you need to specify in the high-level language program to uniquely
select a program variable):
- A variable is uniquely identified if there is one and only one variable
in the program with a set of qualifier variables matching the qualified variable
name specified.
- A variable is uniquely identified in the program if it has exactly the
same set of qualifier variables as the qualifier variable names specified.
When the complete set of qualifiers is specified, the variable name is said
to be fully qualified. A variable that is a fully qualified match
for the qualified-name is selected even if there are other variables with
names that match the qualified name but have additional qualifier variables
which were not specified.