search

This command performs a grid object search.

Syntax

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

Options

-t, --type=<value>

Specify the grid object type (user, resource, job, jobinstance, vmhost, grid. 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=<value>

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=<value>

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

-n, --name

Displays object name instead of object ID.

-C, --cols=<value>

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=<value>

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

-Z, --tlsPort=<value>

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"