iimRunner

From iMacros

(Related example macros: connect-to-iimrunner.vbs)

iimRunner.exe is a tool that helps you to start the iMacros, iMacros for Internet Explorer or iMacros for Firefox under a specific user account. You find it in the iMacros home directory, typically c:\Program Files\iMacros

iimRunner Screenshot

The tool displays three values:

Account: The user account under which it is running. iMacros will start under this account if iimInit ("-runner") is used.

Created processes count: Counts how many instances of imacros.exe were started via iimRunner.exe. This count always increases, it does not show the actual number of running processes. This value is mainly useful for debugging.

Running iMacros count: Shows the number of running iMacros Browser instances (regardless if they were started manually or by iimRunner!).

iimRunner uses a small XML file called iimrunner.xml to store its settings:

 <?xml version="1.0" encoding="utf-8"?>
 <configuration>
   <appSettings>
       <add key='MaxNumberOfInstances' value='50'/>
       <add key='LogName' value='d:\1tmp\runner.txt'/>
       <add key='LogLevel' value='INFO'/>
     </appSettings>
 </configuration>

MaxNumberOfInstances: Maximum number of allowed iMacros Browser instances (as counted by the "Running iMacros count" value in the iimRunner window.)

LogName: iimRunner log file name and path. No file name disables logging.

LogLevel: INFO, ERROR (log only errors)

Among other information, the iimRunner log file displays the Windows Logon Type.

Important: The tool expects the iimRunner.xml settings file in the same directory as iimRunner.exe.

Note: Running iimRunner via a scheduled task allows it to run silently, and if iimRunner runs silently (different user account or windows sessions) the iMacros instances it starts run silently as well.

More Information:

• Tips for using iimRunner
• Windows Logon Types - Overview
• How to run iMacros unattended
• How to use iimRunner from a batch file: Instead of starting imacros.exe directly, start a small VBS script that starts iMacros.exe via iimInit ("-runner").
• Use RunAs to test iimRunner
• Case Study: AlertFox - Award-winning web transaction monitoring service.