list—list names of objects

Format

Description

The list command lists the names of all objects in a specified object class or only objects that meet certain criteria.

Operands

objectclass

The class of the objects that you want to list. For a list of the object classes, see Table 38.

where condition [and|or condition...]

Conditions that can limit the objects that are listed. Only objects that meet the conditions are listed. If you omit the where predicate, all objects in the specified object class are listed.

For information about how to specify a condition, see Where predicate.

Usage notes

You can use the list command in combination with the modify command to list all or selected objects in an object class and then modify one or more attributes. For an example, see Listing and modifying printer definitions.

Examples -- list

Listing printer definitions

• This example lists all IP PrintWay™ printer definitions:

  pidu -c 'list printer where printer-type=ip-printway ; '

• This example lists all PSF printer definitions:

  pidu -c 'list printer where printer-type=psf-mvs ; '

• This example lists printer definitions that include the Protocol component named lpr_options:

  pidu -c 'list printer where include-protocol=lpr_options ; '

• This example lists printer definitions that specify an LU name in the luname attribute. That is, the value of the luname attribute is not a null value.

  pidu -c 'list printer where not luname=null ; '

• This example lists IP PrintWay printer definitions that do not include a Protocol component. That is, the value of the include-protocol attribute is a null value.

  pidu -c 'list printer where printer-type=ip-printway and include-protocol=null;'

• This example lists printer definitions whose names start with prt:

  pidu -c 'list printer where name match "^prt" ; '

• This example lists printer definitions that contain attribute output-class=K either in the printer definition or in an included component:

  pidu -c 'list printer where output-class=K ; '

• This example lists printer definitions that have a printer type of ip-printway and also have either output class X or Y. The parentheses cause the or expression to be evaluated first.

  pidu -c 'list printer where printer-type=ip-printway and
           (output-class = X or output-class = Y) ; '

Listing printer pool definitions

This example lists all printer pool definitions in the Printer Inventory:

pidu -c 'list printer-pool ; '

Listing components

This example lists all components in the Printer Inventory:

pidu -c 'list allocation ; list netspool-eof-rules ; list netspool-options ; '
pidu -c 'list printway-options ; list processing ; list protocol ; '

Listing FSS definitions

• This example lists all IP PrintWay FSS definitions:

  pidu -c 'list printway-fss ; '

• This example lists all PSF FSS definitions:

  pidu -c 'list psf-fss ; '

Listing FSA definitions

• This example lists all FSA definitions in the Printer Inventory:

  pidu -c 'list fsa ; '

• This example lists all IP PrintWay FSA definitions:

  pidu -c 'list fsa where fsa-type=ip-printway ; '

• This example lists all PSF FSA definitions:

  pidu -c 'list fsa where fsa-type=psf-channel or fsa-type=psf-sna or
  fsa-type=psf-tcpip or fsa-type=afp-download-plus ; '