7. ASOLib—OpenROAD Server Library : ASOLib User Classes : uc_osca (OpenROAD Server) : ReturnWithFatalError Method (OpenROAD Server)
 
Share this page                  
ReturnWithFatalError Method (OpenROAD Server)
This method is invoked when the OpenROAD Server program needs to report a fatal application error (a hard error) to the calling client. Error details are stored within the uc_osca instance, and the application is exited immediately.
Note:  The entry SCP is protected by an exit trap to prevent the OpenROAD Server from shutting down completely (all GSCPs are automatically protected by such an exit trap).
Parameters:
(p_i_error_no = integer,
 p_v_msg_txt = varchar(512))
Return Data Type: Not applicable—this method will cause the application to exit.
Example—ReturnWithFatalError Method:
IF i_world_ended = TRUE THEN
    OSCA.ReturnWithFatalError (p_i_error_no = 911,
                  p_v_msg_txt   = 'A serious system error has occurred');
    /* control never reaches here */
ENDIF;