FUNCTION(MIGRATION): Requesting statistics of the migration function

Explanation: MIGRATION is an optional subparameter of the FUNCTION parameter to request a statistics report about migration.

Use the subparameters of the MIGRATION parameter to select statistics reports about data sets migrated between specified levels of DFSMShsm storage. For example, when you specify MIGRATION and the FROMPRIMARY and TOMIGRATIONLEVEL1 subparameters, you get a statistics report about only those data sets that DFSMShsm migrated from primary volumes to migration level 1 volumes.

The following table shows the type of statistics report you get for migration:

Source Volume Subparameter	Target Volume Subparameter	Type of Migration on Statistics Report
FROMANY	TOANY	Primary to Level 1 Primary to Level 2 SUBSEQUENT MIGS
FROMANY	TOMIGRATIONLEVEL1	Primary to Level 1
FROMANY	TOMIGRATIONLEVEL2	Primary to Level 2 SUBSEQUENT MIGS
FROMMIGRATIONLEVEL1	TOANY	SUBSEQUENT MIGS
FROMMIGRATIONLEVEL1	TOMIGRATIONLEVEL1
FROMMIGRATIONLEVEL1	TOMIGRATIONLEVEL2	SUBSEQUENT MIGS
FROMPRIMARY	TOANY	Primary to Level 1 Primary to Level 2
FROMPRIMARY	TOMIGRATIONLEVEL1	Primary to Level 1
FROMPRIMARY	TOMIGRATIONLEVEL2	Primary to Level 2

Defaults: When you specify MIGRATION without specifying subparameters, the defaults are FROMANY and TOANY.

Note:

When you specify FROMANY and TOMIGRATIONLEVEL2, DFSMShsm includes data sets that migrate from migration level 2 volumes to different migration level 2 volumes in the statistics of data sets that migrate from migration level 1 volumes to migration level 2 volumes.
If you want information about movement from one tape migration level 2 volume to another tape migration level 2 volume, use the RECYCLE parameter.
SUBSEQUENT MIGS reflects all movements of data sets from migration level 1 to migration level 1, migration level 1 to migration level 2, and migration level 2 to migration level 2. This includes FREEVOL moves but does not include RECYCLE moves.