_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.