Display Mounted FS Information (STATFS)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Display Mounted File System Information (STATFS) command displays information about a mounted file system.

This command can also be issued using the following alternative command name:

For more information about integrated file system commands, see the Integrated file system information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.

Restrictions:

  1. The user must have execute (*X) authority to each directory in the path.
Top

Parameters

Keyword Description Choices Notes
OBJ Object Path name Required, Positional 1
OUTPUT Output *, *PRINT Optional
Top

Object (OBJ)

Specifies the path name of an object that is within the mounted file system whose statistics are to be displayed. Any object in the mounted file system can be specified. For example, it can be a directory (*DIR) or a stream file (*STMF).

For more information on specifying path names, refer to "Object naming rules" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.

This is a required parameter.

Top

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*
The output is displayed for interactive jobs or printed with the job's spooled output for non-interactive jobs.
*PRINT
The output is printed with the job's spooled output.
Top

Examples

The alternative command name for STATFS is DSPMFSINF. The following examples use the alternative command name, but STATFS can be replaced directly for DSPMFSINF in all of them.

Example 1: Displaying Statistics of a Mounted File System

DSPMFSINF   OBJ('/jsmith/file1')

This command displays the statistics for the mounted file system that contains /jsmith/file1.

Example 2: Displaying QSYS.LIB File System Statistics

DSPMFSINF   OBJ('/QSYS.LIB/MYLIB.LIB/MYFILE.FILE')

This command displays the statistics for the QSYS.LIB file system that contains *FILE object MYFILE in library MYLIB.

Top

Error messages

*ESCAPE Messages

CPFA0A9
Object not found. Object is &1.
CPFA09C
Not authorized to object. Object is &1.
Top