Creating a version 1.5 aggregate

A version 1.5 aggregate can be created using one of the following methods:

By formatting a VSAM linear data set as a version 5 using the zFS ioefsutl format batch utility
Using the zFS ioeagfmt batch utility
Via the Format Aggregate API
Using the zfsadm format command

Version 1.5 aggregates are not formatted by default. They must be explicitly requested with the -version5 option.

You can change the default version that is formatted by setting the IOEFSPRM variable format_aggrversion configuration option to 5. The format_aggrversion value from the zFS PFS is used when any formatting method is used without the -version4 or -version5 parameters.

The zFS format utilities ioeagfmt and ioefsutl format both request the value of the format_aggrversion configuration option from the zFS kernel when determining the default aggregate version for the format. If the zFS PFS is down, both utilities will simply fail. Formatting of a version5 aggregate is not allowed when a z/OS® V1R12 or z/OS V1R13 system is in a shared file system environment when using the batch utility ioeagfmt, the zfsadm format command or the Format Aggregate API.

Following is an example of a job to create and format a version 1.5 aggregate:


//USERIDA JOB ,'Compatibility Mode',
// CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1)
//DEFINE EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=H
//SYSUDUMP DD SYSOUT=H
//AMSDUMP DD SYSOUT=H
//DASD0 DD DISP=OLD,UNIT=3390,VOL=SER=PRV000
//SYSIN DD *
     DEFINE CLUSTER (NAME(OMVS.PRV.COMPAT.AGGR001) -
            VOLUMES(PRV000) -
            LINEAR CYL(25 10) SHAREOPTIONS(3))
/*
//CREATE EXEC PGM=IOEFSUTL,REGION=0M,
// PARM=('format -aggregate OMVS.PRV.COMPAT.AGGR001 -version5')
//SYSPRINT DD SYSOUT=H
//STDOUT DD SYSOUT=H
//STDERR DD SYSOUT=H
//SYSUDUMP DD SYSOUT=H
//CEEDUMP DD SYSOUT=H
//*

The zfsadm format command can also be used to format a version 1.5 aggregate. For example:

# zfsadm define -aggr OMVS.PRV.ZFS.AGGR005.LDS0005 -volumes PRV000 -cyl 10 5
IOEZ00248I VSAM linear dataset OMVS.PRV.ZFS.AGGR005.LDS0005 successfully created.
# zfsadm format -aggr OMVS.PRV.ZFS.AGGR005.LDS0005 -version5
IOEZ00077I HFS-compatibility aggregate OMVS.PRV.ZFS.AGGR005.LDS0005 has 
been successfully created