Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
ioefsutl converttov4 z/OS Distributed File Service zFS Administration SC23-6887-00 |
|
Purposeioefsutl converttov4 is a batch utility that converts a version 1.5 aggregate to a version 1.4 aggregate. Format
Options
UsageThe ioefsutl converttov4 command is used when you need to convert a zFS version 1.5 aggregate to a version 1.4 aggregate. All extended (v5) directories are converted to v4 directories. You might use this if you need to run z/OS® releases prior to z/OS V2R1. ioefsutl converttov4 cannot convert the version 1.5 aggregate if it has grown larger than approximately 4 TB. In this case, you must copy subsets of the data one at a time into other version 1.4 aggregates using the z/OS UNIX shell command pax. Each subset must be copied into a separate version 1.4 aggregate that is less than 4 TB. ioefsutl converttov4 cannot convert a directory that contains more than 64K-1 subdirectories. In this case, you must copy subsets of the directory into separate directories contained in a version 1.4 aggregate. Converting a directory from an extended (v5) directory to a version 4 directory requires both versions of the directory to be on the disk at the same time, temporarily. If the aggregate becomes full during the allocation of the new directory, a dynamic grow is attempted. See Dynamically growing a compatibility mode aggregate for information about controlling the dynamic growth of an aggregate. If there is not enough space to complete the conversion, the new directory is deleted and the conversion operation fails. The old directory is deleted when the conversion is completed. The resulting new directory can possibly require more space than the old directory, and could also possibly require less space than the old directory. Results will vary based on the actual directory contents. If a system outage occurs during a directory conversion, the directory is made consistent during log recovery processing. That is, either the old directory will exist or the new directory will exist, but both will not exist. The conversion will cause the backup change activity flag to be set. If the aggregate damaged bit is set, conversion does not start and an error is issued. If the aggregate damaged bit is
set, you can still mount the aggregate. The IOEZ00783E console message
is displayed:
Privilege requiredThe user must meet
one of the authorization requirements:
If you are using an IOEFSPRM file in your JCL, the issuer must have READ authority to the data set that contains the IOEFSPRM file. If you are using parmlib (IOEPRMxx), the issuer does not need special authorization. ExamplesFigure 1 shows an example of a job that invokes
the ioefsutl utility to convert a version 1.5 aggregate
to a version 1.4 aggregate.
Figure 1. Job to convert a version 1.5 aggregate
to a version 1.4 aggregate
In the PARM=(’converttov4 -aggregate OMVS.PRV.COMPAT.AGGR001’) statement, the converttov4 and option -aggregate must be in lowercase. |
Copyright IBM Corporation 1990, 2014
|