Introduction › How to Free Up Storage Space by Executing An Automation Script › Create a GOA Script That Sends Alerts

Create a GOA Script That Sends 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.

Use this procedure to create a GOA script that sends CA Chorus for Storage Management an alert when critical storage group space usage reaches the maximum capacity level.

Follow these steps:

1. Open the storage engine windows client by double-clicking its icon on your PC.
2. Connect to the storage engine system host that is set up for CA Chorus for Storage Management.
3. Click z/OS, Object Scripting, Automation Scripts, General Object Automation in the windows client main menu.

   The Automation Scripts Builder opens.

   Note: 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 Selection wizard page opens.
5. Select the Space and Other Attributes object in the Storage Groups folder and click Next to open the Script Name page.
6. Select Create a script with this name:, enter SGALERT in the Script Name: field, and click Next to open the Title and System Execution page.
7. Enter Monitor SG in the Title field, enter Monitor Storage Groups for Alert Threshold of 80 percent in the Description field, and click Next to open the Timing for Events page.
8. Select Daily Cycles, specify 120 minutes, and click Next to open the Options page.
9. Select the following options:
   • Load Script
   • Enable Script when Loaded (for 24 hour scripts only).
   • Use the value of the STMONSCR system parameter to control if the script should be monitored with the Internal Status Monitor.
10. Click Next repeatedly until the Filter/Sort page opens.
11. Click the Filter button and create a filter with the following filter statement in the Filter dialog:

    "% Allo" >= 80 
    

    This filters storage groups that have an allocated percentage of 80 or higher of the space available.

12. Click Apply and Exit to save the filter and close Filter dialog.
13. Click Next to open the Record Selection page.
14. Select the option Select filtered records and click Next repeatedly until the Record Inclusion page opens.
15. Select the option Select All Records and click Next to open the Conditions for Actions page.
16. Select Equal to, enter 1 in the number of records field, and click Next to open the Action Selection page.
17. Select the option Perform Object Action and click Next to open the Perform Object Action page.
18. Select Send Chorus Alert and enter the following:
    • Enter 1 in the Severity Value of 1 to 5 field.

      Note: A severity value 1 is the highest severity.

    • Click in the Alert Text field and do the following:
      1. Type SG and then space.
      2. Click the Variables button and double-click Storage Group Name from the Substitution Variables window.
      3. Click after %%POOLNAME%% in the text field, and add a space.
      4. Type "is now " (with a space after the word now).
      5. Double-click the Pct Allocated variable in the Substitution Variables window.
      6. Click after %%POOLUPCT%% in the text field, add a space, and type "pct filled. Action required!".

         The Alert Text field contains the following text:

         SG %%POOLNAME%% is now %%POOLUPCT%% pct filled. Action required!
         

         This alert message displays as follows in the Alerts Module:

         SG storage_group_name is now percent_value pct filled. Action required!

19. Click Next to open the Saving and Activation page, select the Save, Activate and Execute the Script option, and click OK.

    Note: To receive an earlier warning alert that a storage group is reaching 70 percent of its capacity level, consider making another GOA script. This script would be similar, but with a filter with the following expression: "% Allo" > 70 AND "% Allo" < 80. Give this a Severity 2 condition with the message: "Warning! SG %%POOLNAME%% is now %%POOLUPCT%% pct filled."

20. Close the storage engine windows client.

    You have created a GOA script that sends CA Chorus for Storage Management an alert when critical storage group space usage reaches 80 percent or higher of the maximum capacity level.