Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (W-Z)
Guardian Procedure Calls Reference Manual—522629-013
16-34
WRITEUPDATEUNLOCK[X] Procedures
WRITEUPDATEUNLOCK[X] Procedures
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Considerations for WRITEUPDATEUNLOCKX Only
Errors for WRITEUPDATEUNLOCKX Only
OSS Considerations
Example
Related Programming Manuals
Summary
The WRITEUPDATEUNLOCK[X] procedures perform random processing of records in
a disk file.
WRITEUPDATEUNLOCK is intended for use with 16-bit addresses, while
WRITEUPDATEUNLOCKX is intended for use with 32-bit addresses. Therefore, the
data buffer for WRITEUPDATELOCKX can be either in the caller’s stack segment or
any extended data segment.
WRITEUPDATEUNLOCK[X] has two functions:
1. To alter, then unlock, the contents of the record at the current position
2. To delete the record at the current position in a key-sequenced or relative file
A call to WRITEUPDATEUNLOCK[X] is equivalent to a call to WRITEUPDATE[X]
followed by a call to UNLOCKREC. However, the WRITEUPDATEUNLOCK[X]
procedure requires less system processing than do the separate calls to
WRITEUPDATE[X] and UNLOCKREC.