stat = f.shri( unit, newsize[, errprint] )
A call to F.SHRI will cause the given permfile to be truncated to the given number of llinks. The file must be accessed for write, and no one else can have the file accessed.
If the operation succeeds, F.SHRI will return zero, the file will be rewound, and the IOV file size will be updated.
If an error occurs during the truncation operation, F.SHRI calls the errprint function, and if this returns, F.SHRI will return the negative of the FMS status. The user can find the full FMS status in the external "f.stat". The default errprint routine (ERROR) displays the error message on the terminal and terminates the program.
At most sites, the FMS truncator call is only available in batch. F.SHRI in time sharing will run a task job in order to truncate the file, so a snumb and the message "Normal termination" will be displayed on the terminal for each file truncated.
fc*** - used in TSS as the ** file for the task job
expl b syslib extern -- for a description of "f.stat".
Copyright © 1996, Thinkage Ltd.