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

Process Initiation, Communication, and
Management
HP COBOL Manual for TNS/E Programs—520347-003
31-14
At-End Condition
•
It designates a data item to contain the message source descriptor. This fixed-
format item is defined in RECEIVE-CONTROL Paragraph. When the HP COBOL
run-time routines complete a successful READ on $RECEIVE, they update this
data item to report:
°
The message source (the operating environment or another user process)
°
The entry number in the receive-control table
°
The process ID of the requesting process (name, processor number, and
number of process in that processor)
•
It specifies which classes of operating environment messages are to be passed to
process $XX.
An ordinary Pathway server uses only three entries of the RECEIVE-CONTROL
paragraph:
•
TABLE OCCURS
Specifies how many requesters can have the server open at one time. Any
additional requesters attempting to open the server are refused. This value must
be greater than or equal to the MAXLINKS value in the PATHCOM command file
that created the PATHMON environment. A large value is recommended.
•
SYNCDEPTH
Usually set to 1 for Pathway servers unless they are multithreaded.
•
REPLY CONTAINS
Specifies the length of the reply that the server sends back to the requester. It
specifies the name of the file containing the longest record that is used as a reply
or an explicit number of characters.
At-End Condition
An entry is made in the receive-control table when a requester executes an OPEN for
a file assigned to the server process. A requester can have more than one OPEN
issued to a server process at any given time. The receive-control table has a separate
entry for each of these OPENs.
An entry is deleted from the receive-control table whenever the requester issues a
CLOSE for the file assigned to the server process. A server continues to receive
requester messages through $RECEIVE if there is an entry in the table. When the last
entry is deleted, an at-end condition arises for the server’s READ statement.
Note. If the process is running at a high PIN, the process ID that the operating
environment returns is synthetic. For information about synthetic IDs of high-PIN
processes, see the Guardian Application Conversion Guide.