GDSX Manual

Design and Development
Extended General Device Support (GDSX) Manual–134303
2-66
RECEIVEDEPTH
Therefore, in this case, USCODE should not call ^AWAITIO[X] as would be done for a
typical nowaited Guardian procedure call.
If PROCNOWAIT is set to 1, a call to one of the procedures by any USCODE task does
not cause TSCODE to suspend the task and assumes USCODE will call ^AWAITIO[X]
on the pseudo-$RECEIVE file to wait for I/O completion. When the I/O completes,
TSCODE returns the requested information in the output parameters of the
^AWAITIO[X] procedure and wakes up the calling task.
RECEIVEDEPTH
This static parameter specifies the maximum number of messages incoming to
$RECEIVE that will be queued for the GDSX process before replies must be issued.
When the GDSX process opens $RECEIVE, the value of this parameter is used as the
receivedepth input parameter to OPEN.
The minimum value for RECEIVEDEPTH is (MAXTASKS + 5) multiplied by 2.
(MAXTASKS specifies the total number of user tasks that may be active simultaneously,
and TSCODE adds five to MAXTASKS for all the system tasks. See the explanation
under the heading “MAXTASKS.“) Therefore, if MAXTASKS is allowed to default to
34, the default value for RECEIVEDEPTH is (34 + 5) * 2 = 78.
RECEIVESIZE
This static parameter specifies the largest $RECEIVE request that the GDSX process
will accept. Messages larger than RECEIVESIZE bytes will be rejected with a file-
system error 21.
In order to be able to queue up multiple messages from $RECEIVE, TSCODE allocates
a $RECEIVE queue from extended memory. The size in bytes of the queue is calculated
as follows:
$RECEIVE queue size = RECEIVESIZE * (MAXTASKS + 5)
MAXTASKS specifies the total number of user tasks that may be active simultaneously.
TSCODE adds five to MAXTASKS to handle all the system tasks (see “MAXTASKS”
on page 2-64).
Internal DEFINE Name CONFIG^PARAMS Name Default Value Range
proc^nowait procedure^nowait 0 (OFF) 0–1
Internal DEFINE Name CONFIG^PARAMS Name Default Value Range
receivedepth receive^depth 78 messages 16–255
messages
Internal DEFINE Name CONFIG^PARAMS Name Default Value Range
recvsz recvsize 4096 bytes 1024–16,384
bytes