Module #09.01.09.02 : Archive and retrieve errors handled by system

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 that the functions which are related
to archive or retrieve generate the specified error codes if they are executed
in an incorrect conditions.  The error is handled by the default system error
handling subroutine. Also, this module tests the requirement that no side
effects are generated.

SEMANTIC REQUIREMENTS:


SR1. If function <open archive file> is called, and a specified archive file cannot be opened, then error 400 is generated and the function is ignored.
#F 135
#D 9.1 8.1
#S 4.12/109/6
#T

SR2. If function <open archive file> is called, and openning this archive file would exceed the maximum number of simultaneously open archive files, then error 401 is generated and the function is ignored.
#F 135
#D 2.4 9.1 8.1
#S 4.12/109/6
#T P01/1 P01/2

SR3. If function <open archive file> is called, and the specified archive file identifier already is in use, then error 402 is generated and the function is ignored.
#F 135
#D 4.6.2 9.1 8.1
#S 4.12/109/6
#T P02/1 P02/2

SR4. If function <open archive file> is called, and the archive file is not a PHIGS archive file, then error 403 is generated and the function is ignored.
#F 135
#D 9.1 8.1
#S 4.12/109/6
#T

SR5. If functions <close archive file> - <archive all structures>, <retrieve structure identifiers> - <retrieve all structures>, <delete structures from archive> - <delete all structures from archive> are called, and the specified archive file is not open, then error 404 is generated and the function is ignored.
#F 136-139 141-144 147-149
#D 4.6.1 9.1 8.1
#S 4.12/109/6
#T P03/1 P03/2 P03/3 P03/4 P03/5 P03/6 P03/7 P03/8 P03/9 P03/10 P03/11
#T P03/12 P03/13 P03/14 P03/15

SR6. If functions <archive structures> - <archive all structures>, <retrieve structures> - <retrieve all structures> are called, and name conflict occurs while conflict resolution flag has value ABANDON, then error 405 is generated and the function is ignored.
#F 137-139 142-144
#D 4.7 4.8 9.1 8.1
#S 4.12/109/6
#T P04/1 P04/2 P04/3 P04/4 P04/5 P04/6 P04/7 P04/8 P04/9

SR7. If functions <archive structures> - <archive all structures> are called, and the archive file is full, then warning error 406 is generated and any structures that were archived were archived in total.
#F 137-139
#D 9.1 8.1
#S 4.12/109/6
#T

SR8. If functions <delete structures from archive>, <delete structure networks from archive> are called, and some of the specified structures do not exist on the archive file, then warning error 407 is generated.
#F 147 148
#D 9.1 9.1.1 8.1
#S 4.12/109/6
#T P05/1 P05/2 P05/3

SR9. If functions <retrieve structures>, <retrive structure networks> are called, and some of the specified structures do not exist on the archive file, then warning error 408 is generated and PHIGS will create empty structure in the place.
#F 142 143
#D 9.1 9.1.1 8.1
#S 4.12/109/6
#T P06/1 P06/2 P06/3
LOCAL DICTIONARY:

  Functions ---
  135: poparf  <open archive file>
  136: pclarf  <close archive file>
  137: parst   <archive structures>
  138: parsn   <archive structure networks>
  139: parast  <archive all structures>
  141: prsid   <retrieve structure identifiers>
  142: prest   <retrieve structures>
  143: presn   <retrieve structure networks>
  144: prast   <retrieve all structures>
  147: pdstar  <delete structures from archive>
  148: pdsnar  <delete structure networks from archive>
  149: pdasar  <delete all structures from archive>
 
  Data Structures ---
  2  ...  phigs_description_table
  2.4  ...  maximum_number_of_simultaneously_open_archive_files
  4  ...  phigs_state_list
  4.6  ...  set_of_open_archive_files
  4.6.1  ...  archive_file
  4.6.2  ...  archive_file_identifier
  4.7  ...  archival_conflict_resolution_flag
  4.8  ...  retrieval_conflict_resolution_flag
  8  ...  phigs_error_state_list
  8.1  ...  error_state
  9  ...  archive
  9.1  ...  archive_file
  9.1.1  ...  structure_identifier
 



PROGRAM 1: Error 401 handled by system

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


PROGRAM 2: Error 402 handled by system

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


PROGRAM 3: Error 404 handled by system

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


PROGRAM 4: Error 405 handled by system

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


PROGRAM 5: Error 407 handled by system

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


PROGRAM 6: Error 408 handled by system

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

End of documentation for 09.01.09.02