GN_Esp, Return an extended pointer to a system error message
Register parameters
N:
A = system error code requesting a pointer to a string
OUT:
Fc = 0
Fz = 1, error is fatal
Fz = 0, useful error message
BHL = pointer to error message string
Registers changed after return:
A..CDE../IXIY same
.FB...HL/.... different
Notes
The following is a list of messages produced by GN_Esp. All other values of A(in), and hence any error codes not in the list below, will give the message "Internal Error" and these errors are all fatal.
| Return Code | Value | Message | Fatality | OZ release |
|---|---|---|---|---|
RC_ESC | $01 | "Escape" | V2.2 - V4.0 | |
RC_TIM | $02 | "Timeout" | V2.2 - V4.0 | |
RC_UNK | $03 | "Internal Error" | Error is fatal | V2.2 - V4.0 |
RC_BAD | $04 | "Internal Error" | Error is fatal | V2.2 - V4.0 |
RC_MS | $05 | "Internal Error" | Error is fatal | V2.2 - V4.0 |
RC_NA | $06 | "Internal Error" | Error is fatal | V2.2 - V4.0 |
RC_ROOM | $07 | "No Room" | V2.2 - V4.0 | |
RC_HAND | $08 | "Bad handle" | Error is fatal | V2.2 - V4.0 |
RC_EOF | $09 | "End of file" | V2.2 - V4.0 | |
RC_FLF | $0A | "Filter full" | V2.2 - V4.0 | |
RC_OVF | $0B | "Overflow" | V2.2 - V4.0 | |
RC_SNTX | $0C | "Bad syntax" | V2.2 - V4.0 | |
RC_WRAP | $0D | "Wrap" | V2.2 - V4.0 | |
RC_PUSH | $0E | "Cannot satisfy request" | V2.2 - V4.0 | |
RC_ERR | $0F | "Internal Error" | Error is fatal | V2.2 - V4.0 |
RC_TYPE | $10 | "Unexpected type" | Error is fatal | V2.2 - V4.0 |
RC_PRE | $11 | "No room" | V2.2 - V4.0 | |
RC_ONF | $12 | "File not found" | V2.2 - V4.0 | |
RC_RP | $13 | "Read protected" | V2.2 - V4.0 | |
RC_WP | $14 | "Write protected" | V2.2 - V4.0 | |
RC_USE | $15 | "In use" | V2.2 - V4.0 | |
RC_FAIL | $16 | "Cannot satisfy request" | V2.2 - V4.0 | |
RC_IVF | $17 | "Bad filename" | V2.2 - V4.0 | |
RC_FTM | $18 | "File type mismatch" | V2.2 - V4.0 | |
RC_EXIS | $19 | "Already exists" | V2.2 - V4.0 | |
| RC_ADDR | $32 | "Unknown error" | Error is fatal | V2.2 - V4.0 |
| RC_SIZE | $33 | "Unknown error" | Error is fatal | V2.2 - V4.0 |
| RC_BANK | $34 | "Unknown error" | Error is fatal | V2.2 - V4.0 |
| RC_FRM | $35 | "Frame error" | Error is fatal | V2.2 - V4.0 |
| RC_PAR | $36 | "Parity error" | V2.2 - V4.0 | |
| RC_BTL | $37 | "Battery low" | V4.7 | |
| RC_VOZ | $38 | "OZ version not compatible" | Error is fatal | V5.0 |
RC_DVZ | $46 | "Divide by 0" | V2.2 - V4.0 | |
RC_TBG | $47 | "Number too big" | V2.2 - V4.0 | |
RC_NVR | $48 | "-ve root" | V2.2 - V4.0 | |
RC_LGR | $49 | "Log range" | V2.2 - V4.0 | |
RC_ACL | $4A | "Accuracy lost" | V2.2 - V4.0 | |
RC_EXR | $4B | "Exponent range" | V2.2 - V4.0 | |
RC_BDN | $4C | "Bad number" | V2.2 - V4.0 | |
RC_DRAW | $66 | "Redraw" | V2.2 - V4.0 | |
RC_QUIT | $67 | "Unknown error" | Error is fatal | V2.2 - V4.0 |
RC_SUSP | $69 | "Suspended" | V2.2 - V4.0 | |
| RC_VPL | $70 | "Flash VPP low" | V4.2 | |
| RC_BWR | $71 | "Flash/UV Eprom Write error" | V4.2 | |
| RC_BER | $72 | "Flash Erase error" | V4.2 | |
| RC_EPNE | $73 | "UV Eprom not fully cleared, erase again" | V4.5 | |
| RC_NFE | $80 | "Flash chip unknown" | V4.2 | |
| RC_NOZ | $81 | "Flash chip contains OZ" | V4.2 |
Related calls
GN_Err, display an interactive error box
OS_Erc, get error context
OS_Erh, set error handler
OS_Esc, examine special condition