How to: Issue customized commands on multiple nodes

Use the Command Center dashboard to issue customized commands in parallel on multiple nodes.

Procedure

  1. Log to the IBM Service Management Unite console.
  2. In the navigation bar, click Administration > Command Center to open the dashboard.
    In this dashboard,
    • The Nodes widget displays all the known z/OS nodes in your environment.
    • The Issue Commands on Multiple Nodes widget provides you the ability to issue sample commands (INGLIST and INGAMS) and also the ability to customize commands to issue on multiple nodes.
  3. To issue the provided sample command INGLIST or INGAMS on multiple nodes, you can simply select nodes and click the button Run INGLIST or Run INGAMS to issue the command.
    1. Select the nodes that you want to issue commands on from the Nodes widget, and you will find the nodes are listed under Selected node(s).
      • To select a specific node, click the node in the Nodes widget.
      • To remove a specific node from the Selected node(s), click x next to the node name.
      • To select all the z/OS nodes that are listed in the Nodes widget, click Select All.
      • To remove all the nodes from the Selected node(s), click Clear Selection.
    2. Click button Run INGLIST or Run INGAMS as needed. The command is sent to the selected nodes and the command output on each node is displayed.
  4. To customize commands to issue, you can modify the configuration file to create your own buttons based on your needs.
    Issue commands
    1. Log on to the Service Management Unite server.
    2. If you are using the Service Management Unite Docker container, run the command to open a Bash shell to access the internal of the container. If you are using the native installed Service Management Unite (not a Docker container), skip this step.
      eezdocker.sh shell
    3. Navigate to the directory where the configuration file sa-commands.json is located.
      cd /opt/IBM/JazzSM/profile/installedApps/JazzSMNode01Cell/isc.ear/EEZUIWebClient.war/smu-angular/assets/json/config
    4. Open and edit the configuration file sa-commands.json.
      vi sa-commands.json
      In the file, you can customize the commands to issue as needed. By default, two commands and their corresponding buttons are defined.
      {
        "docs":
        {
          "commands": [
            {
              "command": "INGLIST",
              "button": "Run INGLIST"
            },
            {
              "command": "INGAMS",
              "button": "Run INGAMS"
            }
          ]
        }
      }
      To add a new command, for example, DISPINFO <SUBSYSTEM>, and the visualized button Run DISPINFO, you need to add value DISPINFO <SUBSYSTEM> for key command and value Run DISPINFO for key button.
      Sample:
      {
        "docs":
        {
          "commands": [
            {
              "command": "INGLIST",
              "button": "Run INGLIST"
            },
            {
              "command": "INGAMS",
              "button": "Run INGAMS"
            },
            {
              "command": "DISPINFO <SUBSYSTEM>",
              "button": "Run DISPINFO"
            }
          ]
        }
      }
    5. Type :wq! to save your changes and exit the file.
    6. Clear the cache of your browser. For example,
      clear cache
    7. Reload the IBM Service Management Unite console.
      After your refresh the page, a new button Run DISPINFO that you just defined is displayed. You can select nodes and click the button to issue the command.
      customize commands