Administer > Extend NNMi Capabilities > Control the NNMi Console Menus > Create Menu Nesting (in the Actions Menu)

Create Menu Nesting

[This is the Context-Sensitive Help topic for the Menu form.]

As an NNMi administrator, you configure how menu items are nested beneath the NNMi console's expandable menu structure. The expandable Menus can then contain menu items or other (cascading) expandable menu structures.

To configure a Menu structure, beneath which menu items can be nested:

  1. Provide the required information to define the Parent-level menu structure label (see basics table).
  2. Click  Save and Close to save and apply your changes.
  3. Assign Menu Items to appear beneath the menu structure label. The Menu from step 2 is now available as a choice in the Parent Menu attribute drop-down list for Menu Items. See Configure Menu Item Basic Details.
  4. To test your changes to the menu structure:

    1. If required, access a view or form that contains the appropriate object type.
    2. If required, select an object instance.
    3. Select the menu you configured.
    4. Verify your changes are working.
Configuration Settings for a Menu Nesting
Attribute Description
Menu Label

The text string that appears in the submenu. Ensure that your expandable menu label is unique and provides an accurate indication about the group of Menu Items that are available beneath this expandable parent menu label.

Note If you add two Menu Labels with the same text string but different Unique Keys, it would be possible for both to show up beneath the same specified Parent Menu.

The maximum length is 40 characters. Alpha-numeric, spaces, and underline characters are permitted.

Accessibility Key

Optional: The value you enter here does two things:

  • Specifies which ASCII character is underlined in the NNMi expandable menu structure if that ASCII character is part of the text entered into the Menu Label attribute, above. If the specified ASCII character is not in the Menu Label text, the designated ASCII character appears in parentheses after the expandable menu label.
  • Determines which combination of keyboard clicks launches this expandable menu label.

    To expand NNMi menus, you can click with the mouse or use Ctrl-Shift and the underlined character (if any). NNMi uses Ctrl-Shift (instead of Alt) to avoid the browser's main menu behavior. For example, NNMi provides Ctrl-Shift+H, then n for HelpNNMi Documentation Library. If the NNMi menu does not expand as expected, your browser configuration already over-rides the NNMi configuration for that keyboard combination of Ctrl-Shift+<ASCII character>.

If you accidentally create duplicate Accessibility Keys within the same block of menu items, only the first instance works.

To determine which ASCII characters are already in use, use the Configuration workspace, User Interface, Menu Items view and the table columns for Parent Menu and Accessibility Key to sort established entries.

Caution Do not change established Accessibility Keys for expandable menu labels provided by (associated with an author value that identifies an  product).

Unique Key

Used as a unique identifier when exporting and importing menu definitions. To ensure that the value you enter is unique, it is recommended that you use the Java name space convention when providing this value. It is also useful to include the Menu Label value as part of the unique key as shown in the following example:

com.<company_name>.nnm.menu.<menu_label>

Type a maximum of 80 characters. Alpha-numeric and period characters are permitted. No spaces are permitted.

Caution This value cannot be changed after you click the Save icon.

Author

Indicates who created or last modified the Menu nesting object.

If the Author attribute value is Network Node Manager, any changes are at risk of being overwritten in the future.

  • Click  Lookup and select  Show Analysis to display details about the currently selected Author.
  • Click  Quick Find to access the list of existing Author values.
  • Click  New to create an Author value.
Parent Menu

Refine the nested location of this expandable menu label.

Click the  Lookup icon next to the Parent Menu attribute, and do one of the following:

  • To select an existing parent-level expandable menu label from the drop-down list (nesting the new expandable menu structure at a lower level in the menu structure), click the  Quick Find icon.
  • To create a new parent-level expandable menu structure for nesting, click the  New icon.
Ordering

A numeric value. NNMi checks for configuration settings in the order you define (lowest number first). NNMi uses the first match found to determine the placement of this expandable menu structure within the menu you configured.

The Ordering numbers are calculated separately for each submenu group.

Tip It is recommended that ordering numbers are incremented by 10s to provide flexibility over time.

Prepend Separator

Based on the Ordering number, inserts a separator line above this expandable menu label.

Tip Use this attribute to separate unrelated menus.

Enabled

Use to temporarily disable a Menu configuration (this expandable menu structure does not appear when disabled):

Disable  = Temporarily disable the selected configuration.

Enable  = Enable the selected configuration.