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

System Functions (n - p) put_RECEIVEREADL(2)
NAME
put_RECEIVEREADL - Initiates thread-aware function for reading $RECEIVE (larger mes-
sage version)
LIBRARY
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zputdll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/yputdll
SYNOPSIS
#include <pthread.h>
long put_RECEIVEREADL(
const short filenum,
char *buff er,
const int read_count,
int *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 put_RECEIVEREAD() function, except that:
• This function can handle the longer message lengths allowed by the
PUT_SERVERCLASS_SENDL_() function.
• The read_count parameter is type const int.
• The dialog_info parameter is not included in the put_RECEIVEREADL( ) function.
• The Guardian file-system error 4184 (EVERSION) can be returned.
See the put_RECEIVEREAD(2) reference page.
To use this function on systems running J06.10 or later RVUs or H06.21 or later RVUs, you must
perform all of the following tasks:
• Include the pthread.h header file in the application.
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Link the application to the zputdll library.
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
this function with 32-bit or 64-bit applications.
527186-023 Hewlett-Packard Company 5−251