Guardian Procedure Calls Reference Manual

Returned Value
INT
Outcome of the call:
Success.0
A syntax error occurred in name.2049
Define already exists.2050
Define does not exist.2051
Unable to obtain file-system buffer space.2052
Unable to obtain physical memory.2053
Bounds error in define-name.2054
Working set is incomplete, a required attribute is missing.2057
Working set is inconsistent. Two or more attributes have conflicting values. The checknum parameter identifies
the consistency check that failed.
2058
Working set is invalid.2059
Missing parameter.2066
The DEFMODE of the process does not permit the addition of the DEFINE.2069
For other error values associated with DEFINEs, see the Guardian Procedure Errors and Messages
Manual.
Considerations
• If an error occurs, the DEFINE is not created or replaced.
• If the replace option is used, the named DEFINE must exist.
• The context-change count is incremented each time procedure DEFINEADD is invoked and a
consequent change to the process' context occurs. If an error occurs, the count is not
incremented.
Example
STRING .EXT define^name[0:23];
.
.
define^name ':=' ["=mydefine "];
error := DEFINEADD( define^name, 1 );
IF error <> DEOK THEN ... ;
Related Programming Manual
For programming information about the DEFINEADD procedure, see the Guardian Programmer's
Guide.
260 Guardian Procedure Calls (D-E)