Guardian Procedure Calls Reference Manual

DEFINEADD Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
The DEFINEADD procedure adds a DEFINE to the calling process' context using the attributes in
the working set. It can be used to replace an existing DEFINE with the attributes in the working
set.
Syntax for C Programmers
#include <cextdecs(DEFINEADD)>
short DEFINEADD ( const char *define-name
,[ short replace ]
,[ short _near *checknum ] );
Syntax for TAL Programmers
error := DEFINEADD ( define-name ! i
,[ replace ] ! i
,[ checknum ] ); ! o
Parameters
define-name
input
STRING .EXT:ref:24
is the 24-byte array that contains the name of the DEFINE to be added or replaced in the
working set. The name is left-justified and padded on the right with blanks. Trailing blanks are
ignored.
replace
input
INT:value
if present and has a value of 1, then the attributes of the DEFINE that is named by
define-name are replaced with the attributes in the working set.
checknum
output
INT:ref:1
contains the number of the consistency check that failed when 2058 is returned in error. For
a list of DEFINE consistency check numbers, see the Guardian Procedure Errors and Messages
Manual.
DEFINEADD Procedure 259