GN_Esp, Return an extended pointer to a system error message

Register parameters

RST 20H, DEFW $4C09

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

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