Guardian Procedure Calls Reference Manual

OLDSYSMSG_TO_NEWSYSMSG_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Summary
The OLDSYMSG_TO_NEWSYSMSG_ procedure converts a C-series format system message to its
D-series equivalent. See Considerations (page 896) for a list of the messages that this procedure
accepts and produces.
Syntax for C Programmers
#include <cextdecs(OLDSYSMSG_TO_NEWSYSMSG_)>
short OLDSYSMSG_TO_NEWSYSMSG_ ( char *oldmsg
,short length
,char *newmsg
,short maxlen
,short *newmsg-length
,[ short *error-detail ] );
Syntax for TAL Programmers
error := OLDSYSMSG_TO_NEWSYSMSG _ ( oldmsg:length ! i:i
,newmsg:maxlen ! o:i
,newmsg-length ! o
,[ error-detail ] ); ! o
Parameters
oldmsg:length
input:input
STRING .EXT:ref:*, INT:value
is the message to be converted. oldmsg must be exactly length bytes long.
newmsg:maxlen
output:input
STRING .EXT:ref:*, INT:value
returns the equivalent D-series system message, if any. maxlen is the length in bytes of the
string variable newmsg.
newmsg-length
output
INT .EXT:ref:1
returns the actual length of the returned D-series system message, or 0 if the supplied message
has no equivalent.
OLDSYSMSG_TO_NEWSYSMSG_ Procedure 895