Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

System Functions (s and S) spt_RECEIVEREADL(2)
NAME
spt_RECEIVEREADL - Initiates thread-aware function for reading $RECEIVE (larger mes-
sage version)
LIBRARY
H-series OSS processes: /G/system/zdllnnn/zsptdll
SYNOPSIS
#include <spthread.h>
long spt_RECEIVEREADL(
const short filenum,
char *buffer,
const long read_count,
long *count_read,
const long timelimit,
short *receive_info,
PARAMETERS
filenum Specifies the Guardian file number for $RECEIVE (always 0)
buffer Specifies the data buffer
read_count Specifies the number of bytes to read
count_read Specifies the number of bytes read
timelimit Specifies a FILE_COMPLETEL_-style time limit
receive_info Specifies a FILE_GETRECEIVEINFOL_-style $RECEIVE info structure;
NULL may be passed if this information is not needed; must not be NULL if
filenum’s receive_depth is greater than 0 (zero).
DESCRIPTION
This function is the same as the spt_RECEIVEREAD() function, except that:
• This function can handle the longer message lengths allowed by the
SPT_SERVERCLASS_SENDL_() function.
• The read_count parameter is type const long.
• The dialog_info parameter is not included in the spt_RECEIVEREADL() function.
• The Guardian file-system error 4184 (EVERSION) can be returned.
See the spt_RECEIVEREAD(2) reference page.
NOTES
This function is supported on systems running J06.07 and later J-series RVUs and H06.18 and
later H-series RVUs, and must be used instead of the spt_RECEIVEREAD( ) function when the
messages are larger than 32 kilobytes. This function also can be used for shorter messages.
RETURN VALUES
See the spt_RECEIVEREAD(2) reference page.
In addition, this function can return this Guardian file-system error:
4184 (EVERSION)
The function was called from a system that is running a J-series RVU earlier
than J06.07 or an H-series RVU earlier than H06.18.
527186-023 Hewlett-Packard Company 7−365