Where predicate

The PIDU export and list commands let you construct a where predicate to select the objects you want to export or list. In the where predicate, you can specify one or more conditions.

The where predicate has this format:

A condition has this format:

[not] attribute operator value

not

Indicates that the evaluation of the condition is to be reversed.

attribute

Specifies the name of a single-valued attribute that is valid for the object class. Note that multi-valued attributes are not supported.

You can specify any attribute that is valid for the object class. You can also specify the attribute name to limit definitions by name.

operator

Specifies one of the operators shown in Table 6.

value

Specifies the value of the attribute. All values are case-sensitive. Therefore, be sure to type the same uppercase and lowercase letters as are stored in the Printer Inventory. The special value null means that an attribute is not specified.

If you use the match operator, you must specify a regular expression as defined in the "Regular Expressions" in z/OS UNIX System Services Command Reference.

If the value contains special characters (such as * { } - > ), enclose the value in quotation marks.

Table 6 shows the operators that you can use when you construct a condition. Some operators are valid only for certain types of attribute values, as indicated in the table. For example, you can use the match operator only for attributes that accept strings values.

To specify an expression with multiple conditions, separate the conditions with one of these operators:

and

The expression is true only if both conditions are true.

or

The expression is true if either condition is true.

Multiple conditions are evaluated using an order of precedence, with and conditions evaluated before or conditions. You can override the order by using parentheses. Expressions in parentheses are evaluated first.

Example: This example lists FSA definitions for PSF printers that are TCP/IP-attached:

 pidu -c 'list fsa where fsa-type=psf-tcpip;'