_TEST_SAVE_BIT - test whether a SEGID is savable.

(GCOS8 only)

Usage:

C:
   #include <climb.h>
   status = _test_save_bit(ptr);

PL6:
   DCL X_TEST_SAVE_BIT ENTRY(1) ALTRET;
   X_TEST_SAVE_BIT(ptr);

Where:

const void *ptr;

points anywhere into the segment whose SEGID you want to test. "_test_save_bit" extracts the SEGID from the pointer value.

int status;

is 1 if the SEGID is flagged as savable and 0 otherwise.

Description:

"_test_save_bit" determines if a SEGID in the Argument Stack will be saved in a call to "_save_arg_stack". Unsavable SEGIDs include those allocated with "_gtlseg", ones with the save permission bit turned off, and ones that were allocated directly by the program without going through "_gtseg".

See Also:

expl nsc lib _gtseg

general SEGID allocation routine.

expl nsc lib _gtlseg

for allocating a SEGID that will only be used during the current invocation of the program (one that disappears over an OCLIMB).

expl nsc lib _gtsseg

for marking a Linkage Segment SEGID as busy.

expl nsc lib _save_arg_stack

for saving the Argument Stack before an OCLIMB.

expl nsc lib _restore_arg_stack

for restoring the Argument Stack after an OCLIMB.

Copyright © 1996, Thinkage Ltd.