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
Error and Return Codes
iMacros V7 Error Codes
iMacros displays an error message if it encounters an error and stops the current macro run (unless SET !ERRORIGNORE YES is used).
The general rule is:
- Success return code greater 0 (Currently there is only one success code: 1)
- Failure return code less then 0
Notes:
- The code is send via the Scripting Interface or command line interface. You can use this return code to find out whether a macro succeeded or not.
- With iimGetLastError() the text of an error message can be retrieved via the Scripting Interface.
- These error codes should not be confused with the Scripting Interface Return Codes which are codes between -1 and -100.
User interaction
* Aborted = -101,
User pressed Stop button in the iMacros Browser. Typically, you can check on this value to see if the user wants to exit the application.
* BrowserClosed = -102,
User pressed Exit button in the iMacros Browser, i.e. the iMacros Browser was closed by a user.
Macro Playback
* Unspecified = -1000, Macro playback returned an error without explicitly specifying error code
* NotInPlaybackMode = -1010, Error occurred while macro playback is not active (recording or idle mode) * LoadFailed = -1100,
Failed to load the macro (syntax or I/O error) [Found wrong macro command while loading file]
* InvalidMacroName = -1110
Invalid macro name specified for playback [Command Line Error: No Macro found]
* BadParameter = -1200,
Invalid macro parameter was specified
* CannotCompileRegex = -1210,
Cannot compile regular expression (as in SEARCH)
* WrongDecryptionPassword = -1220,
Incorrect decryption password supplied. Please enter the correct password in the OPTIONS dialog or re-run the macro.
* FileNotFound = -1230,
Filename specified in the macro command (e.g. IMAGESEARCH) doesn't exist
* InvalidRecordIndex = -1240, The data source record with requested index does not exist
* HtmlElementNotFound = -1300,
Cannot find HTML element
* NonExpectedTagFound = -1310,
HTML element was found when EVENT:FAIL_IF_FOUND was specified
* SearchQueryNotFound = -1320,
Search query not found in source
* DialogManagerError = -1400,
Indicates that exception has occurred in Dialog Manager
* DownloadFailed = -1410,
Failed to download file to specified path.
* ChecksumNotVerified = -1420,
Checksum of downloaded file does not match specified
* UnsupportedVersion = -1500,
This macro was created with an older version of iMacros. Or the feature is not licensed in this product.
* InvalidStopwatchId = -1600,
Invalid Stopwatch ID or LABEL specified, duplicate or inexistent.
* StopwatchAlreadyRunning = -1610,
Stopwatch with this ID or label is already running.
* StopwatchNotStarted = -1620,
Cannot stop stopwatch before it's started.
* InvalidSelectContent = -1700,
Selected entry in a select box is not available
* InvalidCheckRadioContent = -1710,
Invalid CONTENT parameter specified for check or radio box
* ImageNotFound = -1800,
Could not find image with given confidence in browser screen
* ImageRecognitionInternalError = -1810,
Internal Error in Image Recognition Plugin (Is it properly installed?)
* CannotLoadImage = -1820,
Image file could not be loaded.
* DocumentNull = -1900,
Failed to run a command because no page has been opened in the web browser or could not retrieve the page source (document is null)
* InvalidTargetWindow = -1910,
Cannot locate target web browser window or frame
* SetProxyError = -2000, Unable to set proxy server settings
iMacros V6 Error Codes
Installation
Errors that can occur during setup or if an installation is corrupted.
Code | Reason |
---|---|
-110 | Command Line Error: No Macro! |
-102 | Dialog Manager not started |
-103 | Dialog Manager not stopped |
-167 | Browser timeout issue* |
-184 | Error: Wrong value for !EXTRACT_TEST_POPUP |
-187 | Error: Wrong value for !ENCRYPTION |
-189 | Error: Wrong value for !POINTER |
Recording
Errors that can occur during macro recording.
Code | Reason |
---|---|
-200 | Tab X does not exist |
-201 | Please use the mouse to select the next recording position |
-201b | Error while reading this line: [x] |
-203 | Found wrong macro command while loading file: [x] |
-251 | Selected entry not available: x. Disable this message with SET !ERRORIGNORE YES |
-255 | Downloader can not intercept this download during RECORDING. Replay mode might work |
-256 | Downloader can not intercept this download. Try the SAVE AS feature. |
-260 | Error: EXTRACT needs Internet Explorer 6.0 or better to work correctly. |
-261 | Error: Invalid !LOOP value: [x] |
-282 | Incorrect decryption password supplied. Please enter the correct password in the OPTIONS dialog or re-run the macro. |
-283 | Incorrect decryption password supplied. Please enter the correct password in the OPTIONS dialog or re-run the macro. |
Replay
Errors that can occur during macro replay.
Code | Reason |
---|---|
-301 | Error in Line x (TAG command not found in web page) |
-301b | Datasource [x] not found |
-302 | Frame not found F=[x] |
-302b | Element empty - Web page problem in Line [x] |
-302c | Variable [x] not defined. It is not an internal variable and no external datasource was defined |
-303 | Variable [x]: Please specify the number of columns in the CSV file |
-304 | Frame parameter not a number |
-304b | Error reading datasource: Line [x] |
-305 | Datasource not found. |
-306 | Unrecognized command, please contact support. |
-310 | This macro was created with an older version of iMacros. |
-311 | WAIT Parameter must be the time in seconds |
-314 | Macro too large for the non-commercial IE Edition: Macro truncated. |
-318 | Datasource end of file (see related forum post) |
-322 | Error: Website did not respond (Timeout) |
-329 | Error: POS Parameter not numeric: [x] |
-331 | Page Error, and CONTINUE=NO |
-332 | Security dialog appeared and STOP=YES |
-335 | SaveItem Timeout: Could not download item from |
-336 | No URL for SAVETARGETAS found. |
-340 | URL contains unsupported characters. Typically " ", as in "file:///D:/a b/t.htm" => Replace " " with "%20": "file:///D:/a%20b/t.htm" |
-342 | Scripting Interface: Communication Error |
-345 | EXTRACT ELEM value to high (legacy) |
-349 | Selected entry in a select box is not available |
-350 | Stopwatch Parameter incorrect |
-350 | Could not find macro |
-351 | SAVEAS Type incorrect |
-351a | Image Recognition Plugin not installed. |
-351b | SAVEAS TYPE=BMP supports only screenshots from the the first tab. |
-352 | IMAGESEARCH and IMAGECLICK commands require the Image Recognition Plugin. |
-352a | Plus symbol (+) not supported with SAVEAS TYPE=EXTRACT: [x] |
-352b | Please use the iMacros Browser for taking web page screenshots. SAVEAS TYPE=BMP is not supported in the IE-Plugin. |
-355 | Timeout during download. You can increase the timeout value in the OPTIONS dialog or with SET !TIMEOUT" |
-356 | ONDIALOG: Wrong value for BUTTON |
-356a | ONSECURITY: Wrong value: BUTTON |
-356b | ONERROR: Wrong value: BUTTON |
-357 | Wrong certificate value: [x] |
-359 | Wrong value for ONPRINT BUTTON=<x> |
-361 | WINCLICK: X coordinate not a number: [x] |
-362 | WINCLICK: Y coordinate not a number: [x] |
-370 | Internal Error during encryption |
-373 | In the TRIAL VERSION the DATASOURCE Number of Columns is limited to 10 |
-379 | Unknown DirectScreen command. List of allowed DS commands |
-381 | Could not find image in browser screen |
-381a | Error: Invalid !LOOP value: [x] |
-382 | Could not find INPUT IMAGE, location = [x] |
-382a | Could not find Image Search Plugin (imimage.dll) |
-382b | Could not find Image Search Plugin (imimage.dll) |
-382c | Error: Invalid DATASOURCE_LINE value: [x] |
-382d | Error: Wrong value for !HTMLPOPUIGNOREIGNORE |
-383 | Error: Invalid VARSETALL value: [x] |
-383a | Error: DATASOURCE Number of Columns too high (max. value is 30). |
-383b | Error: Invalid timeout value: [x] |
-384 | Error: Invalid replay speed value: [x] |
-384b | Error: EXTRACTADD value: [x] |
-384 | Error: Invalid DATASOURCE Number of Columns value: [x] |
-384a | Error: Wrong value for !EXTRACTDIALOG |
-384b | Only !VAR1, !VAR2 and !VAR3 can be used with SET. |
-385 | Error: EXTRACT value: [x] |
-385a | Error: Wrong value for !ERRORIGNORE |
-388 | Error: Wrong value for !DIALOGMANAGER |
-390 | Error: Wrong value for !CHECKING |
-393 | Error: SET Parameter not recognized: [x] |
-394 | Error: ADD Parameter not recognized: [x] |
Internet Explorer
Errors specific for the IE Add-on.
Code | Reason |
---|---|
-401 | The IE Plugin supports only one new window (TAB T=2) |
-402 | TAB command syntax error |
Command Line Interface
Errors when calling iMacros via the command line or Scripting Interface. This error code should not be confused with the Scripting Interface Return Codes, which are codes between -1 and -100.
Code | Reason |
---|---|
-522 | Command Line Error: No Macro found |
Firefox
Errors specific for the Firefox Add-on.
Code | Reason |
---|---|
-808 | Unrecognized command (e. g. DS) |
Scripting Interface Return Codes
After each command the Scripting Interface returns a code. You can use this return code to find out whether a command succeeded or not. The general rule is:
- Success return code greater equal 0
- Failure return code less than 0
Notes:
- You can use iimGetLastError() to retrieve the text associated with the last error.
- 1 (sOk)
- Macro completed Ok
- -1 (sFail)
- Scripting Interface can not complete this command. Typically this error can occur if the software is not installed correctly
- -2 (sNotCompleted)
- A command was started but did not complete. This error happens only if the browser is terminated so abruptly that iMacros can not respond back to the interface. Typically this happens only in the rare case of a browser crash. If the user simply closes the browser you will get the -102 error instead (see below).
- -3 (sTimeout)
- The iMacros browser did not respond in a certain time. The default timeout is 600s. You can change this value individually for some commands. For example, you can specify iimPlay(<macro>, <timeout>). In addition to a normal timeout, this error also occurs if the browser freezes for any reason. (In the trial version this error can also occur if you do not press the iMacros trial version reminder screen "Continue" button in time. This issue can never occur in the full version.)
- -4 (sNotStarted)
- Could not start the iMacros browser. Typically this indicates an installation issue.
- -6
- iimRunner error message, see iimInit return values for details
- -7
- iimRunner error message, see iimInit return values for details
- -20
- This error occurs if you start iimInit() twice.
- -100...-999 (sMacroError)
- sMacroError can have a value of -100 and lower (-101,-102,...,-999). These are NOT Scripting Interface error codes, but errors created by the iMacros browser and the macro itself. The Scripting Interface passes them from the browser to your script or application.
- -101
- User pressed Stop button in the iMacros Browser. Typically, you can check on this value to see if the user wants to exit the application.
- -102
- User pressed Exit button in the iMacros Browser, i.e. the iMacros Browser was closed by a user. Note that this is not the same as sNotComplete. The code "sNotComplete"(-2) indicates that he browser was closed e.g. by the task scheduler or a crasg and not by a regular user exit or stop.
Error codes below -200 are error codes generated during the macro replay. These are the same errors (or error codes) that you get during a manual macro replay (if you start the macro by clicking the "Play" button). For more information on these errors please see the List of iMacros Browser Error Codes.