Suggestion definition file settings (imdd_suggestion_arbitrary-character-string.conf)

The following items can be configured in the suggestion definition file (suggestion template):

JP1/PFM plug-in function

For details on JP1/PFM plug-in functions available in the suggestion definition file, see the description for each function in 5. JP1/PFM Plug-in Functions Available on JP1/IM2.
Tree SID

In the suggestion definition file, you specify the tree SID of an IM management node as a processing target of the JP1/PFM plug-in function for node in suggestion display criteria or sid in suggestion activation criteria when a JP1/PFM plug-in function is executed.

The Integrated Operation Viewer of JP1/IM2 shows components of Performance Management (IM management nodes) in the tree shown below. You can specify the tree SID of a numbered IM management node in Performance Management as a processing target of the JP1/PFM plug-in function.
```
All Systems
|
+- PFM-Manager-host-name <-(1)
|  +- Management Applications
|     +- JP1/PFM - Manager <-(2)
|
+- PFM-Agent-host-name <-(1)
|  +- Management Applications
|  |  +- JP1/PFM - Base <-(3)
|  |  +- JP1/PFM - PFM-View-name-of-PFM-Agent
|  |     +- service-ID-of-Agent-Collector <-(4)
|  |
|  +- PFM-Agent-product-specific-category
|     +- JP1/PFM - PFM-View-name-of-PFM-Agent
|  |     +- service-ID-of-Agent-Collector <-(5)
|
+- PFM-RM-host-name <-(1)
|  +- Management Applications
|     +- JP1/PFM - Base <-(3)
|     +- JP1/PFM - PFM-View-name-of-PFM-RM
|        +- service-ID-of-Remote-Monitor-Collector <-(6)
|        +- service-ID-of-group-agent <-(7)
|
+- monitored-host-name-of-remote-agent <-(1)
   +- Management Applications
   |  +- JP1/PFM - PFM-View-name-of-PFM-RM
   |     +- service-ID-of-remote-agent <-(8)
   |
   +- PFM-RM-product-specific-category
      +- JP1/PFM - PFM-View-name-of-PFM-RM
         +- service-ID-of-remote-agent <-(9)
```
The following shows examples of tree SIDs of numbered IM management nodes:

(1) Tree SID of an IM management node that corresponds to a host
- Tree SID example
  
  _ROOT_AllSystems/_HOST_PFMHOST
- Regular expression example
  
  _HOST_[^/]*$
- Note
  
  If a host has an IM management node of a product other than Performance Management, a plug-in of that product can also process this tree SID.
(2) Tree SID of an IM management node that corresponds to PFM - Manager
- Tree SID example
  
  _ROOT_AllSystems/_HOST_HOSTMGR/_CATEGORY_managementApplications/_OBJECT_JP1PFMMGR
- Regular expression example
  
  _OBJECT_JP1PFMMGR
- Note
  
  Only the JP1/PFM plug-in can process this tree SID.
(3) Tree SID of an IM management node that corresponds to PFM - Base
- Tree SID example
  
  _ROOT_AllSystems/_HOST_HOSTAGT/_CATEGORY_managementApplications/_OBJECT_JP1PFMBASE
- Regular expression example
  
  _OBJECT_JP1PFMBASE
- Note
  
  Only the JP1/PFM plug-in can process this tree SID.
(4) Tree SID of an IM management node that corresponds to a service of a PFM - Agent instance
- Tree SID example
  
  _ROOT_AllSystems/_HOST_HOSTAGT/_CATEGORY_managementApplications/_SUBCATEGORY_JP1%2FPFM%20-%20Windows/_OBJECT_JP1PFM-ATA1hostAGTJP1AGENTSERVICE
- Regular expression example
  
  _CATEGORY_m.*_OBJECT_JP1PFM-A[^1478]
- Note
  
  Only the JP1/PFM plug-in can process this tree SID.
(5) Tree SID of an IM management node that corresponds to performance data of a PFM - Agent instance
- Tree SID example
  
  _ROOT_AllSystems/_HOST_HOSTAGT/_CATEGORY_platform/_SUBCATEGORY_JP1%2FPFM%20-%20Windows/_OBJECT_JP1PFM-ATA1hostAGT
- Regular expression example
  
  _CATEGORY_[^m].*_OBJECT_JP1PFM-A[^1478]
- Note
  
  Only the JP1/PFM plug-in can process this tree SID.
(6) Tree SID of an IM management node that corresponds to a PFM - RM instance
- Tree SID example
  
  _ROOT_AllSystems/_HOST_HOSTRM/_CATEGORY_managementApplications/_SUBCATEGORY_JP1%2FPFM%20-%20RM%20Platform/_OBJECT_JP1PFM-A7A1i1%5BhostRM%5DJP1AGENTSERVICE
- Regular expression example
  
  _OBJECT_JP1PFM-A[1478].*%5B[^%]*%5D
- Note
  
  Only the JP1/PFM plug-in can process this tree SID.
(7) Tree SID of an IM management node that corresponds to a group agent
- Tree SID example
  
  _ROOT_AllSystems/_HOST_HOSTRM/_CATEGORY_managementApplications/_SUBCATEGORY_JP1%2FPFM%20-%20RM%20Platform/_OBJECT_JP1PFM-A7A1i1%5BAll%40hostRM%5DJP1AGENTSERVICE
- Regular expression example
  
  _OBJECT_JP1PFM-A.*%5BAll%40
- Note
  
  Only the JP1/PFM plug-in can process this tree SID.
(8) Tree SID of an IM management node that corresponds to a service of a remote agent
- Tree SID example
  
  _ROOT_AllSystems/_HOST_HOSTRA/_CATEGORY_managementApplications/_SUBCATEGORY_JP1%2FPFM%20-%20RM%20Platform/_OBJECT_JP1PFM-A7A1i1%5Bt1%40hostRM%5DJP1AGENTSERVICE
- Regular expression example
  
  _CATEGORY_m.*_OBJECT_JP1PFM-A[1478].*%5B(.|..|[^A]..|.[^l].|..[^l]|.{4,})%40
- Note
  
  Only the JP1/PFM plug-in can process this tree SID.
(9) Tree SID of an IM management node that corresponds to performance data of a remote agent
- Tree SID example
  
  _ROOT_AllSystems/_HOST_HOSTRA/_CATEGORY_platform/_SUBCATEGORY_JP1%2FPFM%20-%20RM%20Platform/_OBJECT_JP1PFM-A7A1i1%5Bt1%40hostRM%5D
- Regular expression example
  
  _CATEGORY_[^m].*_OBJECT_JP1PFM-A[1478].*%5B.*%40
- Note
  
  Only the JP1/PFM plug-in can process this tree SID.
Variable

In the suggestion definition file, variables are available for defining suggestion activation criteria and response actions. A variable string is enclosed between ${ and }.

If you specify a variable in the following format, you can get a property value of an IM management node of Performance Management that is shown in the Integrated Operation Viewer of JP1/IM2, from the IM management node with the target SID associated with the IM management node (monitoring agent) of Performance Management specified by the tree SID:
```
${.:target[PFM]:value.property.property-name:}
```
Example:

The following shows an example of getting the value of property name ServiceId from the IM management node selected in the Integrated Operation Viewer of JP1/IM2:
```
${.:target[PFM]:value.property.ServiceId:}
```

To Page Top