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

Configure Tivoli Application Dependency Discovery Manager Integration:
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
Send a Tivoli Application Dependency Discovery Manager Update with Operation Type: Create
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
Send a Tivoli Application Dependency Discovery Manager Update with Operation Type: Delete
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
Send a Tivoli Application Dependency Discovery Manager Update with Operation Type: Move
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