IOF Error Messages

Error Numbers

Each error condition in IOF is associated with a unique error number. Each error number has a short message and a long message. The short message is displayed in the short message area at the top of the panel. The long message is displayed by entering HELP while a short message is being displayed.

Error numbers can be very useful in clists and REXX execs. If an IOF error occurs in an IOF clist, the clist variable &LASTCC will be set to the corresponding error number. The REXX rc variable is set to the error number.

Warning Command

The IOF WARNING command can be used from any IOF panel to display both the short and the long message associated with an error number. This command is also useful within REXX execs and clists to cause a message to be displayed after the exec or clist terminates.

Syntax

WARNING error#

error#. The IOF error number to be displayed.

Assigning the Long Error Message to a REXX or Clist Variable

The long error message can be assigned to a clist or REXX variable with the following statement:

TSICOPY      NAME(MESSAGE) TO(CLIST/REXX) SECTION(PANEL)

It is often useful to display to the REXX or clist application the specific error message that would have been displayed to the terminal when an error occurs.

Table of Contents