Selecting by Name

Objects can be selected by name using the selection criteria "n" followed by the object name(s) to match. All objects matching the given name are selected. For example, in the following command all objects named "Customers" are selected for use by the ZOMLIST service:

ZOMList +n Customers

The name can be specified as a character string pattern. For example, the following command lists all objects whose object name begins with "Cust"

ZOMList +n Cust*

In specifying a name to match, certain characters have special meaning:

?

question mark matches any single character

*

asterisk matches any sequence of zero or more characters

\

backslash causes the next character to be taken literally and ignores any special meaning that character might otherwise have

The next example selects all objects whose name begins with "Cust", followed by any character, followed by "XXX", followed by any number of characters:

ZOMList +n Cust?XXX*

This pattern would match object names such as "Cust1XXX" and "CustaXXXabc".

If more than one name is used with the same selection criteria, you can use commas to separate the names. The following examples both select all objects named "Customers", "Employees" or "SalesPeople":

ZOMList +n Customers +n Employees +n SalesPeople
 
ZOMList +n Customers,Employees,SalesPeople

In the latter case, we have combined the three selection items into a single selection by separating the three name patterns by commas (',').

The next example shows the use of the minus set operator ('-') to select all objects that do not have the name "Customers", "Employees" or "SalesPeople".

ZOMList +n * -n Customers,Employees,SalesPeople

Here the first selection item "+n *" selects all objects, then the minus item ("-n") that follows excludes all objects with the "Customers", "Employees" or "SalesPeople".

Objects can also be selected by specifying the owning directory. For example, the next command lists all objects named "Customers" belonging to the directory "SalesSystem":

ZOMList +n SalesSystem.Customers

The period ('.') separating the literals "SalesSystem" and "Customers" in this example indicates that SalesSystem is the owning directory and Customers is the object contained in this directory.

You can also use the pattern matching feature with directory names. For example, the following command selects all objects belonging to the Test directory:

ZOMList +n Test.*

The next example selects all objects whose name begins with "Cust" and belong to the Test directory:

ZOMList +n Test.Cust*

The next example selects all objects whose name begins with "Custs" and belong to any directory whose name ends with "Test":

ZOMList +n *Test.Cust*

As a convenience, you do not have to specify "+n" if the first selection is by name. In this case, "+n" is assumed. For example, the following two commands are equivalent:

ZOMList +n Customers, Satellites
ZOMList Customers, Satellites