NAME

DsSetSafeFlag − Set the safe flag

SYNOPSIS

C:

void DsSetSafeFlag(flag)
DtFlag flag ;

FORTRAN:

CALL DSSSF(FLAG)
INTEGER∗4 FLAG

DESCRIPTION

DsSetSafeFlag sets the safe flag to the value specified by the parameter flag.  The safe flag is a debugging tool for the application programmer. 

When the safe flag is set to DcTrue <DCTRUE>, all deleted objects are treated so that any private data associated with the object is released as usual.  In this case, when an object is deleted, the type of object is set to DcObjectDeleted <DCODEL>.  Whenever such an object is accessed, an error is generated and the user can determine why the illegal reference was made. 

If the flag is set to DcFalse <DCFALS>, both the object header and any private data of all deleted objects are freed immediately.  If the safe flag is changed from DcTrue <DCTRUE> to DcFalse <DCFALS>, all object headers of type DcObjectDeleted <DCODEL> are freed. 

An application should not refer to an object’s handle once the application has released the object using DsReleaseObj <DSRO>. 

DEFAULTS

The default value of the safe flag is DcTrue <DCTRUE>. 

SEE ALSO

DsInqSafeFlag(3D)

September 02, 1992