Display error code messages
- Last UpdatedJul 28, 2025
- 2 minute read
Each recipe function returns a number that represents the error condition for the function. By using the RecipeGetMessage() function in an InTouch Data Change script, the corresponding error code can be written to an analog tag and the associated error code message can be written to a message tag.
The following code example shows a Data Change script.
RecipeGetMessage(ErrorCode, ErrorMessage, 131);
This script runs automatically whenever the value of the ErrorCode tag changes. When this script runs, the RecipeGetMessage() function reads the current numeric value of the ErrorCode tag and returns the message associated with that value to the ErrorMessage tag.
The following table lists possible error codes, their corresponding error messages, and descriptions:
|
Value |
Error Message |
Description |
|---|---|---|
|
0 |
Success |
The called recipe function executed successfully. |
|
-1 |
No Such Recipe Template |
The specified recipe template file does not exist. |
|
-2 |
View Not Active |
The recipe function called by another program cannot execute because WindowViewer is not running. |
|
-3 |
Out of Memory |
There is not enough memory to complete the current activity. |
|
-4 |
Line too long in recipe template file |
A line in the recipe template file exceeds the maximum allowed length. |
|
-5 |
Truncated line in the recipe file |
A line in the recipe template file is truncated. |
|
-6 |
Not a valid recipe template file |
The specified file is not a valid recipe template file. |
|
-7 |
Expecting "unit" or "recipe" |
A unit name or recipe name is missing from the recipe template file. |
|
-8 |
No units defined in recipe template file |
No units have been defined in the Units Definition template of the recipe file. |
|
-9 |
Recipe name not found in recipe template file |
The specified recipe is not defined in the recipe template file. |
|
-10 |
Unit name not found in recipe template file |
The specified unit name is not defined in the unit definition template file. |
|
-12 |
Expecting "Analog", "Discrete", "Message" |
An incorrect type has been entered for an item in the recipe template file. Valid types are analog, discrete or message. |
|
-13 |
Type of tag mismatches "Analog", "Discrete", "Message" |
The specified tag does not match the item type. For example, a recipe item is defined as analog and a message tag has been defined as the unit for it. |
|
-14 |
Invalid discrete value, expecting "0", "1" |
An incorrect value has been entered for a discrete tag in the recipe template file. The only valid values for discrete tags are 0 or 1. |
|
-15 |
Unable to open temporary file |
The temporary file cannot be opened possibly because of insufficient free disk space. |
|
-16 |
Write error while saving recipe template file |
An error occurred while saving the recipe template file. |
|
-17 |
User did not select |
The user selected Cancel in the Select a Recipe dialog box instead of a recipe name. |
|
-19 |
Recipe template in use by another application or the user running view does not have sufficient security privilege to open the file |
The recipe template file specified is open or the user does not have enough privilege and, therefore, cannot be accessed by WindowViewer. |