Qualified-name description

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 IBM i 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 IBM i 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.