Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)

Guardian Procedure Calls Reference Manual—522629-013

3-35

CHECKDEFINE Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

Considerations

Example

Summary

This 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, refer to the

Guardian Programmer’s Guide.

Syntax for TAL Programmers

Parameters

status returned value

INT

returns a status word encoded as follows:

<0:7> = 0 Operation successful

<0:7> = 1 Could not communicate with backup process, then <8:15> = file-

system error number

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.

Considerations

•

If the define-name parameter is omitted, the working attribute set of the backup

is updated to match that of the primary process.

status := CHECKDEFINE [ ( define-name ) ]; ! i