Request Parameters
The Request Parameters table is used to define a JavaScript Object Notation (JSON) update request that identifies Cloud Pak System Software Monitoring Server to the Tivoli® Application Dependency Discovery Manager (TADDM) server or that defines the updated resource information that Cloud Pak System Software Monitoring Server sends to the TADDM server.
Monitoring agents that support TADDM integration will provide predefined policies containing TADDM activities that include predefined request parameters.
There are three fields: Key, Value Type, and Value. An update request must begin with a start array and end with an end array. An array can contain one or more objects. Each object is started with a start object and ended with an end object. Within an object every value type has a key.
- The Key contains a list of common predefined keys in a drop-down menu. Other valid key values can be entered, but they must be valid attributes supported by the associated Tivoli Common Data Model (CDM) classes. To access the CDM documentation see the TADDM Software Developer’s Kit (SDK).
- The Value Type is a fixed list of selectable values from a drop-down menu.
- The Value can be a predefined selected value or a user-defined
value. The most common options are displayed in a drop-down menu.
When providing a value in the Value column for a given Key, you might need to supply the associated Cloud Pak System Software Monitoring Server sensor that is provided by TADDM. See the "Sensor reference" topics in the Tivoli Application Dependency Discovery Manager Knowledge Center.
Examples
The predefined TADDM_Initialization policy includes the following JSON request for the Configure Tivoli Application Dependency Discovery Manager Integration activity:
Key | Value Type | Value |
---|---|---|
Array | Start | |
Object | Start | |
_cdmclass | String | com.collation.platform.model.topology.process.ManagementSoftwareSystem |
_jsonid | String | _jsonid_0 |
mssname | String | &{=(*TADDM_=Alias+_MSSNAME)} |
hostname | String | &{=MSSHostname} |
manufacturename | String | IBM |
productname | String | Cloud Pak System Software Monitoring Server Services |
label | String | Cloud Pak System Software Monitoring Server |
Object | End | |
Object | Start | |
_cdmclass | String | com.collation.platform.model.topology.process.MSSAccessInfo |
_jsonid | String | _jsonid_1 |
accessString | String | &{=SourceContactInfo} |
accessType | String | default |
parent | String | _jsonid_0 |
Object | End | |
Array | End |
The VMware VI monitoring agent provides a policy to update TADDM when new resources are created. The following JSON update request is predefined for the Send a Tivoli Application Dependency Discovery Manager Update activity:
Key | Value Type | Value |
---|---|---|
Array | Start | |
Object | Start | |
_cdmclass | String | com.collation.platform.model.topology.sys.vmware.VmwareUnitaryComputerSystem |
_jsonid | String | _jsonid_1 |
uuid | String | &WaitOnSituation1:KVM_TOPOLOGICAL_EVENTS.Host_UUID |
childsystem | String | _jsonid_2 |
Object | End | |
Object | Start | |
_cdmclass | String | com.collation.platform.model.topology.sys.UnitaryComputerSystem |
_jsonid | String | _jsonid_2 |
virtual | Boolean | true |
name | String | &{CT_Get2:/VM_Name} |
label | String | &{CT_Get2:/VM_Name} |
vmid | String | &{CT_Get2:/MORef} |
uuid | String | &WaitOnSituation1:KVM_TOPOLOGICAL_EVENTS.VM_UUID |
memorysharesvalue | String | &{CT_Get2:/Memory_Shares} |
numcpus | String | &{CT_Get2:/Num_CPUS) |
cpusharesvalue | String | &{CPU_Shares) |
hostsystem | String | _jsonid_1 |
Object | End | |
Array | End |
The VMware VI monitoring agent provides a policy to update TADDM when resources are deleted. The following JSON update request is predefined for the Send a Tivoli Application Dependency Discovery Manager Update activity:
Key | Value Type | Value |
---|---|---|
Array | Start | |
Object | Start | |
_cdmclass | String | com.collation.platform.model.topology.sys.windows.WindowsComputerSystem |
_jsonid | String | _jsonid_2 |
uuid | String | &WaitOnSituation1:KVM_TOPOLOGICAL_EVENTS.VM_UUID |
Object | End | |
Array | End |
The VMware VI monitoring agent provides a policy to update TADDM when resources are moved. The following JSON update request is predefined for the Send a Tivoli Application Dependency Discovery Manager Update activity:
Key | Value Type | Value |
---|---|---|
Array | Start | |
Object | Start | |
_cdmclass | String | com.collation.platform.model.topology.sys.vmware.VmwareUnitaryComputerSystem |
_jsonid | String | _jsonid_1 |
uuid | String | &WaitOnSituation1:KVM_TOPOLOGICAL_EVENTS.Host_UUID |
childsystem | String | _jsonid_2 |
Object | End | |
Object | Start | |
_cdmclass | String | com.collation.platform.model.topology.sys.windows.WindowsComputerSystem |
_jsonid | String | _jsonid_2 |
virtual | Boolean | true |
uuid | String | &WaitOnSituation1:KVM_TOPOLOGICAL_EVENTS.VM_UUID |
hostsystem | String | _jsonid_1 |
Object | End | |
Array | End |