Module #09.01 : General error handling capabilities

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 error handling capabilities which
the PHIGS implementation provides.

SEMANTIC REQUIREMENTS:


SR1.   <set error handling mode> turns error handling mode OFF or ON.
#F 318
#D 8.2
#S 4.12/110/3
#T P01/2 P01/3 P02/1 P02/2 P03/1 P04/1 
SR2.   The default error handling mode is ON.
#F
#D 8.2
#S 4.12/110/3
#T P01/1 
SR3.   <inquire error handling mode> reports the correct error handling
mode as OFF or ON.
#F 314
#D 8.2
#S 4.12/110/3
#T P01/1 P01/2 P01/3 
SR4.   The implementation provides a default <error handling> function.
#F 316
#D 8 8.1 8.2 8.3
#S 4.12/109/1 4.12/109/7
#T P03/1 P04/1 
SR5.   The implementaion provides a means for the application program to
specify its own <error handling> function.
#F 316
#D
#S 4.12/109/7 4.12/109/7
#T P02/1 
SR6.   If the application program does not provide an <error handling>
function, it uses the default <error handling> function.
#F 316
#D
#S 4.12/109/7
#T P03/1 
SR7.   If an error is generated and error handling mode is ON, the <error
handling> function currently in effect is called, and the appropriate error
number, function identifier, and error file are passed to it as parameters.
#F 316
#D 8.2
#S 4.12/109/7
#T P02/1 P03/1 
SR8.   The default <error handling> function calls <error logging> function
using the same parameters as passed to it.
#F 316 317
#D
#S 4.12/109/8
#T P03/1 
SR9.   The <error logging> function writes an error message and PHIGS function
identifier on the error file, then returns to the calling function.
#F 317
#D 8.3
#S 4.12/110/1
#T P03/1 P05/1 
SR10.   If an error is generated and error handling mode is OFF, no <error
handling> function is called.
#F 316
#D 8.2
#S 4.12/110/3
#T P02/2 P04/1 
SR11.  When <emergency close phigs> is called, the open structure is closed,
all open archive files are closed, all open workstations are updated and
closed, and PHIGS is closed.
#F 315
#D 4.1 4.2 4.6 1.1 1.2 1.3 1.4
#S 4.12/109/5
#T P06/1
LOCAL DICTIONARY:

  Functions ---
  314: pqerhm  <inquire error handling mode>
  315: peclph  <emergency close phigs>
  316: perhnd  <error handling>
  317: perlog  <error logging>
  318: pserhm  <set error handling mode>
 
  Data Structures ---
  1  ...  operating_state
  1.1  ...  system_state
  1.2  ...  workstation_state
  1.3  ...  structure_state
  1.4  ...  archive_state
  4  ...  phigs_state_list
  4.1  ...  set_of_open_workstations
  4.2  ...  name_of_open_structure
  4.6  ...  set_of_open_archive_files
  8  ...  phigs_error_state_list
  8.1  ...  error_state
  8.2  ...  error_handling_mode
  8.3  ...  error_file

PROGRAM 1: Testing the error handling mode

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

PROGRAM 2: User error handling capabilities

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

PROGRAM 3: Default error handling with error mode ON

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

PROGRAM 4: Default error handling with error mode OFF

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

PROGRAM 5: Error logging function for default error handling

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

PROGRAM 6: Emergency close phigs

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

End of documentation for 09.01