z/OS Common Information Model User's Guide
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


cimcli Options

z/OS Common Information Model User's Guide
SC34-2671-00

cimcli Options

Purpose

Options are identified on the command line with the '-' or '--' notation. An option that is not used by a particular operation is ignored.

Common options

Read syntax diagramSkip visual syntax diagram   .----------------------------.
   V                            |
>>---+------------------------+-+------------------------------><
     '-+- -count--number----+-'
       +- -d----------------+
       +- -delay--number----+
       +- -p--password------+
       +- -l--location------+
       +- -u--username------+
       +- -o--outputformats-+
       +- -x----------------+
       +- -v----------------+
       +- --sort------------+
       +- --sum-------------+
       +- --timeout--sec----+
       '- --t--time---------'
 

Usage

The cimcli command recognizes the following common options:

-count number
Expected number of objects returned, if the –sum option is set. Tests this number and displays the difference. Term nonzero is returned if test fails.
-d
Displays more detailed debug messages.
-delay number
Delay in seconds between connection and request. Default is 0.
-l location
Allows input of the host name for the CIM server and optionally the port (HostName:port). The default is localhost:5988. The port component is optional. The default is 5988.
-n path
Specifies the namespace for the operation. The default is root/cimv2.
-o outputformats
Specifies the output format. Valid values are: xml, mof, and table. Default is mof.
-p password
Allows the input of a password for the command's server authentication. The default is empty.
- -r repeat
Sets the number of times to repeat the function. Zero means one time. Repeats the operation without disconnecting. Default is 0.
- -sort
Sorts the output objects before they are displayed.
- -sum
Presents only summary information, not the complete output. Generally this option presents counts of objects returned instead of the names or objects themselves.
- -t time
Measures the time for operation and presentation of the results upon command completion.
- -timeout sec
Sets the connection timeout in seconds. Default is 20.
-trace traceLevel
Sets the common components trace. Sets the trace level. 0 is off. Default is 0. Valid values are 0 to 5.
-u username
Allows the input of a user name for authentication. The default is empty.
-v
Displays verbose data (including operation parameters).
-x
Output objects in xml instead of mof format.

The cimcli command recognizes the following special options:

-ac assocClass
Passes the assocClass parameter to applicable association operations. Default is to pass no assocClass parameter.
-ar associationRoleName
Defines an association role for associator operations.
-di
Specifies the deepInheritance parameter for selected commands. The default is 'false'. This option has different meanings for different commands and is used only with the enumerate commands. For further information, refer to the CIM Operations over HTTP published by the DMTF.
-i
Interactively asks the user to select instances. Used with associator and reference operations.
-ic
Sets the CIM operation parameter classOrigin in the operation request to true. Only useful with option -o xml.
-iq
Sets includeQualifiers = true.
-lo
Passes localOnly=true to applicable operations.
-nlo
When set, sets localOnly = 'false' on operations. Default is 'false'.

Note that option localOnly has been deprecated by the DMTF for some operations and will completely be removed with the next major version of CIM.

-niq
Sets includeQualifiers = 'false' on operations. Default is 'false'.

Note that option includeQualifiers has been deprecated by the DMTF for some operations and will completely be removed with the next major version of CIM.

-pl propertyNameList
Passes the propertyNameList parameter to applicable operations. Format is p1,p2,p3 (without spaces) or "" for an empty list. The default is to pass no propertyList parameter.
-r role
Passes the role parameter to applicable association operations. Default is to pass no role parameter.
-rc resultClass
Passes the resultClass parameter to applicable association operations. Default is to pass no resultClass parameter.
-rr resultRole
Passes the resultRole parameter to applicable association operations. Default is to pass no resultRole parameter.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014