Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (G)
Guardian Procedure Calls Reference Manual—522629-013
6-26
GETSYNCINFO Procedure
(Superseded by FILE_GETSYNCINFO_ Procedure)
Parameters
filenum input
INT:value
is the number of an open file that identifies the file whose sync block is obtained.
sync-block output
INT:ref:*
returns the synchronization block for this file. The size, in words, of
sync-block
is determined as follows:
•
For unstructured disk files, size = 8 words.
•
For ENSCRIBE structured files, size in words = 11 + (longest alt key len + pri
key len + 1) / 2.
•
For the Transaction Management Facility, the transaction pseudofile size = 9
words.
•
For processes, size = 2 words.
•
For other files, size = 1 word.
sync-block-size output
INT:ref:1
returns the size, in words, of the sync block data.
Condition Code Settings
< (CCL) indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).
= (CCE) indicates that GETSYNCINFO was successful.
> (CCG) indicates that the file is not a disk file.
Considerations
•
The GETSYNCINFO procedure cannot be used with format 2 files. If an attempt is
made to use the GETSYNCINFO procedure with format 2 files, error 581 is
returned. See the FILE_GETSYNCINFO_ Procedure
for use with format 2 files.
•
File number has not been opened
If the GETSYNCINFO file number does not match the file number of the open file
that you are trying to access, then the call to GETSYNCINFO returns with file-
system error 16.
•
Buffer address out of bounds