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

System Functions (n - p) PUT_WRITEUPDATEUNLOCKX(2)
NAME
PUT_WRITEUPDATEUNLOCKX - Performs random processing of records in a 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_WRITEUPDATEUNLOCKX(
short filenum,
char *buff er,
#ifdef __LP64
int write_count,
int *count_written,
#else
unsigned short write_count,
unsigned short *count_written,
#endif
long tag);
PARAMETERS
Input
filenum Specifies the file number of a Guardian file open instance that identifies the file
to be written.
buffer Specifies an array in the application process in which the information to be writ-
ten to the file is stored before the call.
write_count Specifies the number of bytes to be written.
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
count_written (Optional) Returns a count of the number of bytes written to the file from buffer.
DESCRIPTION
The PUT_WRITEUPDATEUNLOCKX() function is a thread-aware version of the Guardian
WRITEUPDATEUNLOCKX procedure.
The PUT_WRITEUPDATEUNLOCKX() function performs random processing of records in a
Guardian disk file. PUT_WRITEUPDATEUNLOCKX() has two purposes:
• To alter, then unlock, the contents of the record at the current position
• To delete the record at the current position in a key-sequenced or relative file
A call to PUT_WRITEUPDATEUNLOCKX() is equivalent to a call to
PUT_WRITEUPDATEX() followed by a call to PUT_UNLOCKREC( ). However, the
PUT_WRITEUPDATEUNLOCKX() function requires less system processing than do the
separate calls to PUT_WRITEUPDATEX() and PUT_UNLOCKREC().
527186-023 Hewlett-Packard Company 5−301