Guardian Procedure Calls Reference Manual

MESSAGESYSTEMINFO Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Summary
The MESSAGESYSTEMINFO procedure measures the current number of messages to or from a
process so it can issue a warning when a limit is nearly reached. MESSAGESYSTEMINFO is used
with CONTROLMESSAGESYSTEM.
You can use MESSAGESYSTEMINFO during checkout of a program that uses
CONTROLMESSAGESYSTEM, for example, to verify that initialization was done as expected.
Syntax for C Programmers
#include <cextdecs(MESSAGESYSTEMINFO)>
short MESSAGESYSTEMINFO ( short itemcode
,short *value );
Syntax for TAL Programmers
error := MESSAGESYSTEMINFO ( itemcode ! i
,value ); ! o
Parameters
itemcode
input
INT:value
specifies the item code of the information to be retrieved. See the value parameter for the list
of item codes.
value
output
INT .EXT:ref:1
returns the value indicated in this list:
Current limit on the number of messages to this process, as set by CONTROLMESSAGESYSTEM.0
Current limit on the number of messages from this process, as set by CONTROLMESSAGESYSTEM.1
The number of outstanding messages to this process.4
The number of outstanding messages from this process.5
830 Guardian Procedure Calls (M)