Guardian Procedure Calls Reference Manual

DEFINERESTORE Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Related Programming Manual
Summary
The DEFINERESTORE procedure uses a saved version of a DEFINE in the user's buffer to create
an active DEFINE. If an active DEFINE of the same name already exists, it can optionally be
replaced. The saved DEFINE can also be placed in the working set without its name.
Syntax for C Programmers
#include <cextdecs(DEFINERESTORE)>
short DEFINERESTORE ( short *buffer
,[ short options ]
,[ char *define-name ]
,[ short _near *checknum ] );
Syntax for TAL Programmers
error := DEFINERESTORE ( buffer ! i
,[ options ] ! i
,[ define-name ] ! o
,[ checknum ] ); ! o
Parameters
buffer
input
INT .EXT:ref:*
contains the saved form of the DEFINE.
options
input
INT:value
indicates whether the saved DEFINE should be restored to the working attribute set or to the
active set of DEFINEs. If the latter, it also indicates whether or not the DEFINE replaces an
existing DEFINE or is simply added to the active set.
are reserved and must be 0.<0:13>
place the saved DEFINE in the working set. If options.<14> is 1, then options.<15> is
ignored.
1<14>
make the saved DEFINE an active DEFINE.0
replace an existing DEFINE. If a DEFINE of the same name does not exist, an error is returned.1<15>
add the DEFINE. If a DEFINE of the same name exists, return an error.0
DEFINERESTORE Procedure 281