PRIMARYSPMGMTSTART: Specifying the start and stop times for automatic primary space management

Explanation: PRIMARYSPMGMTSTART (hhmm1␠hhmm2) is an optional parameter specifying the times when automatic primary space management should start. Use this parameter instead of AUTOMIGRATIONSTART to set the start and stop times for automatic primary space management.

Using PRIMARYSPMGMTSTART(hhmm1 hhmm2), you can specify a planned start time and a planned end time. If DFSMShsm does not start automatic primary space management between the start and stop times, automatic primary space management is not performed for that day.

For hhmm1, substitute the planned start time for automatic primary space management. If you specify hhmm1 as zero, DFSMShsm does not start automatic primary space management.

For hhmm2, substitute the planned stop time when DFSMShsm no longer starts automatic primary space management on a new volume. If hhmm2 is set to zero, this is the same as not including the hhmm2 parameter.

The hhmm format expresses time as a four-digit decimal number that is based on the 24-hour clock. hh specifies the hour and mm specifies the minutes. For example, you can specify 1:15 p.m. as 1315, and you can specify midnight as 2400. The maximum value you can specify for hh is 24, the maximum value you can specify for mm is 59, and the maximum value you can specify for hhmm is 2400.

SMS relationship: Parameter has the same meaning when applied to SMS-managed or non-SMS-managed DASD volumes or data sets.

SETSYS default: If only one time is specified in PRIMARYSPMGMTSTART, DFSMShsm starts the automatic primary space management functions between the time specified and midnight. Automatic primary space management runs until completion.

DFSMShsm default: If PRIMARYSPMGMTSTART is not specified, the default is no automatic primary space management (unless AUTOMIGRATIONSTART was specified).
Note:
  1. If you do not specify a nonzero value for hhmm1 during start up of DFSMShsm, DFSMShsm does not perform automatic primary space management.
  2. The type of automatic primary space management DFSMShsm does on a particular volume (data set deletion, data set retirement, or migration) depends on the parameter you have specified with the ADDVOL command.
  3. If you want the operator to decide whether to start automatic primary space management, specify the REQUEST parameter with the PRIMARYSPMGMTSTART parameter.
  4. As with automatic backup, DFSMShsm serializes access to data sets and volumes for a short period of time. Therefore, select a time for automatic primary space management when the computing system is not very active and there is not much interactive user activity (usually at night).
  5. Automatic primary space management usually starts at the planned start time. Assume, however, that DFSMShsm is not running at the planned start time or the operating system is lost while automatic primary space management is running. When DFSMShsm restarts, it checks the start (hhmm1) and stop (hhmm2) times. These start and stop times form a window. If DFSMShsm restarts during the window, DFSMShsm also restarts automatic primary space management.
  6. PRIMARYSPMGMTSTART fails if hhmm1 and hhmm2 are equal.
  7. In a test environment, DFSMShsm can run automatic primary space management multiple times a day. However, this procedure requires certain DFSMShsm supported patches. Refer to the z/OS DFSMShsm Implementation and Customization Guide for more information about running primary space management multiple times a day. If automatic primary space management runs to completion and you want to start automatic primary space management again, use the following procedure:
    • Issue the SETSYS PRIMARYSPMGMTSTART command to define a new start window.
    • Specify a start window that has a planned start time (hhmm1) that is after the time that automatic primary space management last ended.

    Automatic primary space management starts immediately if the current time is between the start and stop times you specified. If the current time is not between the start and stop times you specified, automatic primary space management starts automatically when the planned start time is reached.

  8. If PRIMARYSPMGMTSTART is issued dynamically with a zero value forhhmm1 to convert to no longer running the function and automatic primary space management is currently running, it runs to completion with the originally established planned stop time. This is true regardless of the hhmm2 value specified in the newly issued command. DFSMShsm does not start automatic primary space management again unless another command is issued establishing a new start time. A QUERY SETSYS will show zero for the planned start time and the originally established stop time.