Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-118
SETSYNCINFO Procedure
(Superseded by FILE_SETSYNCINFO_ Procedure)
Parameters
filenum input
INT:value
is the number of an open file that identifies the file whose synchronization block is
being passed.
sync-block input
INT:ref:*
is the latest synchronization block received from the primary process.
Condition Code Settings
< (CCL) indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).
= (CCE) indicates that SETSYNCINFO is successful.
> (CCG) indicates that the file is not a disk file.
Considerations
•
The SETSYNCINFO procedure cannot be used with format 2 files. If an attempt is
made to use the SETSYNCINFO procedure with format 2 files, error 581 is
returned. See the FILE_SETSYNCINFO_ Procedure
for information on how to
perform the equivalent task with format 2 files.
•
File number has not been opened
If the SETSYNCINFO file number does not match the file number of the open file,
then the call to SETSYNCINFO is rejected with file-system error 16.
•
Application parameter or buffer address out of bounds
If an out-of-bounds application buffer address parameter is specified in the
SETSYNCINFO call (that is, a pointer to the buffer has an address that is outside
of the data area of the process), then the call is rejected with file-system error 22.
•
Checksum error on file sync block
If an attempt is made to modify the file-system sync buffer area, the
SETSYNCINFO call is rejected with file-system error 41.
Example
CALL SETSYNCINFO ( F1 , SYNC );