Examples of how to code the SETSYS command

The following examples present common user scenarios that you can use to code the SETSYS command for your installation. Both main functions and supporting functions are illustrated in the examples. The functions are arranged in alphabetical order.

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

Specifying the SETSYS parameters for ABARS processing

In this example, the SETSYS parameters associated with both ABACKUP and ARECOVER processing are specified. Where appropriate, default values or recommended values are used in the example. These parameters are in effect until another SETSYS command is issued to change them.

For ABARS Processing:

  • All DFSMSdss messages are intercepted and written in the ABARS activity log. Parameter used is ABARSACTLOGMSGLVL(FULL).
  • The ABARS activity log is written to DASD. Parameter used is ABARSACTLOGTYPE(DASD).
  • Allow ABARS to use the default number of I/O buffers. Parameter used is ABARSBUFFERS(1).
  • DFSMShsm is to delete the ABARS activity log during ABARS roll-off processing or EXPIREBV ABARSVERSIONS processing. Parameter used is ABARSDELETEACTIVITY(Y).
  • Allow ABARS to use the default base procedure name when starting the ABARS secondary address space. Parameter used is ABARSPROCNAME(DFHSMABR).
  • Allow DFSMShsm to stack the ABACKUP output. Parameter used is ABARSTAPES(STACK).
  • Use 3590-1 as a unit name for ABARS. Parameter used is ABARSUNITNAME(3590-1).
  • Use the default number of concurrent secondary addresses supported by DFSMShsm. Parameter used is MAXABARSADDRESSSPACE(1).
  • The following DFSMShsm installation exits are active: ABARS expiration date setting exit, aggregate backup error exit, aggregate backup ML2 bypass exit, aggregate recovery conflict resolution exit, aggregate recovery bypass exit, and ABARS tape volume exit. Parameter used is EXITON(ED BE M2 CR SK TV).

For ABACKUP Processing:

  • Use the default OPTIMIZE value when ABACKUP invokes DFSMSdss to backup level 0 DASD data sets. Parameter used is ABARSOPTIMIZE(3).
  • Data sets on volumes protected by peer-to-peer remote copy or extended remote copy are backed up by ABACKUP processing. Parameters used are ABARSKIP(NOPPRC NOXRC).

For ARECOVER Processing:

  • Allow DFSMShsm to pass the VOLCOUNT parameter to DFSMSdss during the ARECOVER of L0 data sets. You want to allocate as many volumes as required for the target data set. Parameter used is ABARSVOLCOUNT(ANY).
  • Use 3590-1 tape units when recovering user tape volumes. Parameter used is ARECOVERUNITNAME(3590-1).
  • Use 3590-1 tape units when recovering migrated data sets to ML2 tape volumes. Parameter used is ARECOVERML2UNIT(3590-1).
  • Use the default percentage of DASD space when filling non-SMS-managed recovery volumes. Parameter used is ARECOVERPERCENTUTILIZED(80).
  • Allow DFSMShsm to pass the TGTGDS parameter to DFSMSdss during restore processing of SMS-managed generation data sets to level 0 DASD. Parameter used is ARECOVERTGTGDS(SOURCE).
 SETSYS ABARSACTLOGMSGLVL(FULL)  +
        ABARSACTLOGTYPE(DASD)   +
        ABARSBUFFERS(1)   +
        ABARSDELETEACTIVITY(Y)   +
        ABARSPROCNAME(DFHSMABR)   +
        ABARSTAPES(STACK)  +
        ABARSUNITNAME(3590-1)   +
        MAXABARSADDRESSSPACE(1)  +
        EXITON(ED BE M2 CR SK TV)  +
        ABARSOPTIMIZE(3)    +
        ABARSKIP(NOPPRC NOXRC)   +
        ABARSVOLCOUNT(ANY)    +
        ARECOVERUNITNAME(3590-1)  +
        ARECOVERML2UNIT(3590-1)  +
        ARECOVERPERCENTUTILIZED(80)  +
        ARECOVERTGTGDS(SOURCE)
 

Specifying the SETSYS parameters for backup processing

In this example, the SETSYS parameters associated with backup processing are specified. Where appropriate, default values or recommended values are used in the examples. These parameters are in effect until another SETSYS command is issued to change them.

  • Automatic backup can start between 0030 (12:30 a.m.) and 0400 (4:00 a.m.) hours. DFSMShsm does not begin on additional volumes after 0730 (7:30 a.m.) hours. Parameter used is AUTOBACKUPSTART(0030 0400 0730).
  • If the backup processing finds a data set in use, DFSMShsm is to retry the backup after a delay of 60 minutes, and accept the backup version even if the data set is still in use. Parameter used is BACKUP(INUSE (RETRY(Y) DELAY(60) SERIALIZATION(PREFERRED))).
  • DFSMShsm can compact a data set during backup processing to DASD. Parameter used is COMPACT(DASDBACKUP).
  • You want DFSMShsm to use the backup prefix name of HSM. Parameter used is BACKUPPREFIX(HSM).
  • DFSMShsm does not compact a data set unless 40% of the total space is saved. Parameter used is COMPACTPERCENT(40).
  • DFSMShsm creates original backup tapes that will be kept on site and alternate backup tapes that will be written at a remote site. Parameter used is DUPLEX(BACKUP(Y)).
  • The following installation exits are active: data set backup exit and space management and backup exit. Parameter used is EXITON(BD SA).
  • DFSMShsm creates backup versions when data sets are changed. Parameter used is INCREMENTALBACKUP(CHANGEDONLY).
  • DFSMShsm can backup eight DASD volumes concurrently on this host. Parameter used is MAXBACKUPTASKS(8).
  • DFSMShsm retains two tape allocations for 120 minutes of inactivity, until command data set backups directed to tape are held, or until DFSMShsm shuts down before deallocating the drives. Parameter used is DSBACKUP(TAPE(DEMOUNTDELAY(MAXIDLETASKS(2) MINUTES(120)))).
 SETSYS AUTOBACKUPSTART(0030 0400 0730) +
        BACKUP(INUSE(RETRY(Y) DELAY(60) SERIALIZATION(PREFERRED))) +
        BACKUPPREFIX(HSM)    +
        COMPACT(DASDBACKUP)   +
        COMPACTPERCENT(40)   +
        DUPLEX(BACKUP(Y))  +
        EXITON(BD SA) +
        INCREMENTALBACKUP(CHANGEDONLY) +
        MAXBACKUPTASKS(8) +
        DSBACKUP(TAPE(DEMOUNTDELAY(MAXIDLETASKS(2) MINUTES(120))))

Specifying the SETSYS parameters for DFSMShsm control data sets

In this example, the SETSYS parameters associated with DFSMShsm control data sets processing are specified. Where appropriate, default values or recommended values are used in the examples. These parameters are in effect until another SETSYS command is issued to change them.

  • DFSMShsm invokes the DFSMSdss logical dump function for each control data set backed up. Parameter used is CDSVERSIONBACKUP(DATAMOVER(DSS)).
  • DFSMShsm backs up control data sets and the journal data set to scratch tapes. Parameter used is CDSVERSIONBACKUP(BACKUPDEVICECATEGORY(TAPE)).
  • DFSMShsm keeps twenty backup copies for each control data set and journal data set. Parameter used is CDSVERSIONBACKUP(BACKUPCOPIES(20)).
  • You want DFSMShsm to use HSM.BCDS.BACKUP as the initial characters when allocating the backup data set for the BCDS. Parameter used is CDSVERSIONBACKUP(BCDSBACKUPDSN(HSM.BCDS.BACKUP)).
  • You want DFSMShsm to use HSM.MCDS.BACKUP as the initial characters when allocating the backup data set for the MCDS. Parameter used is CDSVERSIONBACKUP(MCDSBACKUPDSN(HSM.MCDS.BACKUP)).
  • You want DFSMShsm to use HSM.OCDS.BACKUP as the initial characters when allocating the backup data set for the OCDS. Parameter used is CDSVERSIONBACKUP(OCDSBACKUPDSN(HSM.OCDS.BACKUP)).
  • You want DFSMShsm to use HSM.JRNL.BACKUP as initial characters when allocating the backup data set for the journal data set. Parameter used is CDSVERSIONBACKUP(JRNLBACKUPDSN(HSM.JRNL.BACKUP)).
  • The control data set backup exit is active. Parameter used is EXITON(CB).
  • No startup, space use, or data set messages appear at the system console. Parameter used is MONITOR(NOSTARTUP NOSPACE NOVOLUME).
  • DFSMShsm writes the BCDS, MCDS, and OCDS data set records in the journal data set when updated. Parameter used is JOURNAL(RECOVER).
 SETSYS CDSVERSIONBACKUP(DATAMOVER(DSS) +
                         BACKUPDEVICECATEGORY(TAPE)  +
                         BACKUPCOPIES(20) +
                         BCDSBACKUPDSN(HSM.BCDS.BACKUP) +
                         MCDSBACKUPDSN(HSM.MCDS.BACKUP) +
                         OCDSBACKUPDSN(HSM.OCDS.BACKUP) +
                         JRNLBACKUPDSN(HSM.JRNL.BACKUP)) +
                         EXITON(CB) +
                         MONITOR(NOSTARTUP NOSPACE NOVOLUME)+
                         JOURNAL(RECOVER) 

Specifying the SETSYS parameters for dump processing

In this example, the SETSYS parameters associated with dump processing are specified. Where appropriate, default values or recommended values are used in the example. These parameters are in effect until another SETSYS command is issued to change them.

  • Automatic dump can start between 0100 (1:00 a.m.) and 0400 (4:00 a.m.) hours. DFSMShsm does not begin additional volumes after 0630 (6:30 a.m.). Parameter used is AUTODUMPSTART(0100 0400 0630).
  • You intend to use the following DFSMShsm functions: backup, dump, recovery, and expiring backup versions. Parameter used is BACKUP.
  • You want DFSMShsm to use HSM as the first qualifier in the dump copy name. Parameter used is BACKUPPREFIX(HSM).
  • DFSMShsm specifies to DFSMSdss that the fourth buffering technique is used for DFSMSdss DASD I/O for a full-volume dump. The fourth buffering technique has DFSMSdss read one cylinder at a time. DFSMShsm specifies to DFSMSdss that the third buffering technique is used for DFSMSdss DASD I/O, and DFSMSdss is to read five tracks at a time. Parameter used is DUMPIO(4,3).
  • DFSMShsm can concurrently process two volume dump tasks. Parameter used is MAXDUMPTASKS(2).
  • DFSMShsm requests that DFSMSdss use the Concurrent Copy function for dump volumes because they have adequate cache for the changed data at the time volume dumps are running. Parameter used is VOLUMEDUMP(PREFERRED). DFSMSdss prefers to use virtual concurrent copy if available. If virtual concurrent copy is not available cache-based concurrent copy is attempted. If both types of concurrent copy are unavailable, the data set dump continues as if the Concurrent Copy keyword was not specified.
  • Start of changeThe DFSMShsm host is connected to the XCF group ARCDDMP1 for common dump queue processing. This host is eligible to be the master scheduler for that functional group. All available dump tasks in the HSMplex hosts that are connected to the group as members can be used to process dump copy requests as they are received on this local host. The parameter used is COMMONQUEUE(DUMP(CONNECT(DMP1))). End of change
 SETSYS AUTODUMPSTART(0100 0400 0630)  +
        BACKUP  +
        BACKUPPREFIX(HSM)  +
        DUMPIO(4,3) +
        MAXDUMPTASKS(2)  +
        VOLUMEDUMP(PREFERRED)
        Start of changeCOMMONQUEUE(DUMP(CONNECT(DMP1)))End of change         

Specifying the SETSYS parameters for expiration processing

In this example, the SETSYS parameter associated with expiration processing is specified. Where appropriate, default values or recommended values are used in the example. This parameter is in effect until another SETSYS command is issued to change it.

  • DFSMShsm scratches data sets that have an expired expiration date when performing space management and migration cleanup. Parameter used is EXPIREDDATASETS(SCRATCH).
 SETSYS  EXPIREDDATASETS(SCRATCH)                     

Specifying the SETSYS parameters for extent reduction processing

In this example, the SETSYS parameter associated with extent reduction processing is specified. Where appropriate, default values or recommended values are used in the example. This parameter is in effect until another SETSYS command is issued to change it.

  • DFSMShsm reallocates all non–VSAM data sets that equal or exceed five extents. Parameter used is MAXEXTENTS(5).
 SETSYS MAXEXTENTS(5)            

Specifying the SETSYS parameters for fast replication processing

In this example, the SETSYS parameters that are associated with fast replication processing are specified. Where appropriate, default values or recommended values are used in the example. These parameters are in effect until another SETSYS command is issued to change them.

  • The maximum number of DFSMSdss invocations for each FRBACKUP command that DFSMShsm can process concurrently is 15.
  • The maximum number of DFSMSdss invocations for each FRRECOV command that DFSMShsm can process concurrently is 15.
  • The maximum number of volume pairs that DFSMShsm passes to each DFSMSdss invocation concurrently for backup and recover functions is 24.
 SETSYS MAXCOPYPOOLTASKS(FRBACKUP(15) FRRECOV(15) DSS(24))

Specifying the SETSYS parameters for interval migration processing

In this example, the SETSYS parameters associated with interval migration processing are specified. Where appropriate, default values or recommended values are used in the example. These parameters are in effect until another SETSYS command is issued to change them.

  • The space management volume exit is active. Parameter used is EXITON(MV).
  • DFSMShsm does interval migration if the occupied space on a primary volume is equal to or exceeds a high threshold level when the periodic hourly space check is performed. Parameter used is INTERVALMIGRATION.
  • DFSMShsm can concurrently process eight automatic interval migration tasks. Parameter used is MAXINTERVALTASKS(8).
 SETSYS EXITON(MV) +
        INTERVALMIGRATION  +
        MAXINTERVALTASKS(8)            

Specifying the SETSYS parameters for DFSMShsm logging and diagnosis

In this example, the SETSYS parameters associated with DFSMShsm logging and diagnosis are specified. Where appropriate, default values or recommended values are used in the example. These parameters are in effect until another SETSYS command is issued to change them.

  • DFSMShsm generates and logs messages for all activities. Parameter used is ACTLOGMSGLVL(FULL).
  • DFSMShsm dynamically allocates DASD data sets as the type of output data sets to receive messages. Parameter used is ACTLOGTYPE(DASD).
  • DFSMShsm is not operating in debug mode. Parameter used is NODEBUG.
  • DFSMShsm is not operating in emergency mode. Parameter used is NOEMERGENCY.
  • Migration cleanup deletes the MCDS data set records for data sets that are recalled more than 10 days ago and deletes daily and volume statistics records that were created more than 90 days ago. The records cleaned up by MIGRATIONCLEANUP are used by the REPORT command and by DCOLLECT. Parameter used is MIGRATIONCLEANUP(10 90).
  • No startup, space use, or data set messages appear at the system console. Parameter used is MONITOR(NOSTARTUP NOSPACE NOVOLUME).
  • The problem determination aid is enabled. Parameter used is PDA.
  • DFSMShsm writes SMF records that contain DFSMShsm statistics. Parameter used is SMF(240).
  • The output from DFSMShsm goes to system output class D, with one copy printed on a form identified by 6LPI. Parameter used is SYSOUT(D 1 6LPI).
  • DFSMShsm dumps are written to a system dump data set. Parameter used is SYS1DUMP.
  • Start of changeDFSMShsm will use a fast replication message data set.End of change
 SETSYS  ACTLOGMSGLVL(FULL) +
         ACTLOGTYPE(DASD) +
         NODEBUG +
         NOEMERGENCY +
         MIGRATIONCLEANUPDAYS(10 90) +
         MONITOR(NOSTARTUP NOSPACE NOVOLUME) +
         PDA +
         SMF(240) +
         SYSOUT(D 1 6LPI)+
         SYS1DUMP  
         Start of changeFASTREPLICATION(MESSAGEDATASET(YES HLQ(MYHLQ)))End of change  

Specifying the SETSYS parameters for migration processing

In this example, the SETSYS parameters associated with migration processing are specified. Where appropriate, default values or recommended values are used in the example. These parameters are in effect until another SETSYS command is issued to change them.

  • DFSMShsm can compact data sets during migration processing to DASD. Parameter used is COMPACT(DASDMIGRATE).
  • DFSMShsm does not compact a data set unless 40% of the total space is saved. Parameter used is COMPACTPERCENT(40).
  • The following installation exits are active: data set migration exit, second level migration data set exit, space management volume exit, and space management and backup exit. Parameter used is EXITON(MD MM MV SA).
  • DFSMShsm deletes data sets that have an expired expiration date. Parameter used is EXPIREDDATASETS(SCRATCH).
  • DFSMShsm runs up to eight automatic volume space management tasks concurrently. Parameter used is MAXMIGRATIONTASKS(8).
  • You want DFSMShsm to use the migration prefix name of HSM. Parameter used is MIGRATEPREFIX(HSM).
  • Automatic primary space management begins if DFSMShsm is running at 0230 (2:30 a.m.). DFSMShsm ends automatic primary space management at 0630 (6:30 a.m.). Parameter used is PRIMARYSPMGMTSTART(0230 0630).
  • All eligible data sets with a data set source size of 100 KB or less are considered as candidates for migration to a small-data-set-packing data set. Parameter used is SMALLDATASETPACKING(KB(100)).
 SETSYS COMPACT(DASDMIGRATE)  +
        COMPACTPERCENT(40) +
        EXITON(MD MM MV SA) +
        EXPIREDDATASETS(SCRATCH) +
        MAXMIGRATIONTASKS(8) +
        MIGRATEPREFIX(HSM)   +
        PRIMARYSPMGMTSTART(0230 0630) +
        SMALLDATASETPACKING(KB(100))                        

Specifying the SETSYS parameters for DFSMShsm processing in an MVS environment

In this example, the SETSYS parameters associated with DFSMShsm processing in an MVS™ environment are specified. Where appropriate, default values or recommended values are used in the example. These parameters are in effect until another SETSYS command is issued to change them.

  • DFSMShsm uses the defaults for CSA limiting. Parameter used is CSALIMITS(ACTIVE(90) INACTIVE(30) MAXIMUM(100) MWE(4)).
  • The following installation exits are active: initialization exit and shutdown exit. Parameter used is EXITON(IN SD).
  • DFSMShsm uses job entry subsystem 2. Parameter used is JES2.
  • The DFSMShsm address space cannot be swapped by the MVS system resource manager. Parameter used is NOSWAP.
  • DFSMShsm uses the default HSMplex name of ARCPLEX0. Parameter used is PLEXNAME(PLEX0).
  • DFSMShsm considers all host in an HSMplex eligible for promotion to take over the primary functions of a failed host. Parameter used is PROMOTE(PRIMARYHOST(YES)).
  • During volume backup or migration in a multiple-DFSMShsm-host environment, system facilities like GRS, perform data set serialization of system resources. Parameter used is USERDATASETSERIALIZATION.
 SETSYS CSALIMITS(ACTIVE(90) INACTIVE(30) MAXIMUM(100) MWE(4)) +
        EXITON(IN SD) +
        JES2 +
        NOSWAP +        
        PLEXNAME(PLEX0) +
        PROMOTE(PRIMARYHOST(YES)) +
        USERDATASETSERIALIZATION                     

Specifying the SETSYS parameters for recall processing

In this example, the SETSYS parameters associated with recall processing are specified. Where appropriate, default values or recommended values are used in the example. These parameters are in effect until another SETSYS command is issued to change them.

  • The DFSMShsm host is connected to the SYSARC_PLEX1_RCL common recall queue list structure. The parameter that is used is COMMONQUEUE(RECALL(CONNECT(PLEX1))).
  • DFSMShsm can reblock data sets during recall processing. The parameter that is used is CONVERSION.
  • The return-priority installation exits are active. Parameter used is EXITON(RP).
  • A maximum of fifteen recall tasks can process concurrently. The parameter that is used is MAXRECALLTASKS(15).
  • A maximum of five tape recall tasks that can concurrently request tape mounts. The parameter that is used is TAPEMAXRECALLTASKS(5).
  • DFSMShsm passes the volume count parameter to DFSMSdss during the recall or recover of data that is moved by DFSMSdss. The parameter that is used is VOLCOUNT(ANY).
 SETSYS COMMONQUEUE(RECALL(CONNECT(PLEX1)))  +
        CONVERSION +
        EXITON(RP) +
        MAXRECALLTASKS(15)  +
        TAPEMAXRECALLTASKS(5)+
        VOLCOUNT(ANY)              

Specifying the SETSYS parameters for recycle processing

In this example, the SETSYS parameters associated with recycle processing are specified. Where appropriate, default values or recommended values are used in the example. These parameters are in effect until another SETSYS command is issued to change them.

  • A maximum of two recycle tasks can process concurrently. Parameter used is MAXRECYCLETASKS(2).
  • When recycling tape volumes, each DFSMShsm recycle task deallocates its input unit after each 5 connected sets of backup volumes, and after each 5 connected sets of ML2 volumes. Note: the values specified here are considered to be safe compromise values in single technology environments and you should refer to this parameters description before deciding what values to use for your installation. Parameter used is RECYCLEINPUTDEALLOCATION(BACKUP(5) MIGRATION(5)).
  • During recycle processing of a tape backup volume or a tape level 2 volume, only tape spill backup volumes or tape level 2 migration volumes that can be mounted and written on the specified unit type are used for output. Parameter used is RECYCLEOUTPUT(BACKUP(3590-1) MIGRATION(3590-1)).
  • DFSMShsm uses the percent valid criteria to recycle both backup and migration tape volumes. Parameter used is RECYCLEPERCENT(20).
  • DFSMShsm does not wait for the recycle tape unit to be allocated for the source and target tape volumes. Parameter used is RECYCLETAPEALLOCATION(NOWAIT).
 SETSYS MAXRECYCLETASKS(2)   +
        RECYCLEINPUTDEALLOCATION(BACKUP(5) MIGRATION(5)) +
        RECYCLEOUTPUT(BACKUP(3590-1) MIGRATION(3590-1))  +
        RECYCLEPERCENT(20)  +
        RECYCLETAPEALLOCATION(NOWAIT)     

Specifying the SETSYS parameters for secondary space management

In this example, SETSYS parameters associated with Secondary Space Management processing are specified. Where appropriate, default values or recommended values are used in the example. These parameters are in effect until another SETSYS command is issued to change them.

  • Automatic secondary space management begins if DFSMShsm is running at 0800 (8:00 a.m.). DFSMShsm ends automatic secondary space management at 1700 (5:00 p.m.). Note: MWEs built by secondary space management up to 1700 continue to process. If a large number of data sets needs deletion, MWE processing continues after secondary space management stops. Parameter used is SECONDARYSPMGMTSTART(0800 1700).
  • DFSMShsm keeps MCDS records for recalled data sets for 10 days. Volume statistics records are kept for 30 days and MCDS records for reconnection are kept for 3 days. Parameter used is MIGRATIONCLEANUPDAYS(10 30 3).
  • A maximum of fifteen recall tasks can process concurrently. The parameter that is used is MAXRECALLTASKS(15).
  • The maximum number of automatic secondary space management Statistics and Migration cleanup tasks that can run concurrently is 2.
  • The maximum number of automatic secondary space management migration tasks for data sets from level 1 volumes to level 2 tape volumes that can run concurrently is 1.
 SETSYS  SECONDARYSPMGMTSTART(0800 1700) +
         MIGRATIONCLEANUPDAYS(10 30 3) +
         MAXRECALLTASKS(15)  +
         MAXSSMTASKS(CLEANUP(2) TAPEMOVEMENT(1))

Specifying the SETSYS parameters for DFSMShsm processing in a security environment

In this example, the SETSYS parameters associated with DFSMShsm processing in a security environment are specified. Where appropriate, default values or recommended values are used in the example. These parameters are in effect until another SETSYS command is issued to change them.

  • DFSMShsm asks RACF® for the erase status of a users data set when backup versions and migration copies are scratched from DFSMShsm-owned DASD volumes and if so requested, causes data management to overwrite the storage of the owned copy. Parameter used is ERASEONSCRATCH.
  • DFSMShsm does not create a backup RACF discrete profile when it backs up a cataloged RACF-indicated data set. Parameter used is NOPROFILEBACKUP.
  • DFSMShsm does not put RACF-indication on backup versions and migration copies. Parameter used is NORACFIND.
  • DFSMShsm protects tapes with RACF. In addition, DFSMShsm backups up or migrates a password-protected data set to a tape volume that is not password-protected. Parameter used is TAPESECURITY(RACFINCLUDE).
 SETSYS  ERASEONSCRATCH +
         NOPROFILEBACKUP  +
         NORACFIND +
         TAPESECURITY(RACFINCLUDE)                    

Specifying the SETSYS parameters for DFSMShsm processing in a tape environment

In this example, the SETSYS parameters associated with DFSMShsm processing in a tape environment are specified. Where appropriate, default values or recommended values are used in the example. These parameters are in effect until another SETSYS command is issued to change them.
  • DFSMShsm specifies to DFSMSdss that the fourth buffering technique is used for DFSMSdss DASD I/O for a full-volume dump. The fourth buffering technique has DFSMSdss read one cylinder at a time. DFSMShsm specifies to DFSMSdss that the third buffering technique is used for DFSMSdss DASD I/O, and DFSMSdss is to read five tracks at a time. Parameter used is DUMPIO(4,3).
  • DFSMShsm creates original backup tapes and migration tapes that will be kept on site and alternate tapes that will be written at a remote site. Parameter used is DUPLEX(BACKUP(Y) MIGRATION(Y)).
  • The following installation exits are active: tape data set exit, and tape ejected exit. Note: the TV exit is not included because most customers are using DFSMSrmm. Parameter used is EXITON(TD TE).
  • DFSMShsm does not wait for an input tape unit to be allocated because in this example, the customer has plenty of tape units generally available. Parameter used in INPUTTAPEALLOCATION(NOWAIT).
  • The number of allowable, not associated ML2 partial tapes is five. You want to recycle all not associated ML2 partial tapes. Parameter used is ML2PARTIALSNOTASSOCIATEDGOAL(5).
  • DFSMShsm waits 15 minutes for a tape to be mounted on a nonlibrary allocated drive. Parameter used is MOUNTWAITTIME(15).
  • DFSMShsm does not mark cartridge-type single-file formatted tape volumes full when the volume has been demounted. Parameter used is PARTIALTAPE(REUSE).
  • DFSMShsm requests scratch tape volumes when an end-of-volume condition occurs on a tape volume. Parameter used is SELECTVOLUME(SCRATCH).
  • The recycled tape volumes are deleted from DFSMShsm control and become scratch tapes. Parameter used is TAPEDELETION(SCRATCHTAPE).
  • DFSMShsm migrates data sets to 3590-1 tape volumes when migrating the volumes to ML2. DFSMShsm attempts reconnection to ML2 tape on all data sets eligible to migrate. Parameter used is TAPEMIGRATION(ML2TAPE RECONNECT(ALL)).
  • DFSMShsm does issue action messages to the operator asking if tapes needed by DFSMShsm recall, recover, and recycle input are available because a customer has nonrobotic tape mounting. Parameter used is TAPEINPUTPROMPT(BACKUPTAPES(NO) DUMPTAPES(NO) MIGRATIONTAPES(NO)).
  • DFSMShsm issues a message to the operator during TAPECOPY processing. Parameter used is TAPEOUTPUTPROMPT(TAPECOPY(YES)).
  • DFSMShsm reduces the occurrence of data set spanning tape volumes. The subparameter value of 1000 is well suited for 3590-1. Parameter used is TAPESPANSIZE(1000).
  • DFSMShsm allows a recall task to be used continuously for tape recalls for at least 10 minutes and have a tape allocated and mounted for at least 5 minutes before allowing another DFSMShsm host to take the tape away for a higher priority request. Parameter used is TAPERECALLLIMITS(TASK(10) TAPE(5)).
  • The 3590-1 tape unit is allocated to initially select scratch tapes during backup or dump. Parameter used is UNITNAME(3590-1).
  • Identify an esoteric tape unit name to DFSMShsm for output allocations of 3590-1 tape drives. Parameter used is USERUNITTABLE(TAPE).
  • DFSMShsm forces an end-of-volume (EOV) when a tape volume has reached the desired level of utilization (fullness). You want to use 97% of the capacity but retain the reduced tape spanning. Three separate SETSYS commands are required to specify each unit type to be defined. Parameters used are TAPEUTILIZATION(UNITTYPE(3590-1) PERCENTFULL(97)) and TAPEUTILIZATION(LIBRARYBACKUP PERCENTFULL(97)) and TAPEUTILIZATION(LIBRARYMIGRATION PERCENTFULL(97)).
 SETSYS DUMPIO(4,3) +
        DUPLEX(BACKUP(Y) MIGRATION(Y)) +
        EXITON(TD TE) +
        INPUTTAPEALLOCATION(NOWAIT) +
        ML2PARTIALSNOTASSOCIATEDGOAL(0) +
        MOUNTWAITTIME(15) +
        PARTIALTAPE(REUSE) +
        SELECTVOLUME(SCRATCH) +
        TAPEDELETION(SCRATCHTAPE) +
        TAPEMIGRATION(ML2TAPE RECONNECT(ALL)) +
        TAPEINPUTPROMPT(BACKUPTAPES(NO) +
                        DUMPTAPES(NO) +
                        MIGRATIONTAPES(NO)) +
        TAPEOUTPUTPROMPT(TAPECOPY(YES)) +
        TAPESPANSIZE(1000) +
        TAPERECALLLIMITS(TASK(10) TAPE(5)) +
        UNITNAME(3590-1) +
        USERUNITTABLE(TAPE)
 SETSYS TAPEUTILIZATION(UNITTYPE(3590-1) PERCENTFULL(97))
 SETSYS TAPEUTILIZATION(LIBRARYBACKUP PERCENTFULL(97))
 SETSYS TAPEUTILIZATION(LIBRARYMIGRATION PERCENTFULL(97))