MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 6 293
Command Definitions (FLUSHLOG-GETUSERMODE)
GENMESSAGE
GENMESSAGE
NM and CM callable (differences noted below).
Provides access to messages in catalogs that were formatted with the MAKECAT utility.
Syntax
I16 I16V I16V I16V
msglength :=GENMESSAGE( filenum,setnum,msgnum ,
CA I16V I16V
buffer,buffersize,parmask ,
* * * *
param1,param2,param3,param4
* I16V
param5,msgdestination,
I16
errornum );
Functional Return
msglength 16-bit signed integer (assigned functional return)
Returns the length of the message (in bytes).
Parameters
filenum 16-bit signed integer by value (required)
Passes the file number that specifies the message catalog.
setnum Positive 16-bit signed integer by value (required)
Passes the message set number within the catalog (>0,<63).
msgnum Positive 16-bit signed integer by value (required)
Passes the message number within the message set (>0,<32767).
buffer character array (optional)
Returns the assembled message.
buffersize 16-bit signed integer by value (optional)
Returns the length of
buffer .If buffer is specified, the length is in bytes.
If
buffer is not specified, returns the length (in bytes) of the records to be
written to the destination file.
Default: 72 bytes
(For a single-line message, the combined length of the message number, a
blank space separator, and message text must not exceed the default
buffer size of 72 bytes.)