====== FSMSG subroutine   ======


 
==== Description ====
 
Displays an error message, typically after an OpenInsight I/O command such as Open, Read, or Write failed.  Available in OpenInsight 4.1.2 and later versions.
 
==== Syntax ====
 
FSMSG(//messageid)//
 
==== Parameters ====
 
The FSMSG subroutine has the following parameter.

^Parameter^Description^
|//messageid//|Optional.  The text of the system message with the passed @ID.  Typically, you do not use this parameter because you want to display the system error message text by calling FSMSG() with no parameter.|
 
==== See Also ====
 
[[get_status|Get_Status()]], [[set_fserror|Set_FSError()]], [[chapter_reverror.dat_file|RevError.Dat]], [[set_status|Set_Status() function]]
 
==== Example ====
 
<code>
Open 'DUMMY' to dummyfilevar else

   call fsmsg()

   return 0

end
</code>

If the table 'DUMMY' is not attached, the following system message displays

{{{guides:programming:programmers_reference_manual:unattached.gif?330x117}}

From the System Monitor, if you would like to view the text of a system error message (such as 401), enter:

<code>
RUN FSMSG 401
</code>