Managing Sessions Using CA Automation Point Windows › Customizing Menus › Adding New Menu Options to Existing Submenus

Adding New Menu Options to Existing Submenus

When you select a submenu from the menu bar in a CA Automation Point function or session window, a drop down list of menu options appear. If you wish to add a menu option to an existing submenu, you'll first need to reference existing names for menus and submenus before adding customized menu options. Follow these steps to customize.

1. Identify the MenuName specified for the function or session window you wish to customize. To determine the name of the menu used for a desktop window, go to Configuration Manager's, Session Definition Sets dialog and open the selected session or function window definition. See Window Attributes, menu edit box.

   Note: If the menu setting is set to default, the actual name of the menu will follow these naming conventions:

   • Default menus for function windows will have the same name as the function window type setting. For example, the Merged Msg window has a function window type of MERGEDMSG. Therefore, the default menu name for the Merged Msg window is MERGEDMSG.
   • The default menu name for 3270 session windows with default terminal emulation specified is 'session_3278'.
   • The default menu name for asynchronous session windows with default terminal emulation specified is 'session_asynch'.
   • The default menu name for session windows with a non-default terminal emulation specified is 'session_' followed by the terminal emulation specified for the session.
   • The default menu name for a session window with terminal emulation of 3278 models 2-5 is 'session_3278'. Similarly, the menu name for a session window with terminal emulation of 3279 models 2-5 is 'session_3279'. For example, if the terminal setting for a 3270 session is 3279_4, then the name of the default menu associated with this session is 'session_3279'.
2. Identify the SubmenuName for the submenu to which you wish to add a menu option. Search axc2p.mnu and user.mnu files for all MENU statements whose name is MenuName as determined in step 1. This should return submenu names for each item on the menu bar. For each submenu name on the MENU statements, search axc2p.mnu and user.mnu files for the SUBMENU statement that defines the external submenu name or submenu title for the submenu you wish to customize.
3. Add a SUBMENU statement to the user.mnu file. Specify the SUBMENU statement with your customized ITEM settings using the SubmenuName and SubmenuTitle identified in step 2. Edit user.mnu file to include the new SUBMENU statement and save.

   Note: Submenus many be defined in more than one menu. If you add a menu option to an existing submenu, the menu option will appear in every desktop window that uses a menu defined with that submenu name. If this is not the desired result, you may wish to create a new submenu with the customized menu options and include that submenu on menus of your choice. For more information, see the section Adding New Submenus to Existing Menus.

   Example: The following SUBMENU statement included in the user.mnu file will add three more menu options to the Cmdarea submenu in the Merged Msg window.

   SUBMENU  =  cmdbox, 
      ITEM  =  ( '~Fast background updates',   XCCMD('SESSCNTL BWUPDATE(1)')),
      ITEM  =  ( 'Normal ~background updates', XCCMD('SESSCNTL BWUPDATE(5)')),
      ITEM  =  ( '~Slow background updates',   XCCMD('SESSCNTL BWUPDATE(9)'))