HP 3000 Manuals HP 3000 Manuals
SDError
Returns an ASCII format error message to the calling program.
Syntax
SDError (Dcb,Status,Message,MessageLength,SubsysMessage,
SubsysMessageLength)
Parameters
Dcb Required input; type = DcbType
This parameter passes information about the
dictionary to this intrinsic. It is
initialized by the SDOpen intrinsic.
Status Required input; type = StatusType
This parameter is passed back from a System
Dictionary intrinsic call, and contains
information regarding the success or failure of
that call. SDError uses this information to
determine what message to return.
Message Output; type = MessageType
This parameter is a buffer containing a
left-justified, ASCII format error message.
MessageLength Output; type = 4 byte Integer
This parameter specifies the byte length of
Message. It will never exceed 72 characters.
SubsysMessage Output; type = MessageType
This parameter is a buffer which contains an
ASCII format message associated with a
subsystem error.
SubsysMessageLength Output; type = 4 byte Integer
This parameter specifies the byte length of
SubsysMessage. It will never exceed 72
characters. If the returned value is 0, no
subsystem message is returned.
Discussion
The actual message returned depends upon the contents of the Status
parameter of the System Dictionary intrinsic that was called.
The following restrictions apply when using this intrinsic:
1. Open mode--The dictionary can be opened in any mode, or not opened
at all when this intrinsic is called.
2. Security--The dictionary can be opened with any scope.