FSH INTERR: Difference between revisions
Created page with "This function signals an internal error. ==Syntax== FSH_INTERR(pMsg, cbMsg) ==Parameters== ;pMsg: is a pointer to the message text. ;cbMsg: is the length of the mes..." |
m r |
||
| Line 1: | Line 1: | ||
This function signals an internal error. | {{DISPLAYTITLE:FSH_INTERR}} | ||
This function signals an internal error. | |||
==Syntax== | ==Syntax== | ||
FSH_INTERR(pMsg, cbMsg) | FSH_INTERR(pMsg, cbMsg) | ||
==Parameters== | ==Parameters== | ||
;pMsg: is a pointer to the message text. | ;pMsg: is a pointer to the message text. | ||
;cbMsg: is the length of the message text. | |||
==Returns== | ==Returns== | ||
There are no error returns. | There are no error returns. | ||
==Calling Sequence== | ==Calling Sequence== | ||
<PRE> | <PRE> | ||
| Line 16: | Line 18: | ||
char far * pMsg; | char far * pMsg; | ||
unsigned short cbMsg; | unsigned short cbMsg; | ||
</PRE> | |||
==Remarks== | ==Remarks== | ||
For reliability, if an FSD detects an internal inconsistency during normal operation, the FSD shuts down the system as a whole. This is the safest thing to do since it is not clear if the system as a whole is in a state that allows normal execution to continue. | For reliability, if an FSD detects an internal inconsistency during normal operation, the FSD shuts down the system as a whole. This is the safest thing to do since it is not clear if the system as a whole is in a state that allows normal execution to continue. | ||
When an FSD calls FSH_INTERR, the address of the caller and the supplied message is displayed on the console. The system then halts. | When an FSD calls FSH_INTERR, the address of the caller and the supplied message is displayed on the console. The system then halts. | ||
The code used to display the message is primitive. The message should contain ASCII characters in the range 0x20-0x7E, optionally with 0x0D and 0x0A to break the text into multiple lines. | The code used to display the message is primitive. The message should contain ASCII characters in the range 0x20-0x7E, optionally with 0x0D and 0x0A to break the text into multiple lines. | ||
The FSD must preface all such messages with the name of the file system. | The FSD must preface all such messages with the name of the file system. | ||
The maximum message length is 512 characters. Messages longer than this are truncated. | The maximum message length is 512 characters. Messages longer than this are truncated. | ||
;Note: | ;Note: OS/2 does not validate input parameters. An FSD, therefore, should call FSH_PROBEBUF where appropriate. | ||
[[Category:IFS Interfaces]] | [[Category:IFS Interfaces]] | ||
Latest revision as of 04:43, 20 February 2020
This function signals an internal error.
Syntax
FSH_INTERR(pMsg, cbMsg)
Parameters
- pMsg
- is a pointer to the message text.
- cbMsg
- is the length of the message text.
Returns
There are no error returns.
Calling Sequence
void far pascal FSH_INTERR(pMsg, cbMsg) char far * pMsg; unsigned short cbMsg;
Remarks
For reliability, if an FSD detects an internal inconsistency during normal operation, the FSD shuts down the system as a whole. This is the safest thing to do since it is not clear if the system as a whole is in a state that allows normal execution to continue.
When an FSD calls FSH_INTERR, the address of the caller and the supplied message is displayed on the console. The system then halts.
The code used to display the message is primitive. The message should contain ASCII characters in the range 0x20-0x7E, optionally with 0x0D and 0x0A to break the text into multiple lines.
The FSD must preface all such messages with the name of the file system.
The maximum message length is 512 characters. Messages longer than this are truncated.
- Note
- OS/2 does not validate input parameters. An FSD, therefore, should call FSH_PROBEBUF where appropriate.