GERSTR - restore data from save file.
Usage:
mme gerstr
bci 1,XXXXXX
zero BUFLOC,ERR_RTN
zero RETURN,0
Where:
- XXXXXX
- is the unique identifier that was attached to the desired data at the time it
was saved by MME GESAVE.
This will be six BCD characters.
- BUFLOC
- points to the beginning of the memory where the input data should be placed.
If this is zero, the data will be stored in the BUFLOC specified by the
original MME GESAVE, minus the INCR specified by the original MME GESAVE.
See "expl mme gesave" for more details.
- ERR_RTN
- is the address of the routine that should be called if MME GERSTR runs into an
error.
If this is zero, MME GERSTR will abort the program if an error occurs.
- RETURN
- is the address to which MME GERSTR should return if it is successful.
If this is zero, MME GERSTR will use the return address specified by the MME
GESAVE that saved the data.
- Q register
- should contain the file code of the save file in bits 24-35.
Description:
MME GERSTR restores data that was previously written to a save file via MME
GESAVE.
MME GERSTR will not return to the caller until the input operation is
complete.
When MME GERSTR returns, the A register will contain the following.
- Upper Half
- points to the start of the restored data.
- Lower Half
- is the length of the restored data (in words).
The upper half of the Q register will contain the normal RETURN address
specified for the call.
(In the event of an error, this lets the error handling routine figure out
where the MME GERSTR was executed.)
If an error occurs, ERR_RTN is called.
The lower half of the Q register will contain one of the following octal error
codes.
52 I/O limits error
53 I/O error
54 no PAT for CALL/SAVE
55 bad device for CALL/SAVE
56 non-random file
60 checksum error
61 lower GERSTR origin used
65 improper call
MME GERSTR should not be used during a courtesy call.
See Also:
expl mme gesave
Copyright © 2000, Thinkage Ltd.