The article directories

• $ECODE variable

• The outline

• describe

• Remove ` $ECODE `

• Setting $ECODE

• The ‘$ECODE’ string overflows

• Pay attention to

• • Create your own error code

$ECODE variable

Contains the current error code string.

The outline

$ECODE
$EC
Copy the code

describe

When an error occurs, the Cache sets the $ECODE special variable to a comma-separated string containing the error code corresponding to the error. For example, when referencing an undefined global variable, the Cache sets the $ECODE special variable to the following string:

,M7,
Copy the code

$ECODE can contain ISO 11756-1999 standard M error codes in the format M #, where # is an integer. For example, M6 and M7 are “undefined local variables” and “undefined global variables” respectively. (M7 is dedicated to global variables and processes.)

$ECODE can also contain the same error code as the Cache General System error code (the error code returned to the $ZERROR special variable at the terminal prompt). However, $ECODE prefixes these error codes with a “Z” and removes Angle brackets. So $ECODE error ZSYNTAX is a

error, ZILLEGAL VALUE is a

error, and ZFUNCTION is a

error. $ECODE does not reserve any additional error messages for the error codes that provide it; So ZPROTECT is a error; The additional information component is stored in $ZERROR, but not in $ECODE.

If an error occurs when $ECODE already contains the previous error code, the existing error stack is cleared when a new error occurs. The new error stack will contain only entries that show the state at which the current error occurred. (This is different from the earlier $ECODE behavior, where the old error stack persisted until it was explicitly cleared.)

If there are multiple error codes, the Cache appends each error code to the end of the current $ECODE value in the order in which it was received. Each error in the resulting $ECODE string is separated by commas, as shown below:

,ZSTORE,M6,ZILLEGAL VALUE,ZPROTECT,
Copy the code

In this case, the most recent error is the error.

You can also explicitly clear or set $ECODE. Always clear $ECODE when terminating the current process.

remove$ECODE

SET $ECODE=""
Copy the code

Setting $ECODE

You can enforce an error by setting $ECODE to a value that is not an empty string. Setting $ECODE to any non-null value forces an interpreter error during the execution of the ObjectScript routine. After the Cache sets $ECODE to the specified non-null value, the Cache takes the following steps:

1. Writes the specified value to$ECODEOverrides all previous values.
2. generate<ECODETRAP>Error. (this will$ZERRORSet to the value<ECODETRAP>).
3. Pass control to any error handlers that have been established. The error handler can check the selected$ECODEString values and take steps to properly handle the condition.

$ECODEString overflow

Pay attention to

Create your own error code

 SET $ECODE=",Upassword expired! ,"
Copy the code