search

This command performs a grid object search.

Syntax

zos search [--detail] [--facts] [--type=] [--constraint=] [--order=]

Arguments

-t=, --type=

The user must specify one of the following grid object types:

  • user

  • resource

  • group

  • job

  • jobinstance

  • vmhost

Options

-e, --detail

Displays detailed information for each grid object rather than just a name.

-f, --facts

Displays facts for each grid object.

-c=, --constraint=

Specifies a constraint string to restrict search. The command defaults to "" to match everything. The user must enter a value with this option.

-o=, --order=

Specifies returned order (fact/a|d, fact/a|d,..).

-C=, --cols=

Specifies the terminal width for formatting. The user must enter a value with this option.

-h, --help

Displays a help message for this operation.

-d, --debug

Turns on debug output during this operation.

-v, --verbose

Turns on verbose output during this operation.

Examples

Example 1

To generate a detailed listing of all users in group eng, the user would enter the following command:

zos search -t user -c '<contains fact="user.groups" value="eng"/>' -o "user.location/d"