Examples of how to code the DEFINE command

The following examples present different ways to code the DEFINE command:

Note: Any values specified here are only examples and should not be interpreted as the values to be used for your system.

Specifying key ranges for DASD migration level 2 volumes

In this example, key ranges are assigned to the specified migration level 2 volumes. Data sets with the set of initial characters of the data set name within key range A through F9999999 migrate to the level 2 volume with volume serial number VOL002. Data sets with the set of initial characters of the data set name within key range G through L9999999 migrate to the level 2 volume with volume serial number VOL005. Data sets with the set of initial characters of the data set name within key range M through R9999999 migrate to the level 2 volume with volume serial number VOL007. Data sets with the set of initial characters of the data set name within key range S through Z9999999 migrate to the level 2 volume with volume serial number VOL009.
   DEFINE MIGRATIONLEVEL2(KEYS(G M S) VOLUMES(VOL002 VOL005  +
          VOL007 VOL009))

Specifying a pool of volumes

In this example, two volumes are specified as the pool used when data sets with the pool ID FE.T3322 are recalled.
   DEFINE POOL(FE.T3322 VOLUMES(FET001 FET002))

Specifying the automatic primary space management cycle

In this example, an automatic primary space management cycle of five days is defined. The automatic primary space management functions are to run on the fifth day of the cycle. CYCLESTARTDATE without a date specified is redefined to today’s date.
   DEFINE PRIMARYSPMGMTCYCLE(NNNNY CYCLESTARTDATE)

Specifying the automatic secondary space management cycle

In this example, an automatic secondary space management cycle of seven days is defined. The automatic secondary space management functions are to run on the seventh day of the cycle. CYCLESTARTDATE without a date specified is redefined to today’s date.
   DEFINE SECONDARYSPMGMTCYCLE(NNNNNNY CYCLESTARTDATE)

Specifying a backup cycle

In this example, a backup cycle of seven days is defined, with two volumes used for each day in the cycle when volume backup is processed. The example specifies that the automatic backup function is processed on the second and fifth days of the cycle. The starting date for the backup cycle is October 1, 1997.
   DEFINE BACKUP(NYNNYNN 2 CYCLESTARTDATE(1997/10/01))

Specifying a dump cycle

In this example, a dump cycle of seven days is defined, with a cycle start date of 96/12/29. If the cycle start date is a Sunday, the specified dump cycle results in the automatic dump function running Monday through Friday, but not running on Saturday or Sunday.
   DEFINE DUMPCYCLE(NYYYYYN  +
          CYCLESTARTDATE(1996/12/29))

Specifying the number of VTOC copy data sets to keep for each volume dumped

In this example, 12 copies of the VTOC copy data sets are to be kept for a dumped volume.
   DEFINE DUMPCLASS(class VTOCCOPIES(12))

Specifying a dump class for a volume

In this example, a dump class for a 3590-1 type volume with a class name of weekly is defined. The other parameters used in our example are:
  • DFSMSdss resets the change bit for each data set.
  • A physical data set restore is allowed.
  • The volume can be automatically reused when invalidated by the retention period of 15 days.
  • The target day of the dump for this dump class is the sixth day of the dump cycle.
  • The dump volume is to be dumped every Friday night.
  • A maximum of ten dump copies can be placed on this volume.
   DEFINE DUMPCLASS(WEEKLY UNIT(3590-1)  +
          RESET DATASETRESTORE AUTOREUSE  +
          RETENTIONPERIOD(15) DAY(6)  +
          DISPOSITION('DUMP EVERY FRI NITE.') +
          (STACK(10)))

Specifying a pool of volumes to be used for recovering an aggregate group

In this example, four volumes are specified to be used for recovery of the aggregate group PAY1. Two volumes are for recovery of level 0 non-SMS-managed data sets, and two volumes are for recovery of migrated data sets.
   DEFINE ARPOOL(PAY1 ML1VOLS(MPAY1 MPAY2)  +
                      L0VOLS(PAY001 PAY002))

Specifying when to demount and deallocate output tapes that are used by command data set backup

In this example, output tapes that are used by command data set backup are demounted at the end of the autobackup cycle, and the devices are deallocated. Single-file format output tapes are not available for reuse when a switch tape event occurs.
   DEFINE SWITCHTAPES(DSBACKUP(AUTOBACKUPEND PARTIALTAPE(MARKFULL)))

Specifying encryption and HWCOMPRESS settings

In this example, the data will be compressed with hardware-assisted compression and then encrypted prior to being dumped.
   DEFINE DUMPCLASS(ENCRYPT(RSA(CCA.CRT08.INT.ENC.1024S0F)
          TYPE(CLRTDES)) HWCOMPRESS(YES))