Documentation for e2e_appmon (Nimrecorder) return codes
Article ID: 34409
Updated On:
Products
Issue/Introduction
Guide for customers when using e2e_appmon transaction scripts and they return error codes from the script execution.
Environment
- Release: UIM 20.4, 23.4 or higher
- Probe: e2e_appmon, any version
- Component: UIME2E
- e2e_appmon probe GA version, 3.01 or higher
- MS Edge Browser supported as of e2e_appmon v3.01
- Nimrecorder version 7.2.65
Cause
- Guidance
- Troubleshooting
Resolution
Return value
Ret, numeric return code. When the browser has been started correctly and the page could be loaded within 30 seconds (this default value can be changed using #ActionTimeout), the function returns 0. Otherwise use this return code for Error Handling. The return code is -3 if <browser_type> is incorrect.
In the e2e_appmon Status window, a return code of 0 indicates the script has run succesfully.
***The return code is -2146697211 if an HTTP error prevents the specified page to load.***
Error codes for Web functions
The table below lists the possible error codes for the NimRecorder Web functions, for the errors stopping script execution (unless #IgnoreErrors=1).
| -2146697211 | An HTTP error prevents the specified page to load |
| -404,-405 | Usual HTTP error codes |
| -14 | Invalid character for WriteHTML - use instead WriteHTMLPaste function |
| -12 | Download timeout |
| -11 | Internal error |
| -8 | HTML Element not found |
| -7 | Index too big |
| -5 | Page has not finished to load within the timeout |
| -4 | Browser lost |
| -3 | Bad HTML descriptor |
| -3 | Browser not recognized (Only for StartBrowser function when its first parameter is different from "IE") |
| -2 | Page not found |
| -1 | Impossible to capture or invalid range (Capture Web functions) |
| -1 | No browser in use (no UsePage or StartBrowser before) |
| -1 | Extraction cannot be done (ExtractLink function) |
Error codes for File management functions
The table below lists the possible error codes for the NimRecorder File management functions, for the errors stopping script execution (unless #IgnoreErrors=1).
| -2 | Index too big when running NimRecorder Excel functions (the array is smaller than the number of cells) |
| -1 | ColeDispatch Exception : Error returned by Excel when an invalid operation is attempted by NimRecorder Excel functions |
| 1 | File empty |
| 2 | File not found |
| 3 | Path not found |
| 4 | Too many files open |
| 5 | Path empty |
| 6 | Directory already exists |
| 7 | File already exists |
| 8 | Not enough memory |
| 9 | File or path not found (TaskExec could not find if it's the file or the path which is not found) |
| 10 | Incorrect disk |
| 11 | Error in current directory |
| 12 | Write protected |
| 13 | Unable to copy files |
| 14 | Unable to delete files |
| 15 | Unable to name files |
| 16 | Unable to move directory |
| 17 | Unable to create directory |
| 18 | Unable to delete directory |
| 19 | Unable to change directory |
| 20 | Unable to write (or save) |
| 21 | Directory full |
| 22 | Bad sector |
| 23 | Error IO |
| 24 | Violation error |
| 25 | Disk full |
| 26 | Unable to create file |
| 27 | Unable to open file |
| 28 | Unable to readi file |
| 29 | Invalid file |
| 30 | Unable to close file |
| 31 | Invalid length |
| 32 | Unable to change attributes |
| 90 | Internal XML COM error |
| 99 | Invalid parameters |
| 110 | Invalid XML path |
| 111 | Invalid XML attribute or XML attribute not found |
| 112 | Index too big (return code only for the XML functions) |
Error codes for Flow control functions
The table below lists the possible error codes for the NimRecorder Flow control functions, for the errors stopping script execution (unless #IgnoreErrors=1). Only the Shell or the Run function return such error codes.
| 34 | DDE failure |
| 35 | No association |
| 36 | Access denied |
| 37 | DLL not found |
| 38 | Sharing violation |
| 39 | Empty Shell name |
| 40 | Empty Run name |
Error codes for FTP functions
The table below lists the possible error codes for the NimRecorder FTP functions, for the errors stopping script execution (unless #IgnoreErrors=1).
| 9 | File or path does not exist |
| 80 | The file already exists |
| 550 | Requested action not taken. File unavailable (e.g., file not found, no access) |
| 553 | Requested action not taken. File name not allowed |
| 12001 | No more handles could be generated at this time |
| 12002 | The request has timed out |
| 12003 | An extended error was returned from the server |
| 12004 | An internal error has occurred |
| 12005 | The URL is invalid |
| 12006 | The URL scheme could not be recognized or is not supported |
| 12007 | The server name could not be resolved |
| 12008 | The requested protocol could not be located |
| 12012 | Internet function support is being shut down or unloaded |
| 12013 | The request to connect and log on to an FTP server could not be completed because the supplied user name is incorrect |
| 12014 | The request to connect and log on to an FTP server could not be completed because the supplied password is incorrect |
| 12015 | The request to connect to and log on to an FTP server failed |
| 12016 | The requested operation is invalid |
| 12017 | The operation was canceled |
| 12020 | The request cannot be made via a proxy |
| 12021 | A required registry value could not be located |
| 12022 | A required registry value was located but is an incorrect type or has an invalid value |
| 12023 | Direct network access cannot be made at this time |
| 12026 | The required operation could not be completed because one or more requests are pending |
| 12028 | The requested item could not be located |
| 12029 | The attempt to connect to the server failed |
| 12030 | The connection with the server has been terminated |
| 12037 | SSL certificate date that was received from the server is bad. The certificate is expired |
| 12038 | SSL certificate common name (host name field) is incorrect |
| 12039 | The application is moving from a non-SSL to an SSL connection because of a redirect |
| 12040 | The application is moving from an SSL to an non-SSL connection because of a redirect |
| 12110 | The requested operation cannot be made on the FTP session handle because an operation is already in progress |
| 12111 | The FTP operation was not completed because the session was aborted |
| 12156 | The redirection failed because either the scheme changed (for example, HTTP to FTP) or all attempts made to redirect failed (default is five attempts) |
Error codes for ODBC functions
The table below lists the possible error codes for the NimRecorder ODBC functions, for the errors stopping script execution (unless #IgnoreErrors=1).
| -5 | Close the record set first |
| -4 | Connection cancelled |
| -3 | No numeric field |
| -2 | No connection available |
| -1 | No record set |
Error codes for Synchronization function
There are no error codes for Synchronization functions. At execution, if an error prevents even the PauseFalse block to be executed, an error message is displayed and execution stops. You have to correct the code and then replay.
Error codes for User dialogue functions
There are no error codes for User dialogue functions. At execution, the function returns an empty string in case of an error.
Error codes for Web functions
The table below lists the possible error codes for the NimRecorder Web functions, for the errors stopping script execution (unless #IgnoreErrors=1).
| -2146697211 | An HTTP error prevents the specified page to load |
| -404,-405 | Usual HTTP error codes |
| -14 | Invalid character for WriteHTML - use instead WriteHTMLPaste function |
| -12 | Download timeout |
| -11 | Internal error |
| -8 | HTML Element not found |
| -7 | Index too big |
| -5 | Page has not finished to load within the timeout |
| -4 | Browser lost (commonly occurring error when somehting went wrong with the browser, e.g., focus lost, a prompt interfered with the script run, etc.) |
| -3 | Bad HTML descriptor |
| -3 | Browser not recognized (Only for StartBrowser function when its first parameter is different from "IE") |
| -2 | Page not found |
| -1 | Impossible to capture or invalid range (Capture Web functions) |
| -1 | No browser in use (no UsePage or StartBrowser before) |
| -1 | Extraction cannot be done (ExtractLink function) |
Error codes for Windows management functions
The table below lists the possible error codes for the NimRecorder Windows management functions, for the errors stopping script execution (unless #IgnoreErrors=1).
42 Window name empty
43 No window specified
44 Impossible to move the window
45 Impossible to resize the window
46 Focus change error
48 Impossible to find Edit box
49 Impossible to find Combobox
50 Impossible to attach to Combobox
51 Impossible to find Listbox control
52 Impossible to find Combobox control
53 Impossible to find Listview control
54 Impossible to find Treeview control
55 Impossible to find button
56 Impossible to find checkbox
57 Impossible to find radiobutton
58 Impossible to find Tab
59 Invalid scrollbar
60 Impossible to create the msgframe
61 New coordinates for window are out of the screen
62 Impossible to read window size
64 Out of screen
65 Item not found
75 Empty menu name
76 Menu not found
77 Menu attach error
78 Menu item not found
90 Internal error
95 Invalid instance number
98 Error in key list inside instruction SendKeys
99 Invalid parameter
105 Invalid UI command (the User Interface is not available when running a non-interactive task via Scheduler)
106 Invalid toolbar
108 Invalid Regular Expression
Feedback
