SPI Common Extensions Manual

Extended SPI Concepts
SPI Common Extensions Manual—427508-001
2-6
Object Name Templates
the name class is a period (.), $A.#B.C is a hierarchical name for tree C, and clearly
distinguishes it from other trees named C in other orchards or on other farms.
Object Name Templates
In all commands except ADD, the object name serves as a template with which the
names of actual objects known to the subsystem are compared to select objects to
which the command should be applied.
When used in this manner, whether in a command or a response, the name is called
an object name template. ADD is the only command that contains the name of an
object rather than an object name template.
Some subsystems let object name templates contain wild-card characters.
Subsystems provide one of these levels of support for wild cards in object name
templates:
NONE Wild-card characters are not allowed in name templates.
FIELD Only the asterisk (*) is allowed and can be used only to represent an entire
hierarchical level in a name (that is, all the characters between a pair of delimiter
characters). For example, a.*.c would match a.b.c and a.obj1.c, but a.*xyz.c is not
a valid template. Similarly, /a/*/b is a valid template, but /a/b*/c is not.
FULL Both asterisk (*) and question mark (?) are supported.
•
An asterisk matches zero or more characters, excluding delimiter characters.
•
A question mark matches any single character other than a delimiter
character.
Additional wild-card characters and matching rules can be defined by a
subsystem, depending on the object-name classes the subsystem supports.
Table 2-1. Sample Object Name Templates and Matching Object Names
Object Name
Template Type of Wild-Card Support Objects to Which Command Is Applied
$XYZ.* Field $XYZ.AAA, $XYZ.ABC, $XYZ.#BBB
$XYZ.AA* Field Illegal
$XYZ.AA? Field Illegal
$XYZ.AA* Full $XYZ.AAA, $XYZ.AAB
$XY?.AA* Full $XY1.AAA, $XY2.AABBC
$XYZ.ABC Field or Full $XYZ.ABC