Guardian Procedure Calls Reference Manual

DEFINESAVE Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Related Programming Manual
Summary
The DEFINESAVE procedure copies an active DEFINE or the current working attribute set into a
user buffer. The saved DEFINE can later be made an active DEFINE or be placed into the working
set by using DEFINERESTORE.
Syntax for C Programmers
#include <cextdecs(DEFINESAVE)>
short DEFINESAVE ( const char *define-name
,short *buffer
,short buflen
,short *deflen
,[ short option ] );
Syntax for TAL Programmers
error := DEFINESAVE ( define-name ! i
,buffer ! o
,buflen ! i
,deflen ! o
,[ option ] ); ! i
Parameters
define-name
input
STRING .EXT:ref:24
is a DEFINE name. The name is left-justified and padded on the right with blanks. Trailing
blanks are ignored. Depending on the value of option, define-name contains the name
of an existing DEFINE or the name to be given to the working set.
buffer
output
INT .EXT:ref:*
is the data array provided by the calling program to contain the saved DEFINE.
buflen
input
INT:value
is the length of the array buffer in bytes.
DEFINESAVE Procedure 285