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.

GERSTR - restore data from save file.

Usage:

Where:

Description:

See Also: