Launch an Incident View

Note If you copy/paste this URL, remove the spaces that were added for line-ending purposes in the documentation.

http://<serverName>:<portNumber>/nnm/launch?cmd= showView&view= <x>

Note If the NNMi Web server uses the https protocol, use https instead of http.

<serverName> = the fully-qualified domain name of the NNMi management server (values allowed here are determined by the Enable URL Redirect setting in User Interface Configuration, see Configure the NNMi User Interface)

<portNumber> = the NNMi HTTP port number

For a quick-reference list of all URL choices for launching NNMi, see HelpDocumentation LibraryIntegrate NNMi Elsewhere with URLs. The Integrate NNMi Elsewhere with URLs page also contains a link to a list of sample URLs that you can copy/paste as a starting point.

Potential Incident Workspace Views and Available Filters
View Name x = View ID Node
Filter
Interface
Filter
All Incidents allIncidentsTableView

Tip To display the All Incidents view filtered by a specified node, see Launch the Associated Incidents View (showIncidents)

Yes No
Closed Key Incidents closedKeyIncidentsTableView Yes No
Custom Incidents customIncidentTableView Yes No
Custom Open Incidents customOpenIncidentTableView Yes No
Dampened Incidents dampenedIncidentsTableView Yes No
Incidents by Correlation Nature incidentsByNatureTableView Yes No
Incidents by Family incidentsByFamilyTableView Yes No
Key Incidents by Lifecycle State keyIncidentsByLifecycleStateTableView Yes No
My Open Incidents myIncidentTableView Yes No
Open Key Incidents openKeyIncidentsTableView Yes No
Open Key Incidents by Category openKeyIncidentsByCategoryTableView Yes No
Open Key Incidents by Family openKeyIncidentsByFamilyTableView Yes No
Open Key Incidents by Priority openKeyIncidentsByPriorityTableView Yes No
Open Key Incidents by Severity openKeyIncidentsBySeverityTableView Yes No
Open Root Cause Incidents openRCIncidentTableView Yes No
Root Cause Incidents allRCIncidentTableView Yes No
Service Impact Incidents serviceImpactIncidentTableView Yes No
SNMP Traps snmpTrapsIncidentTableView Yes No
SNMP Traps by Family snmpTrapsIncidentByFamilyTableView Yes No
Stream Correlation Incidents streamCorrelationIncidentTableView Yes No
Unassigned Open Key Incidents unassignedKeyIncidentsTableView Yes No

 

The following are optional filter parameters:

http://<serverName>:<portNumber>/nnm/launch?cmd= showView&view= <x>&nodegroup= <Name>

Note If you copy/paste this URL, remove the spaces that were added for line-ending purposes in the documentation.

Filter by Node Group (launched Incident, Node, Interface, and IP Address views)
Attribute Values
nodegroup

The case-sensitive Name attribute value of the Node Group to use as a filter for this view.

Note The Node Group name is translated. If your team shares NNMi within multiple locales, use nodegroupid or nodegroupuuid.

If the Name value includes space characters, consider replacing the space character in your URL statement (see W3C Rules for URLs).

nodegroupid

The id is the Unique Object Identifier (unique across the entire NNMi database). Provide the id of the Node Group to use as a filter for this view.

This attribute value is not visible on any form within the console. To find this value, use the nnmconfigexport.ovpl command-line tool to export an XML file that includes the id attribute value for each object instance.

nodegroupuuid

The uuid is the Universally Unique Object Identifier (unique across all databases). Provide the uuid of the Node Group to use as a filter for this view.

This attribute value is not visible on any form within the console. To find this value, use the nnmconfigexport.ovpl command-line tool to export an XML file that includes the uuid attribute value for each object instance.

 The following are optional parameters: 

http://<serverName>:<portNumber>/nnm/launch?cmd= showView&view= <x>&menus= <true|false>&newWindow= <true|false>&envattrs= <name1= value>;<name2= value>

Note If you copy/paste this URL, remove the spaces that were added for line-ending purposes in the documentation.

Attributes for Launched Views
Attribute Values
menus

true = Show the view's button bar. If not specified, the default is true.

false = Hide the view's button bar to save space in the view.

newWindow

true = Display the view in a new browser window. This new window does not display the browser-specific menu bars. The browser-specific menu bars are hidden to provide the maximum amount of room for the requested view.

false = Display the view within the current browser window (if not specified, the default is false).

readonly

true = Prevents the user from doing either of the following:

  • Open any forms from the view
  • Manipulate any objects in the view (for example, delete an object)

false = Enables the user to do either of the following:

  • Open any forms from the view
  • Manipulate any objects in the view (for example, delete an object)
envattrs

Use Environment Attributes (envattrs) to pass <name=value> pairs from an external application to NNMi. Environment Attributes are session-specific and stored in memory (not in the NNMi database). The name-value pairs can be any arbitrary string (as required by the external program).

For example, let’s assume that NNMi was launched from an application that wants to preserve a session ID (123) and object attribute (node25) as follows:

http://<yourServerName/nnm?cmd= showView&objtype= Node&envattrs= com.my.sessionId= 123;com.my.objectName= node25

Note See Pass Environment Attributes for information about how to retrieve these Environment Attributes (envattrs) <name=value> pairs from NNMi, and pass them back to the originating external application.