Guardian Procedure Calls Reference Manual

FILE_WRITEUPDATEUNLOCK64_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
OSS Considerations
Example
Related Programming Manuals
Summary
The FILE_WRITEUPDATEUNLOCK64_ procedure is used for random processing of records in a
disk file. The data buffer for FILE_WRITEUPDATEUNLOCK64_ can be either in the caller's stack
segment or any extended data segment.
FILE_WRITEUPDATEUNLOCK64_ has two functions:
• 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 FILE_WRITEUPDATEUNLOCK64_ is equivalent to a call to FILE_WRITEUPDATE64_ followed
by a call to FILE_UNLOCKREC64_. However, FILE_WRITEUPDATEUNLOCK64_ requires less system
processing than do the separate calls to FILE_WRITEUPDATE64_ and FILE_UNLOCKREC64_.
FILE_WRITEUPDATEUNLOCK64_ extends the capabilities of WRITEUPDATEUNLOCKX in several
ways:
• It permits the write buffer to reside outside of the 32-bit addressable range.
• It is callable from both 32-bit and 64-bit processes.
• It allows for a future capability to write more than 56kb in a single operation by widening
the write count to 32 bits.
• It allows the returned count-written argument to reside outside of the 32-bit addressable
range
• It allows a 64-bit nowait I/O tag to be passed.
• Rather than returning a condition code status, the procedure returns a file management error.
A return value of zero indicates success.
NOTE: The FILE_WRITEUPDATEUNLOCK64_ procedure is supported on systems running H06.24
and later H-series RVUs and J06.13 and later J-series RVUs. Its use is recommended for new code.
Syntax for C Programmers
#include <cextdecs(FILE_WRITEUPDATEUNLOCK64_)>
short FILE_WRITEUPDATEUNLOCK64_ ( short filenum
,const char _ptr64 *buffer
,__int32_t write-count
,[ __int32_t _ptr64 *count-written ]
,[ long long tag ] );
FILE_WRITEUPDATEUNLOCK64_ Procedure 543