filstatfs [-w] [-S] OpenTP1-file-system-area-name

The filstatfs command outputs to the standard output the status of a specified OpenTP1 file system.

-w

Displays the start location of OpenTP1 file management area. This option can be specified only when the OS is AIX.

-S

Displays user area information, including listings of the used areas and the unused (free) areas.

OpenTP1-file-system-area-name~<path name>

Specifies the name of a character special file or ordinary file containing the OpenTP1 file system.

• 1: Displayed when the -w option is specified.
• 2: Displayed when the -S option is specified.

aa...aa

Sector length specified with the -s option in the filmkfs command

bb...bb

Total size of area allocated to the user in the OpenTP1 file system

cc...cc

Size of free space (not allocated as OpenTP1 files) in the area allocated to the user

dd...dd

Maximum size currently allocatable to a single file (maximum size of contiguous free area, excluding the management information (2 sectors in length))

ee...ee

Maximum number of creatable files specified with the -l option in the filmkfs command

ff...ff

Number of files already created

gg...gg

Number of remaining creatable files (maximum number of creatable files - number of files already created)

hh...hh

Number of noncontiguous file areas

ii...ii

User's login name used to initialize the OpenTP1 file system

jj...jj

Time at which the OpenTP1 file system was initialized (in the format day-of-weekmonthdayhour:minute:secondyear)

kk...kk

OpenTP1 file system name specified in the filmkfs command

ll...ll

Start location of OpenTP1 file management area

mm...mm

Offset from the user area start position

nn...nn

Size of used or unused area in the user area

oo...oo

Whether display is of used or unused area in the user area:

used: Used area

unused: Unused area

pp...pp

OpenTP1 file name corresponding to an area being used ("-" is displayed in the case of an unused area).

Message ID	Description	Output destination
KFCA01536-E	Specification of a command argument is invalid.	Standard error output
KFCA01551-I	Help message	Standard output, standard error output
KFCA01570-E	File versions do not match.	Standard error output
KFCA01571-E	User does not have access right to the file.	Standard error output
KFCA01572-E	An upper bound was exceeded during open processing.	Standard error output
KFCA01574-E	Specified file name is too long.	Standard error output
KFCA01575-E	Specified file is not a character special file or ordinary file; or, the specified file was found, but there is no corresponding device.	Standard error output
KFCA01576-E	Specified file is not an OpenTP1 file system.	Standard error output
KFCA01582-E	Memory shortage occurred.	Standard error output
KFCA01583-E	I/O error occurred.	Standard error output
KFCA01599-E	Error occurred.	Standard error output

• Creation of an OpenTP1 file requires a contiguous free area that at least equals the size needed for the file. You can use the dd...dd option to check for the largest available contiguous free area. By executing the filstatfs command with the -S option specified, you can check the condition of the contiguous areas in the OpenTP1 file system. Using the results of this check, when you delete an OpenTP1 file that is no longer needed, the preceding and succeeding free areas can be linked, securing a larger contiguous free area.
• Digits following the decimal point are truncated from the values shown in kilobytes [KB] in the output format. Consequently, in the list displayed with the -S option, the value of OFFSET + SIZE may not match exactly the value of OFFSET for the next area.