MIGRATIONCLEANUPCYCLE and SECONDARYSPMGMTCYCLE: Specifying the cycle for automatic secondary space management functions

Explanation: MIGRATIONCLEANUPCYCLE and SECONDARYSPMGMTCYCLE are mutually exclusive, optional parameters that apply to all secondary space management functions, including migration cleanup and ML1 to ML2 migration.

Both of these parameters allow you to specify the days in a cycle when migration cleanup and ML1 to ML2 migration run.

These two parameters have identical function. The parameter name MIGRATIONCLEANUPCYCLE has been retained in order to maintain compatibility, but the parameter name SECONDARYSPMGMTCYCLE has been selected as the preferred name, because it more accurately describes the function.

MIGRATIONCLEANUPCYCLE(cycle) or SECONDARYSPMGMTCYCLE(cycle): For cycle, substitute a string of alphabetic Ys and Ns. Each Y represents a day in the cycle when migration cleanup and level 1 to level 2 migration run. Each N represents a day in the cycle when migration cleanup and level 1 to level 2 migration do not run. You can represent up to 31 days with the Ys and Ns. When you specify MIGRATIONCLEANUPCYCLE or SECONDARYSPMGMTCYCLE, the current day is the first day of the cycle, unless you specify a cycle start date.

CYCLESTARTDATE can be used with either parameter and is covered separately under CYCLESTARTDATE: Specifying the start date of a cycle.

Defaults: If you do not specify MIGRATIONCLEANUPCYCLE or SECONDARYSPMGMTCYCLE, cycle defaults to a one-day cycle. Therefore, if a start time has been specified by a SETSYS SECONDARYSPMGMTSTART command, automatic secondary space management functions will run every day.

If you do not specify both cycle and CYCLESTARTDATE, DFSMShsm sets cycle to a one-day cycle and CYCLESTARTDATE to the current date. Therefore, if a start time has been specified by a SETSYS SECONDARYSPMGMTSTART command, automatic secondary space management functions run every day.

Note: It is important to understand the difference between cycle days and calendar days. The first cycle day, DAY 1, begins at the start time of the function. The second cycle day, DAY 2, begins when this start time has again been reached, regardless of when the new calendar day begins. Third and subsequent days follow the same pattern. For instance, if the cycle start time for a function is 1100 (11 a.m.) on Monday, DAY 1 runs from 11 a.m. on Monday to 10:59 a.m. on Tuesday. DAY 2 begins after 11 a.m. on Tuesday and continues until 10:59 a.m. on Wednesday.