Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-43
DEFINESAVE Procedure
<0:14> are reserved and must be 0
<15> 1 save the current working set and name it define-name
0 save the active DEFINE named by
define-name
If
option is omitted, then the active DEFINE named by define-name is saved.
Considerations
•
The DEFINE saved in buffer is in internal form. You should not modify it. If you
change it in any way, DEFINE RESTORE might not be able to restore it.
•
If you are saving the working set, define-name may contain the name of an
active DEFINE; however, the active DEFINE is not saved. Instead, the working set
is saved and is given
define-name as its name in the internal form.
•
The working set can be saved if it is inconsistent, invalid or incomplete. A warning
is returned in
error.
•
If the user’s buffer is too small, error will contain 2076 and deflen will contain
the buffer size required, in bytes. To reduce the possibility of getting error 2076,
allocate a buffer of 4096 bytes.
Related Programming Manual
For programming information about the DEFINESAVE procedure, refer to the Guardian
Programmer’s Guide.