The renewal maintenance has officially ended for Progress iMacros effective November 30, 2023.
This Wiki site will also no longer be moderated from the Progress side.
Thank you again for your business and support.
Sincerely, The Progress Team
Difference between revisions of "iimRunner"
(→GUI) |
|||
Line 15: | Line 15: | ||
'''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. | '''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!). | + | '''Running iMacros count:''' Shows the number of running iMacros Browser instances (regardless if they were started manually or by iimRunner!). |
− | + | ||
+ | You can (indirectly) query the number for running iMacros instances from your code: | ||
+ | |||
+ | 1. Set the limit you need in the logfile (see below) | ||
+ | |||
+ | 2. iimRunner will not start more instances, instead, when the limit is reach, [[iimInit]] will return the -7 error code. | ||
+ | |||
== Settings == | == Settings == | ||
Revision as of 20:33, 7 January 2011
(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 must be (auto-)started directly within the user account under which you want iMacros run. The best method is to use a shortcut in the user's startup folder. iimRunner must not run as a service, and we do not recommend to start it as a scheduled task (as application that are started via task scheduler have no full desktop access, and web browsers need the desktop).
GUI
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!).
You can (indirectly) query the number for running iMacros instances from your code:
1. Set the limit you need in the logfile (see below)
2. iimRunner will not start more instances, instead, when the limit is reach, iimInit will return the -7 error code.
Settings
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)
Log
The log file is enabled by default with the iimrunner.xml file.
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.
See Also
- 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.