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

PUT_READLOCKX(2) OSS System Calls Reference Manual
NAME
PUT_READLOCKX - Sequentially locks and reads records in a Guardian disk file
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_READLOCKX(
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 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_READLOCKX() function is a thread-aware version of the Guardian READLOCKX
procedure.
The PUT_ READLOCKX() function sequentially locks and reads records in a Guardian disk
file, exactly like the combination of a PUT_LOCKREC() and PUT_READX() call.
For programming information about the READLOCKX procedure, see the Enscribe
Programmer’s Guide and the Guardian Programmer’s Guide.
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.
5−232 Hewlett-Packard Company 527186-023