Create a CI

Using the Universal Connector › Integration Scenario Examples › Create a CI

Create a CI

You can manage CIs in two different XML tag contexts—<Events> tag and <Services> tag. The combination with other actions determines the XML tag context of your choice. For example, if you want to manage a CI along with a service, use the <Services>...</Services> tags. If you want to create an event along with the CI creation, use the <Events>...</Events> tags.

For Events tag, the structure to create a CI is as follows:
```
<Events>
	<Event>
	  eventType = AddCIEvent 
```
For Services tag, the structure to create a CI is as follows:
```
<Services> 
	<Service> 
	  eventType = AddCI 
```

Note: For a complete list of USM property tags, see the USM schema to determine which USM properties are required for the specific class of CI.

The following example lets you create a CI called MyMachine of the USM type ComputerSystem by running the batch program as follows:

GCEventAddCmd -hSOIserver.ca.com:7090 -fCreateCI.xml

The example uses the CreateCI.xml file that includes the following information about the CI:

<Events>
	<Event>
	  <property tag="eventType" value="AddCIEvent" /> 
	  <property tag="MdrElementID" value="MyMachine" />
	  <property tag="className" value="ComputerSystem" /> 
	  <property tag="Label" value="MyMachine" /> 
	  <property tag="Description" value="Description of a Universal Connector Entity" /> 
	  <property tag="AdministrativeStatus" value="Managed" /> 
	  <property tag="Vendor" value="Dell" /> 
	  <property tag="PrimaryDnsName" value="MyMachine.ca.com" /> 
	  <property tag="ComputerName" value="MyMachine" />
	  <property tag="MemoryInGB" value="1024" />

	</Event>

</Events>

The parameters used in this example XML file are as follows:

eventType: Specifies the type of event. For this example, the value is AddCIEvent.
MdrElementID: Specifies a unique identifier for the CI. For this example, the value is MyMachine.
className: Specifies the USM class name. For this example, the value is ComputerSystem.
Label: Specifies a short description for identification of the CI. It is important that the value of the label uniquely distinguishes entities in the interface. For this example, the value is MyMachine.
Description: Specifies a description of the CI. For this example, the value is "Description of a Universal Connector Entity".
AdministrativeStatus: Specifies the high-level administrative status of the CI. For this example, the value is Managed.
Vendor: Specifies the hardware vendor name. For this example, the value is Dell.
PrimaryDnsName: Specifies the fully qualified DNS name of the CI. For this example, the value is MyMachine.ca.com.
ComputerName: Specifies the name of the computer. For this example, the value is MyMachine.
MemoryInGB: Specifies the amount of system memory in GB. For this example, the value is 1024.