Guardian Procedure Calls Reference Manual

If options is omitted, the default value of 0 is used; in other words, the saved DEFINE is
added to the set of active DEFINEs.
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. For a list of DEFINE consistency check numbers, see the Guardian Procedure Errors and
Messages Manual.
Returned Value
INT
Outcome of the call:
Success.0
DEFINE already exists and options.<15> is 0 or options is omitted.2050
DEFINE does not exist and options.<15> is 1.2051
Unable to obtain file system buffer space.2052
Unable to obtain physical memory.2053
Bounds error on buffer, define-name, or checknum parameter.2054
Invalid attribute in saved DEFINE.2055
DEFINE or working set is incomplete. A required attribute is missing.2057
DEFINE or working set is inconsistent. Two or more attributes have conflicting values. The checknum parameter
identifies the consistency check that failed.
2058
DEFINE or working set is invalid.2059
Parameter missing.2066
Attribute contained an invalid value.2067
Saved DEFINE was of invalid CLASS.2068
Attempt to add a DEFINE that does not fall under the current DEFMODE setting.2069
option.<0:13> is not 0.2075
buffer or define-name is in invalid segment.2077
buffer does not contain a valid saved DEFINE.2078
For other error values associated with DEFINEs, see the Guardian Procedure Errors and Messages
Manual.
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.
282 Guardian Procedure Calls (D-E)