Guide for customers when using e2e_appmon transaction scripts and they return error codes from the script execution.
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).