Page tree
Skip to end of metadata
Go to start of metadata

After you install the BMC Synthetic Transaction Execution Adapter (TEA) Agent, it automatically starts as a service on the agent computer, but you can also run the agent as process. You can run the TEA Agent as a process to support applications and technologies that require processes, such as for browser-driven scripts.

Before you begin

Before you run the TEA Agent as a process, ensure that the service is not running. You can stop the service in the APM Console, or through the operating system tools.

Log on to the TEA Agent computer as a user with administrator privileges.

To start the synthetic TEA Agent as a process

  1. On the TEA Agent computer, navigate to the installationDirectory\TEAAgent directory, for example, C:\Program Files (x86)\BMC Software\BMCTEAAgent\TEAAgent directory.
  2. Right-click the start_agent.bat file, and select Run as administrator.

A command prompt opens and displays the status of the TEA Agent.

To stop the synthetic TEA Agent process

You can stop the TEA Agent process from the computer with the TEA Agent, or you can stop the process from the APM Console, as described in the following procedure.

To stop a TEA Agent from the Console

  1. In the Console, click the Synthetic tab, then click TEA Agents.
  2. (Optional) From the Status column, select Active.
  3. From the shortcut menu of the active agent that you want to stop, select Stop TEA Agent.
  4. Click OK to confirm that you want to stop the agent.

Related topics

Stopping and deleting a synthetic TEA Agent

Uninstalling the TEA Agent



  1. Is there a way to stop a TEA Agent running as a process with a command such as taskkill? Or a batch script command? There appears to be an executable in the TEA Agent directory called SendSignalCtrlC.exe , but there is no documentation on how it functions. If I have multiple TEA Agents installed on a single host, will SendSignalCtrlC.exe attempt to end each one?

  2. In order to shutdown the agent gracefully when running as a process either:

    • use the  SendSignalCtrlC.exe utility as follows ==> SendSignalCtrlC.exe <TEA Agent pid>.  
    • press Ctrl+C on the agent command line console 

    Console output 

    BMC Transaction Execution Adapter Agent (SP 7704)(OpenSSL 1.0.2h 3 May 2016), PID 6828
    Stopping TEA Agent...
    TEA Agent stopped.
    Terminate batch job (Y/N)?

    The TEA Agent log:

    TEA Agent stopped. Agent version (SP 7704)(OpenSSL 1.0.2h 3 May 2016), PID 6828
    Shutting down project manager.
    Destroying controller for [EPID=165], [Ltc=141852056]
    Closing Execution Log queue.
    ManageExecutionLogQueue: Calling by Execution Log Queue thread
    Execution Log queue has been closed.
    Closing Result queue.
    SendTransactionResults: Calling results thread
    Results queue has been closed.

    Note: in case there are many Execution Plans assigned to the agent, the shutdown process may take a while and you'll see log entry such "Destroying controller for [EPID=165], [Ltc=141852056] " for each Execution Plan.

  3. Thank you Dan. I'm hoping to automate Process Agent shutdown and startup with BMC's Control-M software. Do you know of a way to extract the PID of a running TEA Agent from the agent.log file? Or perhaps it's recorded elsewhere in a more portable format?