$procerror

Return the reason for an error in ProcScript execution.

{Result = } $procerror

reset $procerror

Return Values

$procerror returns a value that indicates the reason for a ProcScript execution error reported in $status. You can use the error constants in writing your ProcScript to make it more readable.

Values Returned by $procerror: 0 – -49

Value	Error Constant	Meaning
0	UACT_SUCCESS	Success.
-1	UGENERR_ERROR	An error occurred.
-2	UIOSERR_OCC_NOT_FOUND	Occurrence or record not found; the table is empty or end of file was encountered. Occurrence removed since last retrieve. The entity is painted as an up entity and the key value was not found during the database lookup.
-3	UIOSERR_EXCEPTIONAL	Exceptional I/O error (hardware or software).
-4	UIOSERR_OPEN_FAILURE	The table or file could not be opened. The entity is not painted or the corresponding table or file does not exist in the database.
-5	UIOSERR_UPDATE_NOT_ALLOWED	No write or delete permission for the table or file. The occurrence is read-only (cannot be locked).
-6	UIOSERR_WRITE_FAILURE	An error occurred while writing, updating, or deleting the table or file; for example, lack of disk space, no write permission, or violation of a database constraint.
-7	UIOSERR_DUPLICATE_KEY	The key exists in the database but was not found in the hitlist. This occurs when the user tries to enter a duplicate key.
-8	UIOSERR_END_OF_HITLIST	End of hitlist.
-9	UIOSERR_LOGON_ERROR	DBMS logon error. This can occur if the database connection has been lost or the maximum number of DBMS logons has already been reached.
-10	UIOSERR_LOCK_DATA_MISMATCH	Occurrence has been modified or removed since it was retrieved; the occurrence should be reloaded.
-11	UIOSERR_LOCKED	Occurrence already locked.
-12	UIOSERR_FILE_READ_WRITE	An error occurred while trying to read or write to the file.
-13	UIOSERR_OS_COMMAND	An error occurred while trying to perform the OS command. Set $ioprint to `63` to display the exact error in the message frame.
-14	URETERR_MULTIPLE_DOWN	The entity is painted as a normal down entity and multiple hits were found during the database lookup (ambiguous key).
-15	URETERR_MULTIPLE_UP	The entity is painted as an up entity and multiple hits were found during the database lookup.
-16	UNETERR_UNKNOWN	Network error.
-17	UNETERR_PIPE_BROKEN	Connection lost.
-18	UNETERR_CONNECTION	Application failed to connect to the Uniface Router, or failed to start an exclusive Uniface Server.
-19	UNETERR_FATAL	Uniface Server exited with fatal error.
-20	UNETERR_MAX_CLIENTS	Uniface Router could not accept new client, $MAX_CLIENTS exceeded.
-21	UNETERR_LOGON_ERROR	Network logon error.
-22	UNETERR_NO_REGISTRATION	Application failed to register with the Uniface Router.
-23	UNETERR_DOUBLE_UST	Registration with Uniface Router specified UST that is already in use.
-24	UNETERR_START_SERVER	Uniface Router could not start Uniface Server process (executable not found).
-25	UNETERR_SERVER_GONE	Uniface Router could not route request to specific Uniface Server process.
-31	UGENERR_LICENSE	No license for requested action. Contact your Uniface representative.
-32	UGENERR_TIMEOUT	A time-out occurred.
-33	UGENERR_BATCH_ONLY	Statement not allowed in batch mode. Use a test on $batch to avoid this.
-34	UGENERR_CURRENCY	Changes to the active path not allowed.
-35	UGENERR_4GL_SAYS_ERROR	An operation or trigger returned a negative value.
-36	UGENERR_TEST	Statement not allowed in test mode.
-37	IOSERR_OFFSET_NOTSUPPORTED	read statement uses an offset option but the database driver does not support pagination
-38	IOSERR_OFFSET_PARAMETERS	Incomplete or wrong parameters for offset
-40	USYSERR_NOMEMORY	Not enough memory
-41	USYSERR_INVALID	Invalid characters in directory or filename

Values Returned by $procerror: -50 – -99

Value	Error Constant	Meaning
-50	UACTERR_NO_SIGNATURE	Signature descriptor for the current component not found (in UAR or resource file). For example, the component name provided is not valid. Signature descriptor found but an interface is missing or invalid.
-51	UACTERR_SIGNATURE_ID	The identifier of the compiled component does not match the identifier in the signature descriptor
-52	UACTERR_PROTOCOL	Protocol error (wrong sequence of operations).
-53	UACTERR_ENTITY_GET	An error occurred while copying the occurrences of an entity parameter to occurrences of the activated operation. This occurs at the start of processing for the activate statement on either the client or the server.
-54	UACTERR_ENTITY_PUT	An error occurred while copying occurrences of the entity parameter in the activated operation to occurrences of the component instance. This occurs at the end of processing for the activate statement on either the client or the server.
-55	UACTERR_PARAMETER_GET	An error occurred while getting an OUT or `INOUT` parameter from the activated operation. For example, the actual parameter provided cannot be used to receive output because it is a constant string. This occurs at the end of processing for the `activate` statement on either the client or the server.
-56	UACTERR_PARAMETER_PUT	An error occurred while putting an IN or `INOUT` parameter into the activated operation. This error occurs at the start of processing for the activate statement on either the client or the server.
-57	UACTERR_NO_INSTANCE	The named instance cannot be found in the component pool.
-58	UACTERR_NO_COMPONENT	The named component cannot be found. A modal form is started using run, and the form is already running.
-59	UACTERR_NO_OPERATION	No definition found for operation.
-60	UACTERR_ACTION_ON_MODAL_FORM	An attempt was made by an instance other than the current modal form instance to start an operation other than the EXEC operation.
-61	UACTERR_ENTITY_DUMMY	The entity specified as an entity parameter is a dummy entity.
-62	UACTERR_ENTITY_PARAM_MISMATCH	The entity specified as an entity parameter must be the same entity as that specified in the operation. That is, one is a supertype and the other is a subtype of that supertype, or both are subtypes of the same supertype.
-63	UACTERR_NO_PROPERTY	No property found.
-64	UACTERR_OPER_MAP_NO_MAP	Operation not mapped.
-65	UACTERR_OPER_NOT_IMPLEMENTED	No implementation found for operation.
-66	UACTERR_OCC_NOT_ALLOWED	Not allowed on occurrence parameter.
-67	UACTERR_OCCURRENCE_GET	Occurrence parameter get error.
-68	UACTERR_OCCURRENCE_PUT	Occurrence parameter put error.
-69	UACTERR_OCC_RELTD_ONE_MISS	Occurrence parameter error. The related occurrence is not available.
-70	UACTERR_ENT_DESCR_NOTFND	Entity descriptor not found.
-71	UACTERR_GET_STATE	Error in getting state.
-72	UACTERR_ENTITY_PARAM_IS_SELF	Entity parameter is both source and destination.
-73	ACTERR_REMOTE_NOT_SUPPORTED	Operation with byref-Struct parameter cannot be activated across processes. For more information, see Passing Struct Parameters.
-80	UACTERR_URB_INIT	Failure to connect to URB.
-81	UACTERR_ENGINE_INIT	Failure to connect to engine.
-84	UACTERR_NO_OBJECT	No handle or empty handle specified. -> operator used with a data type that is not a Struct
-85	UACTERR_NO_REQUEST	No request specified.
-86	UACTERR_EXPOSE	Failure to expose object.
-87	UACTERR_REQUEST	Unsupported or unknown request encountered.
-88	UACTERR_OBJECT_DELETED	Object has been deleted.
-90	UZIPERR_STREAM	Invalid (compressed) data stream error
-91	UZIPERR_DATA	Invalid data in zip file structure
-92	UZIPERR_CRC	CRC data mismatch
-93	UZIPERR_LENGTH	Data length mismatch
-94	UZIPERR_VERSION	Zip library incompatible

Values returned by $procerror: -100 – -299

Value	Error Constant	Meaning
-150	UACTERR_UNKNOWN	A hardware or software error occurred. Contact your Uniface representative.
-151	UACTERR_EXCEPTION_THROWN	An exception error has been thrown.
-154	UACTERR_INSTANCE_NAME_EXISTS	An instance with this name already exists. This error code can be returned when (for example): A modal form which is already active is activated again An attempt is made to activate a modal form from a non-modal form
-155	UACTERR_CREATE_INSTANCE	An error occurred while creating an instance: An unknown property occurs in the instance properties. A property in the instance properties has a value that is not valid. The component could not be loaded. An exit statement was executed in the operation `INIT`.
-156	UACTERR_WRONG_IMPLEMENTATION	Wrong or undefined implementation.
-159	UACTERR_QUEUE	Message could not be delivered to requested queue.
-160	UACTERR_ILLEGAL_SYNC_MODE	Unknown communication mode
-161	UACTERR_ILLEGAL_SYNC_TYPE	Illegal mixture of synchronous and asynchronous communication modes.
-162	UACTERR_DELETE_INSTANCE	Deleting the instance has been postponed because the instance is busy. For example, operation A1 in INSTA activates operation B1 in INSTB. Operation B1, in turn, activates operation A2 in INSTA. Operation A2 performs an exit, but INSTA cannot be deleted until operations B1 and A1 complete.
-163	UACTERR_DEL_POSTPONED_CHILD	Deleting the instance has been postponed because the instance has at least one busy child instance. The instance will be deleted when it no longer has busy children. For example, non-modal form FRMX starts an attached non-modal form FRMY. While the application is idle, the user clicks on FRMY, activating a trigger which sends a message to FRMX. This message results in an exit (on FRMX), but FRMX cannot be deleted until its child instance FRMY is not busy.
-164	UACTERR_DEL_POSTPONED_PROC	The instance is in the process of being deleted. For example, between a deleteinstance or exit and the time the instance is actually deleted, an attempt is made to activate an operation in the instance being deleted.
-165	UACTERR_BAD_HANDLE	Handle not valid.
-166	UACTERR_STATELESS	Component instance could not be created by the newinstance statement because the component is stateless.
-167	UACTERR_BAD_INIT_OPT	Initialization or Option properties error
-168	UACTERR_ZOOM_ACTIVE	Zoom window active. It is not possible to start a Form from a zoom window.
-170	UACTERR_TX_FAILURE	Transaction manager failure.
-171	UACTERR_TX_NO_TRANSPORT	Transaction cannot be transported.
-172	UACTERR_TX_NOT_STARTED	Transaction is not started.
-173	UACTERR_TX_NOT_RUNNING	Transaction is not running.
-180	UACTERR_ACCESS_DENIED	An operation or trigger that is being activated from a web or SOAP client has not been declared as public web or public soap.
-250	UWEBERR_SKELETON	Skeleton file not found or is incorrect.
-251	UWEBERR_OUTFILE	When $web`=""`, the output file is not specified or is the same as the skeleton file.
-252	UWEBERR_IO	Output file could not be written.
-253	UWEBERR_IO_IMAGE	Image file could not be written.
-254	UWEBERR_ITERATION	Nested iteration over the same entity.
-255	UWEBERR_NO_CGI	This statement must be used in a Web run-time environment ($web`!=""`).
-256	UWEBERR_NO_INPUT_EXPECTED	No further input expected, because no fill-out document has been generated.
-257	UWEBERR_ILLEGAL_ACT	One or more fields cannot be accessed; that is, field names referenced in the fill-out document skeleton file are not available in the current Uniface form.
-258	UWEBERR_STEP	Form synchronization error, that is, the user has submitted an HTML document that does not correspond to the last one generated. It is, instead, a form generated by Uniface earlier in the same session.
-259	UWEBERR_HASH	Mismatch between the security hash of a field and the field value. This occurs when the value of a NED field has been modified by the browser or other web user agent.
-260	UWEBERR_OCC_REJECTED	The data being processed by webget contains a new occurrence created in the client.
-261	UWEBERR_DATA	An error occurred while loading data. Incorrect data values or data formats were encountered during server-side validation of a Date, Time, or DateTime field.

Values returned by $procerror: -300 – -999

Value	Error Constant	Meaning
-300	UVALERR_SYNTAX	An error in declarative syntax occurred.
-301	UVALERR_CONSTRAINT	Violation of restricted delete constraint.
-302	UVALERR_KEY_PROFILE	A key field contains a profile character or the key is incomplete.
-303	UVALERR_KEY_EMPTY	A key field is empty.
-304	UVALERR_TARGET_FIELD	Cannot move focus to target field
-350	UHLPERR_STARTUP	Unable to start help.
-351	UHLPERR_PLATFORM	Platform does not support native help. (In this case you may want to use the help [native] statement to provide help information.)
-352	UHLPERR_LOGICAL_NAME	Unable to map logical name.
-353	UHLPERR_TOPIC	Requested help topic or keyword not found.
-354	UHLPERR_OPTION	Native help does not support the requested option.
-400	UMISERR_PRINT	Uniface could not print, for example: Printing is already being performed ($printing`=1`). ^QUIT was used in the Print form. The print mode is not valid. For more information on printmodes, see print
-401	UMISERR_PRINT_BREAK	An error occurred during printbreak: Uniface is not printing ($printing`=0`). printbreak encountered in a header or footer frame.
-403	UMISERR_UWHERE	Nonexistent field in a u_where clause.
-404	UMISERR_TRX	The TRX-formatted DML statement from a where clause or an sql statement exceeds 32 KB.
-405	UMISERR_SETFORMFOCUS	Modal form has focus.
-406	UMISERR_FILEBOX	An error occurred during a filebox statement.

Values returned by $procerror: -1000 – -1099

Value	Error Constant	Meaning
-1001	UPROCERR_STRING	Not a valid String value.
-1002	UPROCERR_NUMERIC	Not a valid Numeric value.
-1003	UPROCERR_FLOAT	Not a valid Float value.
-1004	UPROCERR_DATE	Not a valid Date value.
-1005	UPROCERR_TIME	Not a valid Time value.
-1006	UPROCERR_DATETIME	Not a valid Datetime value.
-1007	UPROCERR_RAW	Not a valid Raw value.
-1008	UPROCERR_BOOLEAN	Not a valid Boolean value.
-1009	UPROCERR_LINEAR_DATE	Not a valid Linear Date value.
-1010	UPROCERR_LINEAR_TIME	Not a valid Linear Time value.
-1011	UPROCERR_LINEAR_DATETIME	Not a valid Linear Datetime value.
-1012	UPROCERR_IMAGE	Not a valid Image value.
-1013	UPROCERR_SYNTAXSTRING	Not a valid syntax string.

Values returned by $procerror: -1100 – -1199

Value	Error Constant	Meaning
-1101	UPROCERR_FIELD	An incorrect field name was provided; either the field name is not valid syntactically or the field is not available in the component.
-1102	UPROCERR_ENTITY	The entity name provided is not a valid name or the entity is not painted on the component.
-1103	UPROCERR_MODEL	The entity's model name is not a valid name or the entity is not painted on the component.
-1104	UPROCERR_KEY	The key number provided is not valid; for example, the key number was out of range.
-1105	UPROCERR_INSTANCE	The instance name provided is not valid. For example, the argument contains incorrect characters.
-1106	UPROCERR_COMPONENT	The component name provided is not valid; for example, the argument contains an empty string ("").
-1107	UPROCERR_PATH	The path name is not correct or the path does not exist, for example, no assignment is found for the path.
-1109	UPROCERR_ENTRY	The entry name specified cannot be found.
-1110	UPROCERR_TOPIC	Topic name not known.
-1111	UPROCERR_MESSAGE	The message identifier is not valid; the field or variable was not found, or the string is not a valid message identifier.
-1112	UPROCERR_OPTION	Option not valid.
-1113	UPROCERR_PARAMETER	Parameter name not valid or not defined.
-1114	UPROCERR_LOCAL_VARIABLE	Local variable name not valid or not defined.
-1115	UPROCERR_COMPONENT_VARIABLE	Component variable name not valid or not found.
-1116	UPROCERR_GENERAL_VARIABLE	General variable not valid.
-1117	UPROCERR_GLOBAL_VARIABLE	Global variable name not valid or not found.
-1118	UPROCERR_ARGUMENT	The argument specified is incorrect.
-1119	UPROCERR_FUNCTION	ProcScript function not valid.
-1120	UPROCERR_OPERATION	The operation name provided is not valid.
-1121	UPROCERR_3GL	The requested 3GL function was not found.
-1122	UPROCERR_NARGUMENTS	Wrong number of arguments.
-1123	UPROCERR_NPARAMETERS	Wrong number of parameters.
-1124	UPROCERR_APPLICATION	Application name not valid.
-1125	UPROCERR_MENU	The specified menu does not exist.
-1126	UPROCERR_PROPERTY	A property is not valid.
-1127	UPROCERR_DATATYPE	Data type not valid.
-1128	UPROCERR_NOT_A_KEY	The key number specified is an index.
-1129	UPROCERR_ITEM	Item not found.
-1130	UPROCERR_PUTLIST_DOUBLE	Double entry in PUTLIST.
-1131	UPROCERR_PUTLIST_NON_EXIST	Non-existing entry in PUTLIST.
-1132	UPROCERR_UNRESOLVED_TOPIC	Topic could not be resolved.
-1133	UPROCERR_OCC_NOT_FOUND	Occurrence could not be found
-1134	UPROCERROR_EMPTY_MEMBER_NAME	Struct member name missing
-1135	UPROCERR_SCOPECB_NOT_JAVASCRPT	Callback for dynamic scope is not JavaScript
-1136	UPROCERR_SCOPECB_UNDEFINED	Callback for dynamic scope is
-1137	UPROCERR_MESSAGE_NAME_TOO_LONG	Message name too long
-1138	UPROCERR_MESSAGE_NAME_EMPTY	Empty message name
-1139	UPROCERR_MODULE_NAME	ProcScript module name is invalid.
-1151	USTRUCTERR_NO_COMMON_CHARACTERISTICS	Structs do not have a common name or parent
-1152	STRUCTERR_INDEX_NOT_ASSIGNABLE	Struct cannot be assigned
-1153	USTRUCTERR_INDEX_NOT_ALLOWED	Struct index is not allowed
-1154	USTRUCTERR_INDEX_OUT_OF_RANGE	Struct index is out of range
-1155	USTRUCTERR_MEMBER_NOT_FOUND	Struct member not found
-1156	USTRUCTERR_NOT_A_SINGLE_STRUCT	Struct cannot be moved to one of its own descendants
-1157	USTRUCTERR_ILLEGAL_MEMBER_TYPE	Not a valid struct member type
-1158	USTRUCTERR_CIRCULAR_REFERENCE	Struct cannot be moved to a descendent of its current parent.
-1159	UTAGVALUE_NOT_RECOGNIZED	Struct has an invalid value
-1160	STRUCTERR_TAGVALUE_NOT_APPLICABLE	Struct tag value not applicable in conversion from Struct
-1161	STRUCTERR_NO_MATCHING_NAME	No matching name found during conversion from Struct
-1162	USTRUCTERR_NOT_ALLOWED_ON_TAGS	Struct cannot be moved to a $tags Struct of another Struct
-1163	USTRUCTERR_SCALAR	Struct is a Scalar Struct, so it has no members
-1164	USTRUCTERR_NOT_A_SCALAR	Tried to assign a non-scalar value to $scalar. The Struct is not changed in that case.
-1190	USTRUCTWARN_MEMBER_NOT_FOUND	Struct member not found. The schema specifies an element that can contains sub-elements but no character data. The Struct members or the sub-elements can be found, but not the parent element.

Values returned by $procerror: -1200 – -1399

Value	Error Constant	Meaning
-1201	UPROCERR_SMALL	Value too small.
-1202	UPROCERR_LARGE	Value too large.
-1203	UPROCERR_RANGE	Value out of range.
-1204	UPROCERR_NEGATIVE	Negative value not allowed.
-1205	UPROCERR_ZERO	Zero value not allowed.
-1206	UPROCERR_INTEGER	Not an integer.
-1207	UPROCERR_UNDERFLOW	Underflow.
-1208	UPROCERR_OVERFLOW	Overflow.
-1209	UPROCERR_DIVIDE	Divide by zero.
-1301	UPROCERR_SYNTAX	Syntax error.
-1302	UPROCERR_SERVICE	Function not allowed on service.
-1303	UPROCERR_REPORT	Function not allowed on report.
-1304	UPROCERR_UNKNOWN_CONTEXT	Function not allowed, unknown context.
-1305	UPROCERR_EXPRESSION	Expression not allowed.
-1306	UPROCERR_CONDITION	Condition not allowed.
-1307	UPROCERR_EXTRACTION_EXPR	Extraction expression is a condition.
-1308	UPROCERR_INDIRECTION	Indirection followed by brackets.
-1309	UPROCERR_PARENTHESES	Operand followed by parentheses.
-1310	UPROCERR_BRACKETS	Operand followed by square brackets.
-1311	UPROCERR_UNSOLVED_OPERAND	A field, parameter, or variable could not be found in current context.
-1312	UPROCERR_LABEL	The label is not valid.
-1313	UPROCERR_SWITCH	The switch is not valid.
-1314	UPROCERR_DESTINATION	The operand cannot be used as destination.
-1315	UPROCERR_OPERATOR	The operator is not valid.
-1316	UPROCERR_RELATIONAL	Conditional operators are not allowed in expressions.
-1317	UPROCERR_SWITCH_COMBINATION	The switch combination is not valid.
-1318	UPROCERR_SELFCONTAINED	This is not allowed in a self-contained component.
-1319	UPROCERR_SERVERPAGE	Function not allowed on server page.
-1320	UPROCERR_COMPONENTLOCK	Component is locked for updates. The component is locked for updates. This can occur when processing disconnected record sets, when discard is used in the preSerialize or postSerialize triggers.

Values returned by $procerror: -1400 – -1499

Value	Error Constant	Meaning
-1401	UPROCERR_PROMPT	Prompted field not valid.
-1402	UPROCERR_STATEMENT	Statement not allowed in this trigger.
-1403	UPROCERR_OPERAND	Operand not valid.
-1404	UPROCERR_NO_PRINTING	Not printing (that is, $printing`=0`).
-1406	UPROCERR_MEMORY	Memory allocation failure.
-1407	UPROCERR_READ_ONLY	Operand is read-only.
-1408	UPROCERR_NO_GUI	GUI driver not active.
-1409	UPROCERR_INTERACTIVE	Not in interactive mode.
-1410	UPROCERR_PROPERTY_VALUE	A property has been assigned an incorrect value.
-1411	UPROCERR_EDITTWICE	Edit is not allowed in interactive mode. An edit statement was encountered when the structure editor was already active. This error also occurs when an activate is performed on a modal form that is already in edit mode and that has an empty exec operation (an implicit edit).
-1412	UPROCERR_HANDLE_USAGE	Invalid use of a handle.
-1413	UPROCERR_ASSIGN_HANDLE_SCOPE	Destination availability scope is too wide.
-1414	UPROCERR_THREAD_START	Thread start failure.
-1415	UPROCERR_NODE	Not a valid Node Topic
-1416	UPROCERR_OBJECT	Specified handle is invalid
-1418	UPROCERR_FIELD_NOT_VISIBLE	Field is not visible
-1419	UPROCERR_WIDGETOPERATION	Widget operation is invalid
-1498	UPROCERR_OBJECT_NOT_ALLOWED	Handle is not allowed.
-1499	UPROCERR_OBJECT	The specified handle is not valid.

Values returned by $procerror: -1500 – -1699

Value	Error Constant	Meaning
-1500	UXMLERR_DTD_NOTFOUND	A DTD could not be located.
-1501	UXMLERR_DTD_INVALID	There is a syntax error in the DTD.
-1502	UXMLERR_GENERATION	An error occurred during generation of an XML stream.
-1503	UXMLERR_PARSE	An error occurred during parsing of an XML stream.
-1504	UXMLERR_VALIDATE	An error occurred during validation of an XML stream.
-1505	UXMLERR_TRANSFORM	An error occurred during transformation of an XML stream.
-1506	UXMLERR_FIELD_NOTAVAIL	A mandatory field is not available in the field list of the entity. In the DTD, such fields must be followed by a question mark (?).
-1550	UXMLWARN_PARSE	A warning occurred during parsing of an XML stream.
-1600	UPROCERR_INLINEMENU_CONTEXT	The function has been used outside the scope of the current preDisplay context
-1601	UPROCERR_INLINEMENU_COMPOMENT	The function has been used in a component. It is allowed only in a preDisplay trigger
-1602	UPROCERR_INLINEMENU_CONTENT	The menu item list has been incorrectly defined.
-1603	UPROCERR_INLINEMENU_REFMENU	A menu referenced in a cascading menu does not exist.
-1604	UPROCERR_INLINEMENU_ID	Menu item identifier is missing
-1605	UPROCERR_INLINEMENU_UNIQUE_ID	Menu item identifier is not unique
-1606	UPROCERR_INLINEMENU_TYPE	Invalid menu item type
-1607	UPROCERR_OPERATIONNAME	Invalid operation name

Values returned by $procerror: -1700 – -1749

Value	Error Constant	Meaning
-1700	UUDEERR_UDE_NOT_AVAILABLE	Function is not available at runtime
-1701	UUDEERR_OPERATION	Invalid operation name Occurs when the first argument of the $ude function is incorrect.
-1702	UUDEERR_OPERATION_NOT_ALLOWED	Operation not allowed in combination with Object Occurs when the first argument of the $ude function is incorrect.
-1703	UUDEERR_OBJECTTYPE	Invalid ObjectType Occurs when the second argument of the $ude function is incorrect.
-1704	UUDEERR_OBJECTTYPE_NOT_ALLOWED	ObjectType is not supported Occurs when the second argument of the $ude function is incorrect.
-1705	UUDEERR_DELETE	Failed to delete
-1706	UUDEERR_COMPILE	Failed to compile
-1707	UUDEERR_CLEANUP	Failed to cleanup
-1708	UUDEERR_LOOKUP	Failed to find Object
-1709	UUDEERR_ARGUMENTS	Invalid number of arguments
-1710	UUDEERR_SETTINGS	Failed to get/set settings
-1711	UUDEERR_VALIDATE	Failed to validate
-1712	UUDEERR_DESCRIBE	Failed to describe
-1713	UUDEERR_DECOMPILE	Failed to decompile
-1714	UUDEERR_LIST	Failed to list
-1715	UUDEERR_TEMPLATE	Failed to find @Template
-1716	UUDEERR_TEST	Failed to test
-1717	UUDEERR_OPERAND	Invalid operand
-1718	UUDEERR_COPY	Invalid copy / import / export Occurs when the copy, import, or export operation failed.
-1719	UUDEERR_GENHTMLSKELETON	Error generating html skeleton
-1720	UUDEERR_GENERAL	Failed to process
-1721	UPACKERROR_PACKNOTSUPPORT	PackingCode not allowed for this DataType
-1722	UPACKERROR_NOPACK	Invalid PackingCode
-1723	UPACKERROR_NODEFAULT	Default does not exist
-1724	UPACKERROR_PACKRANGE	PackingCode out of range
-1725	UPACKERROR_INVSCALE	Scaling only allowed for Numeric DataType
-1726	UPACKERROR_SCALERANGE	Scaling out of range
-1727	UPACKERROR_SUBFIELD	Invalid subfield declaration
-1728	UPACKERROR_SIZE	Invalid size
-1729	UPACKERROR_SUBFIELDRANGE	Subfield does not fit in FixedFieldWidth
-1730	UPACKERROR_SYNTAX	Unrecognized characters seen
-1731	UPACKERROR_VARTYPE	Invalid Variable ID
-1732	UPACKERROR_CHARSET	Invalid Charset
-1740	ULAYERROR_SYNTAX	Syntax error
-1741	ULAYERROR_MNEMONIC	Invalid Mnemonic
-1743	ULAYERROR_PARENTHESIS	Invalid Parenthesis
-1744	ULAYERROR_NUMBER	Invalid Number
-1745	ULAYERROR_DISPLAY	Invalid Display format

Values returned by $procerror: -1750 – -1799

Values Commonly Returned in $procerror after `$encode` / $decode
Value	Error constant	Meaning
`-1780`	`UENCERR_NO_ALGORITHM`	Algorithm not found.
`-1781`	`UENCERR_NO_SOURCE`	Source not found.
`-1782`	`UENCERR_NO_KEY`	Key not found.
`-1783`	`UENCERR_NO_IV`	IV not found.
`-1784`	`UENCERR_INVALID_ALGORITHM`	Invalid algorithm name.
`-1785`	`UENCERR_INVALID_MODE`	Invalid mode name.
`-1786`	`UENCERR_INVALID_KEY_LENGTH`	Invalid key length. The key must have a specific length that depends on the algorithm.
`-1787`	`UENCERR_INVALID_HEX_FORMAT`	Source is invalid HEX format.
`-1788`	`UENCERR_INVALID_BASE64_FORMAT`	Source is invalid BASE64 format.
`-1789`	`UENCERR_INVALID_URL_FORMAT`	Source is invalid URL format.
`-1791`	`UENCERR_GENERAL`	Encode/decode general error
`-1792`	`UENCERR_INVALID_SOURCE`	Invalid source data
`-1793`	`UENCERR_INVALID_KEY`	Invalid key data
`-1794`	`UENCERR_INVALID_KEY_FORMAT`	Invalid key format, must be PEM format
`-1795`	`UENCERR_INVALID_PUBLIC_KEY`	Invalid public key
`-1796`	`UENCERR_INVALID_PRIVATE_KEY`	Invalid private key
`-1797`	`UENCERR_INVALID_IV`	Invalid IV data
`-1798`	`UENCERR_NO_SIGNATURE`	Signature data not found
`-1799`	`UENCERR_INVALID_SIGNATURE`	Invalid signature data

Values returned by $procerror: -1900 – -1999

Value	Error Constant	Meaning
- 1900	UJSONERR_NO_CONTENT	Failed to load JSON string Occurs if the contents of the file are empty or if no JSON string is available after stripping leading and trailing whitespace.
-1901	UJSONERR_NO_TEXT	JSON text does not start with object or array A JSON text must begin with `{` or `[`.
-1902	UJSONERR_PARSER	JSON parser returned an error. Additional information is provided by the parser in $procerrorcontext. Non-fatal warnings about conditions that may be errors are returned in the `DETAIL` sublist of $procReturnContext. For example, JSON text should normally not have members with the same name in one object, but there may be valid reasons for doing this.
-1905	USTRUCTERR_INPUT	Input struct data is not valid. For example, the struct variable may have been declared, but not initialized.

Use

Allowed in all component types.

Description

The function $procerror returns a value that indicates the reason for a ProcScript execution error reported in $status. When $status and $procerror are both negative, $status indicates that an error occurred and $procerror determines the reason for the error. This allows you to write error processing code.

For validation errors, the following functions are also of use:

$procerrorcontext to determine the location of the error in your ProcScript.
$dataerrorcontext to determine the exact location of a validation error in the component's data structure.

The $procerror function is set to 0 at the start of any ProcScript module (and with reset $procerror). It is set to a negative value if an error occurs, as follows:

For a simple statement (such as creocc and putitem), $procerror is less than 0 and $status is usually less than 0.
For a statement that activates another module (such as activate or call), both $procerror and $status are less than 0. (If $status is set by ProcScript, $procerror remains 0.)
For a statement that causes ‘nested’ activation of triggers (such as store and validate), both $procerror and $status are less than 0. (If $status is set by ProcScript, $procerror is set to <UGENERR_4GL_SAYS_ERROR>. )
For a function, $procerror is less than 0 and $status is usually not changed.

If $procerror is set to Value, the description and mnemonic for this value can be retrieved from $procerrorcontext.

Note: ProcScript functions only set $procerror in case of failure.; they do not reset $procerror to 0 in case of success. This behavior ensures that expressions that contain several ProcScript functions return an error in $procerror, even if the last ProcScript function was successful; $procerror holds the last error value.

Error Handling with $procerror

Symbolic error constant names can be used to create global constants. These can be used with $procerror to write generalized and more readable error handling routines. For example:

store
if ($procerror >= 0)
   done
elseif ($procerror = <UIOSERR_LOCKED>)
   askmess "This occurrence is in use elsewhere. Please try later."
elseif ($procerror = <UIOSERR_UPDATE_NOTALLOWED>)
   askmess "You don't have Write permission."
elseif ($procerror = <UGENERR_ERROR>)
   askmess "Sorry, something's wrong."
else
   askmess "Problem: %%$status / %%$procerror"
endif