Migrating from Hierarchical File Systems to zSeries File Systems


zFS is the preferred file system and continued use of HFS is discouraged. New file systems should be created as zFSss. This technote provides information on the BPXWH2Z tool to migrate HFSs to zFSs.


Using the BPXWH2Z tool to migrate hierarchical file systems to zSeries file systems

BPXWH2Z is an ISPF-based tool that migrates a hierarchical file system (HFS) to a z/OS Distributed File Service zSeries File System (zFS). With BPXWH2Z, you can alter space allocation, placement, SMS classes, and data set names. You can also use the tool to:
  • Migrate mounted and unmounted HFSs to zFSs. If the HFS being migrated is mounted, the tool automatically unmounts it and then mounts the new zFS on its current mount point.
  • Define zFS aggregates by default to be approximately the same size as the HFS. The new allocation size can also be increased or decreased.
  • Have the migration run in TSO foreground or UNIX background.

BPXWH2Z is located in partitioned data set SBPXEXEC (usually called SYS1.SBPXEXEC). You can invoke the BPXWH2Z tool from the ISPF COMMAND panel. When you run the BPXWH2Z tool in your system, it uses the z/OS V1R7 or later level of the pax command. This level has been enhanced for sparse file support and other characteristics that are of concern when migrating from an HFS to a zFS.

You can manually migrate from an HFS to a zFS without using the tool. When doing that, the z/OS V1R7 or later level of the pax command is recommended. However, you would need to allocate and format the target zFS file systems.

You can find useful information about using the BPXWH2Z tool in the IBM Redbook z/OS Distributed File Service zSeries File System Implementation z/OS V1R7, SG24-6580.

Special Notices

This material has not been submitted to any formal IBM test and is published AS IS. It has not been the subject of rigorous review. IBM assumes no responsibility for its accuracy or completeness. The use of this information or the implementation of any of these techniques is a client responsibility and depends upon the client's ability to evaluate and integrate them into the client's operational environment.


Publish Date
24 January 2007

Rating: Not yet rated


IBM Form Number