File Utility Programming (FUP) Reference Manual

FUP Commands
File Utility Program (FUP) Reference Manual—523323-015
2-90
INFO Guidelines
AGGREGATE EOF aggregate eof(percent-used % USED)
for the disk objects, aggregate eof is the end-of-file value of the file. For a
partitioned file where the entire file has been opened, the end-of-file value of the
entire file is returned.
If all the extents were allocated, the percent-used parameter is the amount of
file space currently used.
When a file is created with PARTONLY option, the aggregate EOF displays the
following warning:
WARNING - $FC1.FUPILKS0.BT1: FILE SYSTEM ERROR: ERR 11
INFO Guidelines

If a transaction is still open, INFO specifies files that were opened and closed
during the transaction as open. The files still have outstanding locks against them.
The LISTOPENS command does not specify these files as open because the files
do not have any openers.

When a listed file is purged during the execution of the INFO command, INFO
displays Error 11 (File not in directory).

To perform a FUP INFO,STAT on volume directories, use this list-file syntax:
$volume.SYS00.DIRECTRY
For example, the command FUP INFO $DATA01.SYS00.DIRECTRY,STAT returns
statistics on the volume $DATA01.

FUP cannot show Safeguard protection for files protected at the volume or
subvolume level. Additional discrepancies between Safeguard protection and what
FUP displays are evident when files are copied to or from systems where the user
has default Safeguard protection on only one system.

Although the Safeguard product might not be currently running, FUP INFO always
displays **** for the security vector of files individually protected by Safeguard.

If you use INFO with the STAT option and FUP detects errors while generating the
statistics, you receive an error (ERR 59). The error can occur if the file is being
updated concurrently, causing a transient structure problem that FUP encounters
because it is reading large blocks.

INFO with the STAT option does not detect each instance of a corrupted file.

INFO with the STAT,PARTIAL option provides information without reading the
entire file. The accuracy of STAT,PARTIAL depends on the condition of the file and
how much of the file was analyzed. For example, statistics on index blocks are
almost always unreliable when you use the PARTIAL option.

FUP recognizes OSS files with the INFO command. This command is the only
FUP command that handles OSS files.