Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-38
DEFINERESTORE Procedure
define-name output
STRING .EXT:ref:24
if present, contains the name of the saved DEFINE added to the current context.
The name is either the name of the DEFINE when it was saved or the name given
the working set when it was saved.
checknum output
INT:ref:1
if present, and the DEFINE is inconsistent, contains the number of the consistency
check that failed. Refer to the
Guardian Procedure Errors and Messages Manual
for a list of DEFINE consistency check numbers.
Considerations
•
The buffer must contain a valid internal form of a DEFINE, as created by
DEFINESAVE. If the buffer does not appear to contain a valid saved DEFINE, an
error is returned and the DEFINE is not added to the current set or to the working
set.
•
If DEFINERESTORE encounters any error condition while attempting to restore
the saved DEFINE to the active set, it does not perform the restore.
•
DEFINEs saved by later releases of the operating system will be restorable only if
the class of the DEFINE is supported on the earlier RVU and the attributes and
their values are supported on the earlier RVU.
•
If DEFINERESTORE encounters error 2057, 2058, or 2059 (DEFINE invalid,
incomplete, or inconsistent) while attempting to restore the saved DEFINE to the
working attribute set, it still performs the restore. If it encounters any other errors,
however, it leaves the working attribute set unchanged.
•
An attempt to restore a saved DEFINE into the active set does not affect the
working attribute set or the background set under any circumstances.
•
Since the DEFAULTS DEFINE always exists, it cannot be added. If the
DEFAULTS DEFINE is saved, the replace option must be used to restore it.
Related Programming Manual
For programming information about the DEFINERESTORE procedure, refer to the
Guardian Programmer’s Guide.