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

System Functions (n - p) PUT_READX(2)
NAME
PUT_READX - Returns data from an open Guardian file to the application process data area
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 <cextdecs.h>]
#include <pthread.h>
short PUT_READX(
short filenum,
char *buff er,
#ifdef __LP64
int read_count,
int *count_read,
#else
unsigned short read_count,
unsigned short *count_read,
#endif
long tag);
PARAMETERS
Input
filenum Specifies the file number of a Guardian file open instance that identifies the file
to be read.
read_count (Optional) Specifies the number of bytes to be read.
tag (Optional) For nowait I/O only. The tag value you define uniquely identifies the
operation associated with this call.
This parameter is supported only for program compatibility; if you provide it, it
is ignored.
Output
buffer Specifies an array in the application process in which the information read from
the file is returned.
count_read (Optional) For waited I/O only. This parameter returns a count of the number of
bytes returned from the file into buffer .
DESCRIPTION
The PUT_READX() function is a thread-aware version of the Guardian READX procedure.
The PUT_READX() function returns data from an open Guardian file to the application
process’s data area. The PUT_READX() function sequentially reads a disk file. For key-
sequenced, relative, and entry-sequenced files, the PUT_READX() function reads a subset of
records in the file. (A subset of records is defined by an access path, positioning mode, and com-
parison length.)
For programming information about the Guardian READX file-system procedure, see the Guar-
dian Programmer’s Guide, the Enscribe Programmer’s Guide, and the manuals for your specific
data communications interface.
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:
527186-023 Hewlett-Packard Company 5−243