Viewing Storage Object Performance Data in the Investigator › Perform Storage Actions on Object Data in the Investigator › View Storage Object Performance Data in the Time Series Facility › How to Collect Storage Metrics for TSF › Create a Storage Engine Log Script to Generate Storage Metrics for Time Series

Create a Storage Engine Log Script to Generate Storage Metrics for Time Series

To generate storage metrics for TSF, a storage administrator must create storage engine Log Script for the object. When the log script runs, the new metrics for that object are automatically sent to TSF. The storage administrator typically creates Log Scripts after the storage engine is configured.

Observe the following notes:

• The storage engine systems must be up and running to generate storage metrics for TSF. If they are not up and running, the metrics are not created and sent to the target CA Chorus systems.
• Use the storage engine windows client to create the scripts.

  Note: For storage engine windows client acquisition, requirements, and installation instructions, see the CA Vantage Installation Guide. This guides is available in the Knowledge Center.

• If your system installer performed the startup configuration steps for new CA Chorus and new CA Vantage customers by running the CHRSGMI job, then the storage engine log scripts are already created. For more information, see the CA Vantage Configuration Guide.

Follow these steps:

1. Open the storage engine windows client.

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

2. Connect to the back-end storage engine host that is set up 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.

3. Click z/OS, Object Scripting, Object Logging.

   The Log 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 page opens.

   The Source Object Selection page displays the object tree.

5. Expand the object tree and locate the object that you want to create the log script for.

   Note: Only certain storage objects are set up for TSF. For CA Chorus for Storage Management, you can make log scripts for only the following storage objects:

1. Select the object for which you want to create the log script.

   The object is highlighted.

2. Click Next.

   The Title and System Execution page opens.

3. Enter a title and optionally a description. If you want the script to run on multiple systems, click the Systems button and specify them.
4. Click Next.

   The Timing for Events page opens. Use this page to specify the schedule when the script is run.

   Note: For more information about log scripts and optimal configuration strategies, see the section Avoid CPU and memory Constraints in the CA Vantage Best Practices Guide. This guide is available in the Knowledge Center.

5. Click Next.

   The Options page opens.

6. Select the following options:
   • Load Script
   • Enable Script when Loaded
7. Click Next.

   The Event Procedure Section page opens.

8. Click Next.

   The Filter page opens.

9. (Optional) Click Filter to create a filter. Then click Define Filter to display the Filter dialog. Define a filter to list only the items you want to create the log for. Click Save to save the filter.

   The filter is created and the Filter dialog closes.

10. Click Next.

    The Log file Creation page opens.

    Use this page to specify:

    • How often a new log file is created (every time, every day, every week, every month, or only when the log is full).
    • Specify the maximum number of logs per file.
    • Specify if you want to log data, object count, or both.
    • Specify whether to use the data in one of the following scenarios:
      • Acquired during the last scanning interval. Select Base snapshot on last Interval.
      • Collect the data on demand before taking the snapshot of the object. Select Base snapshot on real-time data.

    Do not select Write to SMF.

11. Click Next.

    The Local Database properties page opens.

    Do not select Save in Local Database.

12. Click Next.

    The Saving and Activation page opens with the following options selected:

    • Execute the script every time it is activated.
    • Save and Activate the script.
13. Click OK.

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

    Note: Repeat this process to create a storage engine Log Script for each object you want to generate storage metrics for the TSF.

14. Close the windows client after you have made all the log scripts needed.

    The log scripts are created and collect data in the schedules specified.

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