Open System Services System Calls Reference Manual (G06.28+)

System Functions (s and S) SPT_WRITEUPDATEUNLOCKX(2)
NAME
SPT_WRITEUPDATEUNLOCKX
- performs random processing of records in a disk file
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
H-series OSS processes: /G/system/zdllnnn/zsptdll
SYNOPSIS
[#include <cextdecs.h>]
#include <spthread.h>
short SPT_WRITEUPDATEUNLOCKX (
short filenum,
char *buffer,
short write_count,
[short *count_written],
[long tag ]
);
PARAMETERS
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 infor-
mation to be written to the file is stored before the call.
write_count specifies the number of bytes to be written.
count_written returns a count of the number of bytes written to the file from
buffer.
tag is 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.
DESCRIPTION
The SPT_WRITEUPDATEUNLOCKX() function is the thread-aware version of the Guardian
WRITEUPDATEUNLOCKX procedure.
The SPT_WRITEUPDATEUNLOCKX() function performs random processing of records in a
Guardian disk file. SPT_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 SPT_WRITEUPDATEUNLOCKX() is equivalent to a call to
SPT_WRITEUPDATEX() followed by a call to SPT_UNLOCKREC( ).
However, the SPT_WRITEUPDATEUNLOCKX() function requires less sys-
tem processing than do the separate calls to SPT_WRITEUPDATEX() and
SPT_UNLOCKREC( ).
For programming information about the WRITEUPDATEUNLOCKX procedure,
see the Enscribe Programmer’s Guide and the Guardian Programmer’s Guide.
527186-005 Hewlett-Packard Company 7−339