Guardian Procedure Calls Reference Manual

DEFINEVALIDATEWORK Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Returned Value
Considerations
Related Programming Manual
Summary
The DEFINEVALIDATEWORK procedure can be used to check the working set for consistency.
Syntax for C Programmers
#include <cextdecs(DEFINEVALIDATEWORK)>
short DEFINEVALIDATEWORK ( short _near *checknum );
Syntax for TAL Programmers
error := DEFINEVALIDATEWORK ( checknum ); ! o
Parameter
checknum
output
INT:ref:1
contains the consistency check number that failed when 2058 is returned in error. For a list
of DEFINE consistency check numbers, see the description of the checknum parameter in the
DEFINEADD Procedure (page 259).
Returned Value
INT
Outcome of the call:
Success.0
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
For other error values associated with DEFINEs, see the Guardian Procedure Errors and Messages
Manual.
Considerations
• Subsequent calls to DEFINEREADATTR will return info-word.<13> = 1 if the attribute was
involved in an inconsistency.
• If the last call to DEFINEREADATTR showed that info-word.<13> was set and the DEFINE
is currently valid, then a call to DEFINEVALIDATEWORK will clear the flag.
294 Guardian Procedure Calls (D-E)