Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (R)
Guardian Procedure Calls Reference Manual—522629-013
13-38
READUPDATELOCK[X] Procedures
•
A file opened by FILE_OPEN_ uses direct I/O transfers by default; you can use
SETMODE 72 to force the system to use an intermediate buffer in the process file
segment (PFS) for I/O transfers. A file opened by OPEN uses a PFS buffer for I/O
transfers, except for large transfers to DP2 disks.
•
If the extended address of the buffer is odd, bounds checking rounds the address
to the next lower word boundary and checks an extra byte as well. The odd
address is used for the transfer.
Errors for READUPDATELOCKX Only
In addition to the errors returned from READUPDATELOCK, error 22 is returned from
READUPDATELOCKX when:
•
The address of a parameter is extended, but either the extended data segment is
invalid or the address is for a selectable segment that is not in use at the time of
the call.
•
The address of a parameter is extended, but it is an absolute address and the
caller is not privileged.
OSS Considerations
•
This procedure operates only on Guardian objects. If an OSS file is specified,
error 2 is returned.
Example
CALL READUPDATELOCK ( IN^FILE , INBUFFER , 72 , NUM^READ );
Related Programming Manuals
For programming information about the READUPDATELOCK file-system procedure,
refer to the
Enscribe Programmer’s Guide.