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:
- DSPMFSINF
For more information about integrated file system commands, see the Integrated file system topic collection in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.
Restrictions:
- 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 | 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 topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/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.
- 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 |