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:

For ABACKUP Processing:

For ARECOVER Processing:

 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.

 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.

 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.

 SETSYS AUTODUMPSTART(0100 0400 0630)  +
        BACKUP  +
        BACKUPPREFIX(HSM)  +
        DUMPIO(4,3) +
        MAXDUMPTASKS(2)  +
        VOLUMEDUMP(PREFERRED)                

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.

 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.

 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.

 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.

 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.

 SETSYS  ACTLOGMSGLVL(FULL) +
         ACTLOGTYPE(DASD) +
         NODEBUG +
         NOEMERGENCY +
         MIGRATIONCLEANUPDAYS(10 90) +
         MONITOR(NOSTARTUP NOSPACE NOVOLUME) +
         PDA +
         SMF(240) +
         SYSOUT(D 1 6LPI)+
         SYS1DUMP                     

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.

 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.

 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.

 SETSYS COMMONQUEUE(RECALL(CONNECT(PLEX1)))  +
        CONVERSION +
        EXITON(RP) +
        MAXRECALLTASKS(15)  +
        TAPEMAXRECALLTASKS(5)+
        VOLCOUNT(ANY)              

Specifying the SETSYS parameters for recover processing

In this example, the SETSYS parameters associated with recover 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.

 SETSYS CONVERSION   +
        EXITON(CD) +
        MAXDSRECOVERTASKS(2)  +
        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.

 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.

 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.

 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))