Managing Execution Plans

An Execution Plan is a wrapper for a script. Through an Execution Plan, you specify the configuration for the script (including custom attributes), Agent Groups on which the script runs, run schedules, and blackout periods.

This topic contains the following procedures:

• • Before you begin
  • To view the list of defined Execution Plans
  • To define an Execution Plan
  • To delete a defined Execution Plan
  • Related topics

Before you begin

• Define Business Services before defining Execution Plans. Every new Execution Plan inherits the following settings from the associated Business Service:

  • Execution Plan run frequency
  • Execution Plan timeout period
  • Agent Groups
  • Blackout settings

  You can modify these settings for individual Execution Plans.

• Upload custom scripts.

To view the list of defined Execution Plans

1. On the BMC Application Performance Management Console, click the Synthetic tab.
2. On the navigation menu, click Execution Plans.
   A list of defined Execution Plans is displayed.
3. To modify the display, you can perform any of the following actions:
   
   • To sort the list based on a specific column, click the relevant column heading.
   • To sort in reverse order, click the column heading again.
4. To filter the list, start typing a value in any of the boxes under the column headings.

To define an Execution Plan

Modifications to an Execution Plan modify and override the inherited settings from the associated Business Service.

1. On the BMC Application Performance Management Console, click the Synthetic tab.
2. On the navigation menu, click Execution Plans.
3. Perform one of the following actions:
   • To define a new Execution Plan, on the Execution Plans Action menu, click Add Execution Plan.
   • To edit a previously defined Execution Plan, from the shortcut menu of the specific Execution Plan, select Edit Execution Plan.

4. In the General Execution Plan Settings panel, configure the following settings:

   • To change the the Execution Plan Status, select Activate or Deactivate.
     The status of the Execution Plan determines whether the script runs. The Execution Plan is also affected by the status of the Business Service.
   • Enter a unique name for the Execution Plan and (optionally) a description for the Execution Plan.

   • Select the Business Service with which to associate the Execution Plan.
     Default values, inherited from the Business Service, are populated for Execution Settings and Blackout Settings.
5. For a new Execution Plan: In the Execution Plan Script panel, select the script file that this Execution Plan controls.
   You cannot change the script association when you edit an Execution Plan.
6. Depending on the selected script, set values for the script attributes that require user input, such as URLs, host names, and passwords.
7. In the Execution Settings panel, the following parameters are set by the Business Service. You can override the settings:
   
   • Run Frequency. Enter how often the Execution Plans runs the script. The default frequency is every 5 minutes.
   • Timeout Period. Enter how long to wait for a script to finish running before timing out. The default timeout period is 15 minutes.
     If the script times out, the event is recorded in the TEA Agent log. The script runs again at the next scheduled interval.
   • Agent Groups. Select the Agent Groups on which the Execution Plan's script runs.
8. In the Blackout Settings panel, the parameters are set by the Business Service. You can modify the settings to extend blackout periods:
   
   • To set a weekly blackout period, select Repeat on and select one or more days.
     Click the Start Time and End Time boxes and set the time of day the blackout occurs. Click the Current Browser Time button to set your current browser time.
   • To set a single blackout occurrence, click the Start Time and End Time boxes. Set a specific date and time for the blackout to take place. Click the Current Browser Time button to set your current browser date and time.
   During a blackout period, monitoring and notifications are disabled.
   An Execution Plan inherits the active and inactive status from the associated Business Service, including the blackout periods. You can extend blackout periods for an individual Execution Plan by time or day, but you cannot shorten the blackout period as defined by the Business Service.
9. Click Save.

Initial configuration operations might take several minutes, depending on the heartbeat interval of the BMC TEA Agent (30 seconds, by default) and the amount of time to download the scripts to the Agent computer.

To delete a defined Execution Plan

1. On the BMC Application Performance Management Console, click the Synthetic tab.
2. On the navigation menu, click Execution Plans.
3. From the shortcut menu of the specific Execution Plan, select Delete Execution Plan.
4. Click OK in the confirmation message.

Related topics

Status-of-Business-Service-and-Execution-Plan
Examining-Execution-Plan-files