Examining and retaining Execution Plan results files

You can view Execution Plan file, such as scripts and results, on the computer with the BMC Synthetic Transaction Execution Adapter (TEA) Agent.

To locate Execution Plan files on the TEA Agent computer

1. In the BMC Application Management Console, click the Synthetic tab, and then select Execution Plans from the menu.
2. Hover over the name of an Execution Plan to see its ID number in a tooltip.
3. On the computer with a TEA Agent that is associated with that Execution Plan, navigate to the following directory: installationDirectory\WorkingFolder\ExecutionPlans.
   A list of folders, numbered according to Execution Plan IDs, is displayed.

Each Execution Plan folder contains a directory of the Execution Plan files. The Archive folder contains a secure ZIP file with the results of each execution of the script. To view files in the Archive folder, you must enter the archive password that you specified during Agent installation.

The startup transaction, typically called TINIT, also has a folder under the transaction results of the archive. The TINIT transaction runs only when the script is initialized, such as when it runs for the first time, or the first time it runs after a blackout period or after the TEA Agent times out.

Execution log file retention

The execution log archive files are maintained, aged, and deleted automatically by the TEA Agent:

• For an active TEA Agent, the last 15 results files are saved. When the sixteenth file is saved, the oldest results file is deleted.
• For an inactive TEA Agent, the results files are deleted hourly. The following list provides examples when TEA Agent can becomes inactive:
  
  • Load balancing forces the Execution Plan to run on a different agent.
  • Deleting an Execution Plan from the Console.
  • Blackout period

To change the number of saved execution log files

By default, up to 15 execution log files are saved for an active TEA Agent.

1. Log on to the TEA Agent computer as a user with administrator privileges.
2. In a text editor, open the agent_configuration.xml file, located in the installationDirectory\WorkingFolder\Conf directory.
   The default installation directory is C:\Program Files (x86)\BMC Software\BMCTEAAgent. 
3. Change the value of the <ArchiveRollingMax> element.
4. Save the file and restart the TEA Agent service.

Related topic

Defining-an-Execution-Plan-to-run-a-script