Previous Next Up Title Contents Index Functions Index Top Library

DELETE STRUCTURE NETWORK

PDSN


CALL SEQUENCE

CALL PDSN (STRID, REFHNF)

INPUT PARAMETERS

INTEGER STRID
Designates the structure which is the starting point of the structure network to be destroyed.
INTEGER REFHNF
Determines how the structures encountered in the network and which are referenced in other structures must be processed.

PHIGS STATE

(PHOP, *, *, *).

EFFECT

DELETE STRUCTURE NETWORK deletes in the structure specified by STRID , and all the structures referenced directly or indirectly by this structure, from the centralized structure store (CSS).

A structure network is a hierarchical set of structures in which the initial structure refers to the other structures which in their turn refer to other structures and so on. As several EXECUTE STRUCTURE functions can refer to the same structure, it is possible that the structure to be destroyed in a network is already referred to by another structure network. The parameter REFHNF controls the way in which the structures to be destroyed are processed, in case they are also referred to in other networks.

If REFHNF = PDELE then DELETE STRUCTURE NETWORK destroys all the structures referred to by the structure network beginning with STRID , even if these structures are referred to by other structures outside this network.

If REFHNF = PKEEP then DELETE STRUCTURE NETWORK does not destroy the structures in the network which are referred to by structures not depending on this network.

If STRID does not exist, the function has no effect and does not generate an error.

ERRORS

2
Ignoring function, function requires state (PHOP, *,*,*)

SEE ALSO

open structure, empty structure, delete element, delete element range, delete element between labels, delete structure, delete all structures, unpost structure, inquire structure identifiers, inquire structure status


Previous Next Up Title Contents Index Functions Index Top Library