Viewing Storage Object Performance Data in the Investigator › Alerts for Storage Conditions › Storage Engine Alerts › Create a Storage Engine GOA Script to Generate CA Chorus Alerts

Create a Storage Engine GOA Script to Generate CA Chorus Alerts

To receive alerts in the Alerts module for various storage conditions, storage engine GOA Scripts are required to send the alerts when conditions are met. Create the scripts for all objects that you want to monitor for alert conditions. The scripts must specify the storage engine line action Send Alert to Chorus, and the scripts must be scheduled to run as often as needed. Whenever the conditions specified in your scripts are met, the alert is sent to CA Chorus for Storage Management. These alerts appear in the Alerts module.

Use the storage engine windows client to create the scripts.

Note: For acquisition, requirements, and installation instructions, see the CA Vantage Installation Guide.

Follow these steps:

1. Open the storage engine windows client.

   Note: For storage engine windows client installation instructions, see the CA Vantage Installation Guide.

2. Connect to the back-end storage engine system host setup for CA Chorus for Storage Management.

   Note: For instructions about how to create a host connection definition and how to connect to a host, see the CA Vantage Windows Client Guide. This guide is available in the Knowledge Center.

3. Click z/OS, Object Scripting, Automation Scripts, General Object Automation.

   The Automation Scripts Builder opens.

   Note: You can click the Help button on any page of the wizard to get a description of the options on the page.

4. Click Next until the Source Object page is displayed. This page of the wizard displays the object tree.
5. Expand the object tree and locate the object that you want to create the alert script for.
6. Select the object and the data collection mode. Click the Help button in the builder to get a description of the modes available.
7. Click Next.

   The Script Name page opens.

8. Select Create a new script with this name, if it is not already selected and type in a script name up to eight characters long.
9. Click Next.

   The Title and System Execution page opens.

10. Fill in the page as needed. If you want the script to run on multiple systems, click the Systems button and specify them.
11. Click Next.

    The Timing for Events page opens. Use this page to specify the schedule for the alert script.

12. Click Next.

    The Options page opens.

13. Select the following options:
    • Load Script
    • Enable Script when Loaded
14. Click Next.

    The Event Procedure Section page opens.

15. Click Next.

    The Filter/Sort page opens.

16. Click Filter and create a filter to list only the items you want to create the alert for.
17. Click Next continuously until the Action Selection page opens.

    The Action Selection page opens.

18. Select the action Perform Object Action.

    The Perform Object Action page is available for selection in the navigation pane.

19. Click Next.

    The Perform Object Action page opens.

20. Select Send Chorus Alert in the Action pane.
21. Specify the Severity Type and Alert Text as follows:

    Severity Type

    The Severity Type is displayed in the alert which is displayed in CA Chorus. The Severity Types range from 1 to 5. Where 1 indicates the highest severity level and 5 indicates the lowest severity level.

    Click in the Severity Value of 1 to 5 field and type in a value of 1 to 5.

    Alert Text

    The text entered in the Alert Text field is displayed in the alert which is displayed in CA Chorus. Insert variables in the text to give the alert more clarity. To insert text and variables, perform the following steps:

    1. Click in the Alert Text field and type in the start of your alert message.
    2. Click in the field where you want to insert the variable, and click the Variables button.

       The variables available for the object are displayed in the Variables Substitution window.

    3. Double-click the variable that you want inserted.

       The variable is inserted accordingly.

       You can insert text and multiple variables by repeating these steps.

       Example: To create an alert indicating that critical space usage is reaching a maximum level of 80 percent, enter the following text in the Alert Text field:

       SG %%POOLNAME%% is now %%POOLUPCT%% percent filled. Action required.
       

       Where:

       - %%POOLNAME%% is the variable for the Storage Group Name field.

       - %%POOLUPCT%% is the variable for the %Allo field.

       - Everything else is text that you typed in the field.

       The resulting alert message would be shown as "SG storage_group_name is now percent_allocated percent filled. Action required." in the Alerts module.

    4. Close the Variables Substitution window.

22. Click Next.

    The Saving and Activation page opens with the Save and Activate the script option selected.

23. Click OK.

    The alert script for the object is created, saved, and activated.

    Note: Repeat this process to create a storage engine GOA Script for each object that you want to monitor for alert conditions.

24. Close the windows client after you have made all the alert scripts needed.

    The automation scripts are created and alerts are sent to the Alerts module according to the conditions specified.

    Note: You can reopen the windows client to create new scripts, change existing script settings, and delete scripts at any time.