The subroutines in this category allow your application to modify the error handling characteristics of the graPHIGS API system. By default, the graPHIGS API gives the error handling function control when the graPHIGS API detects an error. The graPHIGS API provides the default error handling function. However, your application can provide an alternative error handling function which supersedes the default and receives control when the graPHIGS API detects an error.
The default error handling function provided by the graPHIGS API calls the Error Logging subroutine function. An application program supplied Error Handling function may invoke inquiry subroutines, the Error Logging function, and/or the Emergency Close PHIGS subroutine.
If desired, you can use the Set Error Handling Mode subroutine to set error handling OFF. When your application sets error handling OFF, processing continues until the graPHIGS API reaches a terminating condition. Generally, error handling should remain ON in a program development environment. By default, the graPHIGS API sets error handling to ON.
Purpose
Use Emergency Close PHIGS to terminate all PHIGS processing for this application process. The graPHIGS API closes any open structure and updates and closes all open workstations. The graPHIGS API detaches all resources attached to or created by your application. The graPHIGS API closes all PHIGS files and releases all system resources, such as storage or locks. The graPHIGS API sets the PHIGS system state to PHIGS Closed. Your application can reopen PHIGS by invoking the Open PHIGS subroutine ( ).
Language Bindings
| pemergency_close_phigs () |
| PECLPH |
Errors
None
Related Subroutines