Creating a complex remote multisystem script file action

You can use the Menu Manager to create complex remote multisystem script file actions to add to pop-up menus.

To create a complex remote multisystem script file action, complete the following steps:

1. Click Window (on Windows) or IBM® Developer for z/OS® (on macOS) > Preferences.
   The Preferences window opens.
2. In the Preferences window, double-click Menu Manager, and select Actions and Menus.
   The Actions and Menus preference window opens.
3. In the Actions and Menus window, complete the following steps:
   1. Do one of the following steps:
      • From the File Selection list, select the file that you want to create the action in.
      • To create a file for the action, click New.
      • To import a file for the action, click Import.

      Remember: You can create the action only in a file that contains action and menu definitions that apply to projects and subprojects. The icon beside the File Selection list indicates whether the file contains action and menu definitions that apply to projects and subprojects, to data sets, or to files.
   2. On the Actions page of the Actions and Menus notebook, click New Complex Remote Action.
      The Menu Manager New Complex Action Wizard opens.
4. On the wizard's New Complex Action Page page, complete the following steps:
   1. In the Name field, type the name that you want to be displayed for the action in the pop-up menu.
   2. Optional: In the Comment field, type a short description that you want to be displayed as tooltip text when you hover over this action in the pop-up menu.
   3. In the Context drop-down list, select the context in which this action is visible.
      For example, if you choose z/OS UNIX Subprojects, this action shows up only on z/OS UNIX System Services files.
      Note: Depending on the context that is chosen, properties that are available on subsequent panels of the New Action wizard might be different.
   4. Click Next to proceed to the wizard's Action Type Page page.
5. On the wizard's Action Type Page page, complete the following steps:
   1. In the Select the type of complex action to create section, select Multi System Script.
   2. Optional: In the Action Properties section to display the action on the generic menu, select Show on generic menu.
      Note: If you do not select Show on generic menu, you must add the action to a menu and attach that menu to one or more resources. The action is displayed in the custom portion of the pop-up menu.
   3. Optional: To clear the Console view before you run this file action, select the Clear console before running check box.
      By default, messages that are generated when an action runs are appended to existing messages that are displayed in the Console view.
   4. Optional: To run a user exit program locally before you run a remote command:
      1. Select the User Exit check box.
      2. Type the path of the file that contains the program, or to browse for the location of the file, click Browse.

      A user exit program can verify the contents of the remote command script and apply any required changes before the command runs on a remote system.
   5. In the Available File Types panel to select the file types to associate with this file action, do one of the following steps:
      • To select all the listed file types, click Add All.
      • Select the file type that you want to associate with the file action and click Add.
      • To select all files that contain a file-name extension, select *.* and click Add.

      Tip: The complex remote multisystem script file action that you create is displayed on the pop-up menu only if each of the selected files corresponds to an associated file type specified in the Available File Types panel.
   6. Optional: To add a file type to the list of available file types:
      1. Click File Types. The File Type Manager window opens.
      2. In the Existing Types panel, click Add. The New File Type Information dialog box opens.
      3. In the Enter File Extension field, type the file-name extension for the file type that you want to add to the list, and then click OK.
      4. Click Finish.
   7. Optional: To remove a file type from the list of available file types:
      1. Click File Types. The File Type Manager window opens.
      2. In the Existing Types section, select a file type, and click Remove,
      3. Click Finish.
   8. To proceed to the Action Configuration Page page, click Next. The table on this page stores the list of available simple actions that run as part of the multisystem script.
6. On the Action Configuration Page page, click Add to open the Action Configuration dialog box and complete the following steps:
   1. From the Select Remote Action list, select the remote file action that you want to run.
   2. In the Host Name field, type the name of the remote host on which the action is run.
   3. In the Path field, type the path that is used as the current working directory for the command that is being run.
   4. In the User Name field, type the user name that is used to connect to the remote host.
   5. Click OK.
7. To proceed to the Add Actions to Menus page, click Next.
8. On the wizard's Add Actions To Menus page, complete the following steps:
   1. Select the Add to menus radio button, and then select the check box for each menu that you want to add the action to.
   2. To change your selections, select or clear check boxes or click Select All or Deselect All.
   3. To create the action and add it to the selected file, click Finish.