Module #03.05 : Deleting archived structures

All PVT documentation can be found under PHIGS Validation Tests - Overview. You may also return to the hierarchical table of topics covered by the PVT. For an explanation of the format of the individual module documentation, please see section 2.5 of the User's Guide.



DESCRIPTION: This module tests the various ways in which archived
structures and structure networks may be deleted.


SEMANTIC REQUIREMENTS:


SR1.  For <delete structures from archive>, the set of structures
to be deleted from the specified archive file contains exactly
those whose identifiers are in the specified list.
#F 147
#D 9.1.1
#S 4.4.7/32/3
#T P01/1 P01/2 P01/3 P01/4 P01/5 P04/1 #C Note that deleting a structure, but not all its ancestors, can
create a partial network in the archive file.
SR2.  For <delete structure networks from archive>, the set of
structures to be deleted from the specified archive file contains
those whose identifiers are in the specified list, and all their
descendants in the archive file.
#F 148
#D 9.1.1 9.1.2.4
#S 4.4.7/32/3
#T P02/1 P02/2 P02/3 P02/4 P02/5 P04/3 #C Note that deleting a structure, but not all its ancestors, can
create a partial network in the archive file.
SR3.  For <delete all structures from archive>, the set of
structures to be deleted from the specified archive file contains
all those currently in the specified archive file.
#F 149
#D 9.1.1
#S 4.4.7/32/3
#T P03/1 P04/2 
SR4.  If a structure S is in the specified set of a <delete ...
from archive> operation and S exists in the archive file, then S
is deleted from the archive file.
#F 147 148 149
#D 9.1.1
#S 4.4.7/32/4
#T P01/1 P01/4 P02/1 P02/4 P03/1 P04/1 P04/2 P04/3 #C This rule applies regardless of whether S is referenced by
another structure in archive.
SR5.  If a structure S is in the specified set of a <delete ...
from archive> operation and S does not exist in the archive file,
then no action is taken for S and warning 407 is signalled.
#F 147 148 149
#D 9.1.1
#S 4.4.7/32/4
#T P01/2 P01/3 P01/4 P01/5 P02/2 P02/3 P02/4 P02/5 
LOCAL DICTIONARY:

  Functions ---
  147: pdstar  <delete structures from archive>
  148: pdsnar  <delete structure networks from archive>
  149: pdasar  <delete all structures from archive>
 
  Data Structures ---
  9  ...  archive
  9.1  ...  archive_file
  9.1.1  ...  structure_identifier
  9.1.2  ...  list_of_structure_elements
  9.1.2.4  ...  execute_structure
 





PROGRAM 1:
Delete specified structures from archive

You may inspect either the
design or
code for this program.

PROGRAM 2:
Delete structure networks from archive

You may inspect either the
design or
code for this program.

PROGRAM 3:
Delete all structures from archive

You may inspect either the
design or
code for this program.

PROGRAM 4:
Deleting from archive when multiple archive files are open

You may inspect either the
design or
code for this program.

End of documentation for 03.05