Guardian Procedure Calls Reference Manual

• 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
indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).< (CCL)
indicates that GETSYNCINFO was successful.= (CCE)
indicates that the file is not a disk file.> (CCG)
Considerations
• The GETSYNCINFO procedure cannot be used with files that are larger than approximately
2 gigabytes, including both Enscribe format 2 and OSS files. If an attempt is made to use the
GETSYNCINFO procedure with these files, error 581 is returned. For information on how to
perform the equivalent task with files larger than approximately 2 gigabytes, see the
FILE_GETSYNCINFO_ Procedure (page 447).
• Increased key limits for format 2 key-sequenced files are not supported
The GETSYNCINFO procedure does not support the increased key limits for format 2
key-sequenced files (in H06.28/J06.17 RVUs with specific SPRs and later RVUs) because it
cannot handle keys longer than 255 bytes. If SETSYNCINFO is passed a synchronization
block generated by GETSYNCINFO for a key-sequenced file with a key longer than 255
bytes, an error 41 is returned. For information on how to perform the equivalent task for
key-sequenced files with keys longer than 255 bytes, see the FILE_GETSYNCINFO_ Procedure
(page 447).
• 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
If an out-of-bounds application buffer address parameter is specified in the GETSYNCINFO
call (that is, a pointer to the buffer has an address that is outside of the data area of the
process) or if the buffer lies within the data area that is used by GETSYNCINFO, then the call
returns with file-system error 22.
Example
CALL GETSYNCINFO ( FILE^NUM , SYNC^ID );
GETSYNCINFO Procedure (Superseded by FILE_GETSYNCINFO_ Procedure) 671