MPE/iX Intrinsics Reference Manual (32650-90875)
Chapter 4 67
Command Definitions (ABORTSESS - FCLOSE)
CATREAD
CATREAD
NM and CM callable.
Provides access to messages in an application message facility formatted by the GENCAT
utility. The CATOPEN intrinsic opens the message catalog.
Syntax
I16 I32V I16V I16V
msglength
:=CATREAD(
catindex,setnum,msgnum,
U16A CA I16V
catstatus,buffer,buffersize,
CA CA CA CA CA
parm1,parm2,parm3,parm4,parm5,
I16V
msgdest
);
Functional Return
msglength
16-bit signed integer (assigned functional return)
Returns the length of the message (in bytes).
Parameters
catindex
32-bit signed integer by value (required)
Passes the index (returned by the CATOPEN intrinsic) that specifies the
message catalog to be used. The message catalog must have been
formatted with the GENCAT utility.
setnum
16-bit signed integer by value (required)
Passes the message set number within the catalog (1..255).
msgnum
16-bit signed integer by value (required)
Passes the message number within the message set (0..32,766).
catstatus
16-bit unsigned integer array (required)
Returns two elements; the first element is the error number, the second
element is reserved and always returns 0. The possible values of the first
element returned are:
Value Meaning
0
Successful
1 Invalid
catindex
specified
2 Read failed on catalog file
3 Message set not found