Guardian Procedure Calls Reference Manual

CHECKDEFINE Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Returned Value
Considerations
Example
Summary
The CHECKDEFINE procedure is used to update a backup process with a DEFINE that was changed
in the primary process.
Syntax for C Programmers
This passive backup procedure is not supported in C programs. For a comparison of active backup
and passive backup, see the Guardian Programmer's Guide.
Syntax for TAL Programmers
status := CHECKDEFINE [ ( define-name ) ]; ! i
Parameter
define-name
input
STRING .EXT:ref:24
is the 24-byte array that contains the name of the DEFINE to be sent to the backup process.
The name is left-justified and padded on the right with blanks. Trailing blanks are ignored.
Returned Value
INT
A status word encoded as follows:
Operation successful.0<0:7> =
Could not communicate with backup process, then <8:15> = file-system error number.1<0:7> =
Considerations
• If the define-name parameter is omitted, the working attribute set of the backup is updated
to match that of the primary process.
• If the named DEFINE does not exist in the primary at the time of the call, then CHECKDEFINE
will cause deletion of the DEFINE of the given name in the backup process if one exists.
Otherwise, the named DEFINE will be copied to the backup, replacing the backup's version
of the DEFINE if it has one.
• If the define-name parameter is supplied, but the first two bytes have the value 255 (-1
when treated as a word), then all DEFINEs in the backup process will be deleted.
136 Guardian Procedure Calls (C)