ON_IOERROR Procedure

Specifies a statement to jump to if an I/O error occurs in the current procedure.

ON_IOERROR, label

label The statement to jump to. Note that label is not a string variable, but is rather the statement label (without the trailing colon).

None.

Normally when an input/output error occurs, an error message is printed and program execution is stopped. If ON_IOERROR is called and an I/O related error later occurs in the same procedure activation, control is transferred to the designated statement with the error code stored in the system variable !Err. The text of the error message is contained in the system variable !Err_String.

ON_IOERROR, null

; The effect of ON_IOERROR is canceled by using null as the label.

!Err, !Err_String, ON_ERROR, OPEN (UNIX/OpenVMS), OPEN (Windows), READ, RETALL, RETURN, STOP, WRITEU

Additional information can be found in Description of Error Handling Routines in Chapter 10 of the PV-WAVE Programmer's Guide.

For more information on system variables, see Chapter 4, System Variables.

For more information on statement labels, see Statement Labels in Chapter 4 of the PV-WAVE Programmer's Guide.

For background information, see Chapter 8, Working with Data Files, in the PV-WAVE Programmer's Guide.