search

This command performs a grid object search.

Syntax

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

Options

-t, --type=

Specify the grid object type (user, resource, job, jobinstance, vmhost, matrix. XXXgroup) The user must enter a value with this option.

-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.

-z=, --tls=

Force TLS/SSL encryption [on|off]. The user must enter a value with this option.

-Z=, --tlsPort=

Port number for TLS/SSL connections. The user must enter a value with this option.

-y, --tlsYesNew

Force acceptance of new TLS server certificates.

-Y, --tlsYesAll

Force acceptance of all TLS server certificates.

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"