define external counter function get-exception-status
           value io-exception ex

This function allows you to retrieve the current status of the "io-exception" opaque object.

Argument:

• "ex". This is the "io-exception" object whose status you want to retrieve.

Example:

  ; Declaring and using an "io-exception" object to capture the error status,
  ; if any, of reading from a UTF-16 encoded file.

  include "ioex.xin"
  process
     local io-exception e
     submit utf16-input-file "widetext.txt" exceptions-to e
     put #error "I/O exception on widetext.txt%n"
         when get-exception-status e != 0
     done