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


cimcli ci (createInstance)

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

cimcli ci (createInstance)

Purpose

Creates one instance of the specified class with the provided properties in the repository.

Operation

Read syntax diagramSkip visual syntax diagram>>-+-ci-------------+--classname-------------------------------->
   '-createInstance-'
 
   .--------------------------------------.
   V                                      |
>----+----------------------------------+-+--------------------->
     '-propertyName--+- = --+-------+-+-'
                     |      '-value-' |
                     '- ! ------------'
 
>--+-----------+--| Common options |---------------------------><
   '- -n--path-'
 

Usage

The classname parameter defines the class for which the instance is to be created. The optional set of parameters defines the properties to be provided (see also cimcli Instance name). The command reads the specified class and inserts the properties. The command will be rejected if the class does not exist in the namespace.

Specify a value for a property name according to its type. Follow the syntax rules as specified in Common Information Model Specification, DSP0004, Version 2.3 by the DMTF. Note special syntax rules to define

  • the current date and time with the keyword now for values of the type Datetime
  • an empty string with the property name followed by a ! for values of the type string
  • an NULL string with the property name followed by a = for values of the type string

Options

For special options and "Common options", see cimcli Options.

Examples

cimcli ci CIM_Person Name=Michael Title=Engineer

Creates an instance of the class CIM_Person.

Results

The command returns the object path of the created instance if the call to the CIM server was performed. Otherwise it returns the exception received.

0
Successful execution of the operation
all values other than 0
The execution on the operation returned an error.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014