Launch a Configuration Form

Configuration forms require that the user be assigned to the Administrative role.

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= showConfigForm&name= <y>

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.

Configuration Form Attributes
Attribute Values
name

The name attribute value specifies which form:

  • customcorrelation = the Custom Correlation Configuration
  • communication = the Communication Configuration form
  • custompoller = the Custom Poller Configuration form
  • discovery = the Discovery Configuration form
  • globalnetworkmanagement = the Global Network Management form
  • monitoring = the Monitoring Configuration form
  • incident = the Incident Configuration form
  • status = the Status Configuration form
  • trap = the Trap Forwarding Configuration form
  • ui = the User Interface Configuration form

The following are optional filter parameters: 

http://<serverName>:<portNumber>/nnm/launch?cmd= showConfigForm&name= <x>&menus= <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 Forms
Attribute Values
menus

true = Show the view menus and the Close button. If not specified, the default is true.

false = Hide the view menus and the Close button to save space in the view.

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.