COBOL Manual for TNS/E Programs (H06.03+)

Environment Division
HP COBOL Manual for TNS/E Programs—520347-003
6-67
RECEIVE-CONTROL Paragraph
MESSAGE-TYPE
is one of:
ENTRY-NUMBER
is the number assigned to the receive-control table entry for a requesting process.
It is in the range set by table-length. When certain system messages not
associated with any requester, such as CPU-UP and CPU-DOWN, are received,
the number is 0.
PHANDLE
is a unique identifier that specifies a process to process-related procedure calls (for
more information, see the Guardian Programmer’s Guide).
REPORT Phrase
Normally, the $RECEIVE mechanism automatically intercepts and processes all
messages sent to the run unit by the operating system. By specifying the REPORT
clause, you state that the $RECEIVE mechanism is not to intercept certain classes of
system messages, but pass them back to the program for processing. The program
then supplies the appropriate error code (if the ERROR CODE clause appears), and
generates the appropriate response (by performing a write operation or another read
operation on $RECEIVE).
The file must have a record length of at least 255 characters.
“System” is an abbreviation for the messages that are generated under program
control.
Value Meaning
Zero or greater Message sent by the requesting process
Less than zero Message sent by the operating system
Table 6-8. Message Types That the Program Generates (System) (page1of2)
COBOL Keyword Message-Type Code
ABEND Not used—see Table 6-10
CLOSE -104
CONTROL -32
CONTROLBUF -35
MEMORY-LOCK-COMPLETION -23
MEMORY-LOCK-FAILURE -24
NEWPROCESSNOWAIT-COMPLETION -12
OPEN -103
RESETSYNC -34