confighfs — Invoke the vfs_pfsctl function for HFS file systems

Format

confighfs [–l] [–v n] [–f n] [–q] [pathname] [–x[n] size pathname]

Note: The l option signifies a lowercase L, not an uppercase i.

Description

confighfs gives interactive shell users the ability to invoke the vfs_pfsctl function. The vfs_pfsctl function is used to pass control information to the PFS (physical file system). For more information about vfs_pfsctl, see the z/OS UNIX System Services File System Interface Reference. Detailed information about its use can be found in z/OS DFSMS Using Data Sets.

confighfs resides in the following directory: /usr/lpp/dfsms/bin/. This directory is not part of the default search path definition. Therefore, the directory must be included in the command specification when invoking the command.

Restriction: You can only use the confighfs command when working with the DFSMS file system (HFS).

For the zFS file system, use the zfsadmn command. For more information about the zFS file system, see z/OS Distributed File Service zFS Administration.

Options

–l: Query HFS limits.
Note: l signifies a lowercase L, not an uppercase i.
–v n: Set virtual storage max to n (where n is in MB). Requires superuser authority.
–f n: Set fixed storage min to n (where n is in MB). Requires superuser authority.
–q: Query your global statistics.
pathname: Query file system statistics for the file system containing each of the path names specified.
–x size pathname: Extend the specified file system, where size is the amount to be extended suffixed by the extend unit of M, T, or C (for megabytes, tracks, or cylinders), and the path name is a full or simple path name to a file or directory in the file system to extend. Requires superuser authority.
–xn size pathname: Extend the specified file system to a new volume using the -x rules. Requires superuser authority.

The following are internal debug options:

–dn: Prints incoming and outgoing pfsctl buffers (where n is 0, 1, or 2).
–t: Skips issuing the pfsctl.

Examples

Restriction: On systems running shared file systems, this command should only be issued on the server system (file system owner) for the file system pointed to by the path name. Issuing it on client systems results in fields of zeros.

To set virtual and fixed buffer limits for the HFS file system:
```
> confighfs –v 128 –f 32
```
To extend the file system for your current directory 100 cylinders:
```
> confighfs –x 100c .
```
If you need to get statistics for the root file system and the file system mounted over /tmp, you would do the following:
```
> confighfs / /tmp .
```
Note: The . (period) in examples two and three indicates the current directory.

Usage notes

If the HFS file system encounters an out of space condition during SYNC processing producing message IGW022S, then the following can result:
1. If confighfs is used to successfully extend the file system (by specifying confighfs -x size pathname, for example) and the extent was large enough to accommodate the pages required to complete the SYNC processing, confighfs invokes the SYNC function again to complete its update and then resets the Out of Space error flag. It will no longer be necessary to unmount and remount the file system to use it further. After the error flag is reset, all file system functions will work properly again.
2. If the extend size is not large enough to provide the amount of space required to complete the SYNC process, confighfs issues the following response:
```
Inadequate space added to HFS.  At least another nn tracks required.
```
  These results only apply when the IGW022S message indicates an Error Loc: EXTEND value. If it indicates an Error Loc: ARPN value, it goes into the out of space error state and require an unmount followed by a mount to reset the error condition and make it reusable. The updates applied to the HFS since the last successful SYNC will also be lost.
Unlike most z/OS® UNIX commands, which are located in /bin, confighfs is found in the /usr/lpp/dfsms/bin directory. You can symbolically link to the actual location of confighfs. The symbolic link is found in /usr/sbin:
```
/usr/sbin/confighfs -> /usr/lpp/dfsms/bin/confighfs
```