3032 - A Guided Tour of The DFSMSHSM Parmlib, Part 1 of 2

Joint SHARE/GUIDE Technical Conference
Washington, D.C.
3032/3033: Advanced HSM: A Guided

Tour of the DFSMShsm Parmlib
Project: MVS Storage Management (MVSS) Project

Session Number: 3032/3033
Presented by: Stan Kissinger
IBM Corporation
9000 S. Rita Road
Tucson, AZ 85744
kissingr@us.ibm.com
ABSTRACT
The ARCCMDxx parmlib member controls the operations of one
of the most important programs in your installation, DFSMShsm.
The speaker will point out areas you need to investigate if you
are new to HSM or simply have not reviewed your ARCCMDxx
recently. The various commands included in ARCCMDxx, along
with their recommended settings and recent parameter changes
will be discussed. In addition, operational parameters set in
ARCCMDxx will be compared and contrasted with their
equivalent SMS constructs for those in the process of converting
volumes to SMS management.
Permission is granted to SHARE to publish this presentation solely in connection with SHARE proceedings
designated by International Business Machines Corporation. All other rights are expressly reserved.
Joint SHARE/GUIDE - 3032/3033 (c) Copyright IBM Corporation, 1998 All rights reserved 1
The Following are Trademarks of
the IBM Corporation
IBM
DFSMSdss
DFDSS
DFSMShsm
DFHSM
IPCS
NETVIEW
AGENDA
General Directions
Setting up the General Environment
Setting Up Tape
Setting Up Space Management
Setting Up Backup
Setting Up Dump
Setting Up ABARS
Setting Up Primary and ML1 Volumes
GENERAL DIRECTIONS
W E
Identifying the HSM Parmlib
Identify the Parmlib to be used
HSMPARM DD card in HSM startup procedure
Defaults to SYS1.PARMLIB
DFSMShsm r1.3.0 supports concatenated parmlib

(requires OW20341)
Identify which ARCCMDxx to be used
CMD=xx parameter on MVS START command for

DFSMShsm
CMD=xx parameter on EXEC card in startup procedure
Defaults to ARCCMD00
Verify using QUERY STARTUP command
Change Activity
Protect the Parmlib Member
Should reside in RACF-protected library
Limit write access to parmlib to prevent unintended

HSM authorized users
Record Changes in Prolog
ARCCMDxx should contain a prolog in which

changes can be recorded
Prolog should identify the date of change, and who

made the change
Flag changed commands
/* Comments */
Use Comments Liberally
Comments enclosed within /* */ pair
Can appear anywhere in command line
Comment can span lines in ARCCMDxx
Particularly important for PATCHes and any other

temporary changes
Conditional Processing
ONLYIF HSMHOST(hostid)
Conditional processing based on Host identifier
Specify only the 1-character hostid, not the Y or N

primary-host identifier
Single command following ONLYIF executed based

on match on HOST=xy parameter in startup
procedure
Useful for sharing ARCCMDxx across systems
Example
ONLYIF HSMHOST(1)
SETSYS PRIMARYSPMGMTSTART(400 730)
ONLYIF HSMHOST(2)
SETSYS PRIMARYSPMGMTSTART(900 1100)
Information Preserved
across Startups
NEVER SOMETIMES ALWAYS
HOLD ADDVOL ALTERDS

PATCH DEFINE AUTH
SETSYS* SETMIG
TRAP
SETSYS CDSVERSIONBACKUP options are preserved

across startups
ADDVOL Information
Preserved across Startups
All information for tape ML2, tape Backup

and Dump volumes
Volume attributes for Primary volumes

AUTOMIGRATION, AUTOBACKUP, AUTODUMP
Space Management technique for Primary

volumes
MIGRATE, DBA, DBU
ADDVOL Information Not
Volume serial for Primary and ML1 volumes
Unit type for Primary and ML1 volumes
DEFINE Information
DASD ML2 keyranges
Primary and Secondary Space Management

cycles
Backup cycle
Dump cycle
Dump classes
DEFINE Information Not
RECALL pool information

DEFINE POOL
DEFINE VOLUMEPOOL
ARECOVER pool information
DEFINE ARPOOL
SETMIG Information
Preserved across startups

SETMIG DATASETNAME
Not preserved across startups
SETMIG LEVEL
SETMIG VOLUME
To Specify or to Not Specify
SPECIFY EVERYTHING!!!
Defaults change with maintenance and new

releases
Improved change control if all commands

appear in ARCCMDxx
One-stop setup verification
Command Sequence for
Parmlib
ISSUE THIS COMMAND BEFORE THIS COMMAND
SETSYS JES2 or JES3 Any other command

ADDVOL DEFINE POOL
DEFINE DUMPCLASS ADDVOL with AUTODUMP parm
SETSYS SETSYS
MAXRECALLTASKS TAPEMAXRECALLTASKS
SETSYS ADDVOL with SDSP
SMALLDATASETPACKING
SETSYS SYSOUT SETSYS ACTLOGTYPE
SETSYS USERUNITTABLE ADDVOL
DEFINE ARPOOL
DEFINE DUMPCLASS
SETSYS
ARECOVERUNITNAME
SETSYS BACKUP(TAPE)
SETSYS CDSVERSIONBACKUP
SETSYS MIGUNITNAME
SETSYS RECYCLEOUTPUT
SETSYS SPILL
SETSYS TAPEMIGRATION
SETSYS UNITNAME
SETSYS TAPEUTILIZATION
SETSYS SETSYS DAYS
USERDATASETSERIAL...
Setting Up
the General
Environment
System Specifications
SETSYS JES2 | JES3

Should be first command in ARCCMDxx if running
under JES3
SETSYS SWAP | NOSWAP

Specify SWAP only if you absolutely must
SETSYS CSALIMITS | NOCSALIMITS

Consider NOCSALIMITS if at DFSMShsm r1.2.0, or
higher
AUTH userid DBA(USER | CONTROL)

No security checking is performed for authorized users
First authorized user must be authorized in

ARCCMDxx
(cont)
SETSYS DFHSMDATASETSERIALIZATION |
USERDATASETSERIALIZATION
DFHSMDATASETSERIALIZATION uses volume
reserve with ARCMIGV or ARCBACV qname
USERDATASETSERIALIZATION uses SYSDSN

enqueue -- requires GRS (or equivalent) in multi-host
environment
SETSYS EMERGENCY | NOEMERGENCY

EMERGENCY stops all DFSMShsm automatic and
command data set processing
SETSYS REQUEST | NOREQUEST

REQUEST specifies that operator should be prompted
to permit automatic functions to start
(cont)
SETSYS CONVERSION | NOCONVERSION

Specifies that DFSMShsm should reblock data sets
during RECALL and RECOVER operations
Does not apply to system-reblockable data sets
SETSYS OPTIMUMDASDBLOCKING |
NOOPTIMUMDASDBLOCKING
Default changed to OPTIMUMDASDBLOCKING in
DFSMShsm r1.3.0
Default prior to DFSMShsm r1.3.0 is 2K blocksize
SETSYS DEBUG | NODEBUG

Typically used for testing changes to setup
Enabling Installation-wide
Exits
SETSYS EXITON(modname,modname,...)
Specifies which installation-wide exits to invoke
Replacement for SETSYS EXITS
New exits added to DFSMShsm

ARCCREXT - ABARS Conflict Resolution
ARCEDEXT - ABARS Expiration Date
ARCM2EXT - ABARS Migration Level 2
ARCSKEXT - ABARS Skip
ARCBEEXT - ABARS Backup Error
ARCRPEXT - Return Priority
ARCSDEXT - Shutdown
ARCTEEXT - Tape Ejected
SETSYS MONITOR
STARTUP | NOSTARTUP
Specify STARTUP to get messages for commands in
ARCCMDxx
VOLUME | NOVOLUME
Specify VOLUME only if your operators really love seeing
ARC0734I messages
SPACE | NOSPACE
Specify SPACE to use NETVIEW or other program to
take action if volumes not reaching target low threshold
JOURNAL(threshold) BCDS(threshold)
MCDS(threshold) OCDS (threshold)
Give yourself plenty of time to take action before Journal
or CDS actually fills
Default threshold is 80%
Journal, Trace, Dump, SMF
Options
SETSYS JOURNAL | NOJOURNAL
Default changed to JOURNAL(RECOVERY) with
OW34389
SETSYS PDA(ON | OFF | NONE)

Should be ON as a normal course of business
Requires ARCPDOX and ARCPDOY DD cards in startup

procedure to write to DASD
SETSYS SYS1DUMP | NOSYS1DUMP

Default changed to SYS1DUMP with OW13123 for
DFSMShsm r1.1.0 and higher
SETSYS SMF(id) | NOSMF

If SMF recording requested, can specify an ID between
128 and 255 not in use, specified ID used for VSR, DSR
and WWFSR records, ID+1 used for FSR records
SYSOUT and Log Options
SETSYS SYSOUT(class copies forms)

Default is class A, one copy, no special forms
SETSYS ACTLOGTYPE(SYSOUT(class) |
DASD)
Default is SYSOUT, using class from SETSYS SYSOUT
command
DASD allocations done using UNIT=SYSALLDA
SETSYS ACTLOGMSGLVL(FULL |
EXCEPTIONONLY | REDUCED)
Affects HSMLOGX, in addition to Activity Logs
Use SMF to get record of data sets successfully

processed if EXCEPTIONONLY is specified
SETSYS
CDSVERSIONBACKUP
BACKUPCOPIES(copies)
Default is 4, more is better
It is possible to roll off the last valid backup copy if enough

consecutive CDS backups fail
BACKUPDEVICECATEGORY(DASD |
TAPE(PARALLEL | NOPARALLEL
DENSITY(density) EXPIRATIONDATE(date) |
RETENTIONPERIOD(retpd))
Default is TAPE in NOPARALLEL mode with a 7-day
RETENTIONPERIOD
If DASD selected, can use ARCCBEXT to copy backup

copies to tape
If TAPE selected, specify EXPIRATIONDATE(99365) as

ARCTVEXT now called when CDS backup rolls off
PARALLEL always used when backing up to tape using DSS
SETSYS
CDSVERSIONBACKUP (cont)
DATAMOVER(DSS | HSM)
DSS allows use of Concurrent Copy
DSS verifies structural integrity of CDS
HSM internal datamover used for Journal
Additional step required when using Enhanced CDS

Recovery if CDS backed up with DSS
BCDSBACKUPDSN(dsname) -
MCDSBACKUPDSN(dsname) -
OCDSBACKUPDSN(dsname) -
JRNLBACKUPDSN(dsname)
Final qualifier of backup copy = Vnnnnnnn if HSM is
datamover, Dnnnnnnn if DSS is datamover
Watch out for final qualifier of Xnnnnnnn -- Error occurred!
Security Specifications
SETSYS RACFIND | NORACFIND

Specify NORACFIND and use generic profiles for
migration and backup copies
SETSYS TAPESECURITY(EXPIRATION |
EXPIRATIONINCLUDE | PASSWORD | RACF |
RACFINCLUDE)
If using tape management system, specify EXPIRATION |
EXPIRATIONINCLUDE
Either EXPIRATIONINCLUDE or RACFINCLUDE allow

backup and migration of password-protected data sets
Can specify more than one tape security option
PASSWORD requires that tapes be reinitialized when

returned to scratch, same with EXPIRATION |
EXPIRATIONINCLUDE unless handled by tape
management system
Security Specifications (cont)
SETSYS ERASEONSCRATCH |
NOERASEONSCRATCH
DASD migration and backup copies overwritten with
binary zeroes when scratched -- for a price
SETSYS PROFILEBACKUP |
NOPROFILEBACKUP
PROFILEBACKUP needed only if you have datasets with
RACF discrete profiles
SETSYS ACCEPTPSCBUSERID |
NOACCEPTPSCBUSERID
Specify ACCEPTPSCBUSERID only if you do not use

RACF or other security product which uses the SAF
interface
Data Set Compaction Options
SETSYS COMPACT(ALL | NONE)
Can also restrict compaction to DASDMIGRATE,
TAPEMIGRATE, DASDBACKUP, TAPEBACKUP
Compaction never done for hardware-compacted Level0

data sets
SETSYS COMPACTPERCENT(pct)
Default is 40%
Need to weigh DASD/tape savings against CPU cost
SETSYS OBJECTNAMES(objname...)
SOURCENAMES(srcname...)
Controls which compaction table is used based on last

qualifier of data set name (next-to-last for GDSs)
OBJECT - OBJLIB, LOAD, LOADLIB, LINKLIB
SOURCE - CNTL, JCL, PARMLIB, SRCE, TEXT, CLIST, ASM, COBOL, FORT, PLI
General compaction table if no match or not specified
Setting Up
Tape
SETSYS USERUNITTABLE
USERUNITTABLE(es1)
Output allocations done using es1 esoteric name, input
allocations done using equivalent generic name
USERUNITTABLE(es2out:es2in)
Output allocations done using es2out esoteric name, input
allocations done using es2in esoteric name
USERUNITTABLE(es3:es3)
Output allocations and input allocations done using es3

esoteric name
Note:
In order for esoteric translation to be performed, the esoteric group
must not contain a mixture of cartridge and non-cartridge loader
units. For d/t3490, it is assumed that all have cartridge loaders.
Setting up Tape Environment
SETSYS DEFERMOUNT
NODEFERMOUNT disabled in base DFSMShsm r1.3.0,
OW02687 (DFHSM r2.6.0) OW02689 (r1.1.0 & r1.2.0)
SETSYS TAPEHARDWARECOMPACT |
NOTAPEHARDWARECOMPACT
Selection allowed for d/t3480X only, compaction always
used for d/t3490 and d/t3590-1
SETSYS UNITNAME(unit)
Used when mounting a scratch tape for Backup or Dump

processing
SETSYS MIGUNITNAME(unit)
Used when mounting a scratch tape for Migration
processing
(cont)
SETSYS INPUTTAPEALLOCATION(WAIT |
NOWAIT) OUTPUTTAPEALLOCATION(WAIT |
NOWAIT) RECYCLETAPEALLOCATION(WAIT
| NOWAIT)
WAIT can cause noticeable performance degradation
due to contention for SYSZTIOT resource
SETSYS SELECTVOLUME(SCRATCH |
SPECIFIC)
Selection affects mounts at EOV time only
SETSYS TAPEDELETION(SCRATCHTAPE |
HSMTAPE)
Can specify separately for MIGRATION, BACKUP and

DUMP tapes
SCRATCHTAPE eliminates the need for a dedicated set

of tapes for DFSMShsm usage
(cont)
SETSYS PARTIALTAPE(MARKFULL |
REUSE)
Weigh cost of partial tapes vs. slot in automated library
Partials not eligible for generic TAPECOPY
SETSYS TAPEUTILIZATION(UNITTYPE(unit)
PERCENTFULL(pct) | NOLIMIT)
Should limit to 97% if using TAPECOPY
SETSYS TAPESPANSIZE(size)
Supported in DFSMShsm r1.1.0 and higher
Default size increased to 500MB in OW32249
Can help reduce tape mounts for RECYCLE
SETSYS NOLIMIT prevents tape span reduction -- Use

PERCENTFULL(100), instead
(cont)
SETSYS MOUNTWAITTIME(minutes)
Default is 15 minutes
OW34268 restores use of tape mount timer in ATL
SETSYS
TAPEINPUTPROMPT(MIGRATIONTAPES(YES
| NO) BACKUPTAPES(YES | NO)
DUMPTAPES(YES | NO)
No tape input prompting done when all tapes requested
are in an ATL
SETSYS DUPLEX(BACKUP(Y|N)
MIGRATION(Y|N))
Allows simultaneous creation of original and alternate

tapes
(cont)
SETSYS RECYCLEOUTPUT(BACKUP(unit)
MIGRATION(unit))
Defaults to SETSYS UNITNAME value for backup tapes

and SETSYS MIGUNITNAME for ML2 tapes
SETSYS RECYCLEPERCENT(pct)
Default is 20%
SETSYS ML2RECYCLEPERCENT(pct)
Default is 20%
If not specified ML2 tapes use SETSYS

RECYCLEPERCENT value
SETSYS MAXRECYCLETASKS(n)
Defaults to 2
(cont)
SETSYS
RECYCLEINPUTDEALLOCFREQUENCY
(BACKUP(m) MIGRATION(n))
Abbreviated RIDF
Supported in DFSMShsm 1.2.0 and higher
Controls how often DFSMShsm deallocates the input unit

during RECYCLE processing
Defaults is to keep the input unit allocated until the

processing of that type of volume (backup or ML2) is
complete
Specify 1 if using multiple robotic tape libraries connected

via passthru, or if using multiple ATLs under BTLS
Setting Up
Space
Management
Space Management Setup
DEFINE SSMCYCLE(cycle)
CYCLESTARTDATE(yyyy/mm/dd)
DEFINE PSMCYCLE(cycle)
Year-2000 support in base DFSMShsm r1.3.0, requires
OW17661 (r1.2.0)
Current date is first day in cycle if CYCLESTARTDATE

not specified
SETSYS PSMSTART(hhmm1 hhmm2)
SETSYS SSMSTART(hhmm1 hhmm2)

Secondary space management should be run prior to
primary space management to free space on ML1
(cont)
SETSYS MAXMIGRATIONTASKS(n)
Ensure you have at least 1 more SDSP than migration

tasks
Virtual storage no longer an issue in DFSMShsm r1.2.0

and higher
SETSYS MAXINTERVALTASKS(n)
Set to zero to prevent interval migration of SMS-managed
volumes with the AUTOMIGRATE = I attribute
(cont)
SETSYS MIGRATEPREFIX(prefix)
RACF-protect with UACC(NONE)
Avoid changes to MIGRATEPREFIX when using a tape

management system
Use same MIGRATEPREFIX in all DFSMShsm images in

shared environment
SETSYS MIGRATIONCLEANUPDAYS(n1 n2)

Default is to retain old MCD records for 10 days, statistics
records for 30 days
MCD records for data sets not meeting target compaction

percent are always kept for 90 days after RECALL
May want to lower first value, increase second if using

DCOLLECT for capacity planning
(cont)
SETSYS INTERVALMIGRATION |
NOINTERVALMIGRATION
Ignored for SMS-managed volumes with AM = I attribute
SETSYS MAXEXTENTS(n)
Default is 0, no extent reduction performed
Data sets become eligible for extent reduction prior to

meeting migration age. If requesting extent reduction,
should specify value of 10, or higher.
SETSYS SMALLDATASETPACKING |
NOSMALLDATASETPACKING
SDSPs result in more efficient use of ML1, reduce need
for defrags
Consider SDSP(KB(95))
(cont)
SETSYS DAYS(n)
Establishes minimum migration age for
non-SMS-managed volumes not having one assigned on
ADDVOL command
Too high a value can prevent the volume from reaching its
low threshold
SETSYS MIGRATIONLEVEL1DAYS(n)
Default is 60, affects non-SMS-managed data sets only
Specified number of days includes time spent on Level 0
(cont)
SETSYS TAPEMIGRATION(DIRECT |
ML2TAPE | NONE)
Default is to migrate to tape only when directed to by
ARCMDEXT or Management Class LEVEL 1 DAYS
NON-USAGE = 0
Typical specification is ML2TAPE(TAPE(unit))
(cont)
SETSYS MAXRECALLTASKS(n)
Default is 5, generally too low
Includes tasks used for deletion of migrated data sets
SETSYS TAPEMAXRECALLTASKS(n)
Must be less than or equal to MAXRECALLTASKS
Consider total DFSMShsm tape usage
SETSYS
RECALL(ANYSTORAGEVOLUME(LIKE |
UNLIKE) | PRIVATEVOLUME(LIKE | UNLIKE))
Controls selection of primary volume for non-SMS

RECALLs
LIKE refers to ADDVOL migration and backup attributes,

not device geometry
(cont)
SETSYS EXPIREDDATASETS(SCRATCH |
NOSCRATCH)
Affects data sets having expiration date in Format1 DSCB,
both SMS and non-SMS
Affects both migrated and non-migrated data sets
Ensure that users are properly specifying expiration dates

before considering SCRATCH
SETSYS SCRATCHFREQUENCY(n)
Controls deletion of non-SMS-managed list data sets
Default is 9999 - no scratching of list data sets
Data sets with final qualifiers of LIST, OUTLIST and

LINKLIST are assumed to be list data sets
Setting Up
Backup
Backup Processing Setup
DEFINE BACKUP(cycle)
OW17661 (r1.2.0)

not specified
SETSYS AUTOBACKUPSTART(hhmm1
hhmm2 hhmm3)
hhmm2 represents the latest time you want automatic
backup to start, when omitted automatic backup can start
any time between hhmm1 and hhmm3
(cont)
SETSYS BACKUPPREFIX(prefix)
RACF-protect with UACC(NONE)
Avoid changes to BACKUPPREFIX when using a tape

management system
Use same BACKUPPREFIX in all DFSMShsm images in

shared environment
SETSYS MAXBACKUPTASKS(n)
Consider total DFSMShsm tape usage if backing up to
tape
SETSYS SPILL(ANY | DASD | TAPE(unit)) |

NOSPILL)
Meaningful only if SETSYS BACKUP specifies DASD
(cont)
SETSYS
INCREMENTALBACKUP(CHANGEDONLY |
ORIGINAL)
Specify ORIGINAL if using other products that reset the
Format1 DSCB changed indicator
Use CHANGEDONLY in combination with SMS Storage

Group GUARANTEED BACKUP FREQUENCY parm
SETSYS VERSIONS(n)
Default is 2
Controls number of backup versions kept for non-SMS

data sets, can be overriden with ALTERDS command
Maximum number of versions changed from 13 to 100 in

DFSMShsm r1.3.0 -- requires redefinition of BCDS to
keep more than 29 versions
(cont)
SETSYS FREQUENCY(days)
Default is 0 days
Applies to non-SMS data sets only
Can be overriden with ALTERDS command
SETSYS SKIPABPRIMARY |
NOSKIPABPRIMARY
Controls whether backup of user data sets from Level0
volumes is performed
SETSYS BACKUP | NOBACKUP
NOBACKUP prevents automatic backup, automatic dump

and EXPIREBV processing
More SETSYS BACKUP
BACKUP(ANY | DASD | TAPE(unit))

Controls target backup device when not specified on
BACKVOL command or ADDVOL of non-SMS volume
INUSE(RETRY(Y | N) DELAY(min)
SERIALIZATION(PREFERRED | REQUIRED))
Supported in base DFSMShsm r1.3.0, requires OW11701
for DFSMShsm r1.2.0
RETRY indicates if DFSMShsm should make a second

attempt to backup an in-use data set
DELAY specifies how long to wait before attempting the

retry, defaults to 15 minutes
SERIALIZATION(PREFERRED | REQUIRED) indicates if

the data set must no longer be in use during the retry
Can be overriden with ARCBDEXT installation-wide exit
Multitasking Data Set
Recovery
SETSYS MAXDSRECOVERTASKS(n)
Added in DFSMShsm r1.3.0
Up to 64 tasks can be used when recovering from

incremental backup copies during volume RECOVER
processing
APPLYINCREMENTAL phase of RECOVER

FROMDUMP processing
Setting Up
Dump
Dump Processing Setup
DEFINE DUMPCYCLE(cycle)
and OW17661 (r1.2.0)

not specified
SETSYS AUTODUMPSTART(hhmm1 hhmm2

hhmm3)
hhmm2 represents the latest time you want automatic
dump to start, when omitted automatic dump can start
any time between hhmm1 and hhmm3
Dump Processing Setup
(cont)
SETSYS DUMPIO(n,m)
Default is DUMPIO(1,1) in DFHSM and DFSMShsm
r1.1.0, DUMPIO(3,3) in DFSMShsm r1.2.0, DUMPIO(4,4)
in DFSMShsm r1.3.0
Maps to DFSMSdss OPTIMIZE option

1 = 1 track
2 = 2 tracks
3 = 5 tracks
4 = 1 cylinder
If running DFSMShsm r1.2.0 or higher, specify

DUMPIO(3,4) to improve performance
SETSYS MAXDUMPTASKS(n)
Consider total DFSMShsm tape usage, default is 2
DEFINE DUMPCLASS
AUTOREUSE | NOAUTOREUSE
Specify NOAUTOREUSE if dumps to be sent offsite
Disposition of AUTOREUSE depends on SETSYS

TAPEDELETION option
DATASETRESTORE | NODATASETRESTORE
Specify NODATASETRESTORE if dumps to be sent
offsite
DATASETRESTORE requires dump VTOC copy,

typically specified only when Incremental Backup not
performed
DAY(day)
Interacts with FREQUENCY to control eligibility of

dumpclass during automatic dump processing
DEFINE DUMPCLASS (cont)
DISPOSITION('disposition')
Allows message ARC0637I to be sent to the console
FREQUENCY(days)
Default is 7 days
Interacts with DAY to control eligibility of dumpclass

during automatic dump processing
RESET | NORESET
RESET will cause DFSMShsm to skip incremental

backup of all datasets dumped under this dumpclass
RETENTIONPERIOD(days | NOLIMIT)
Default is 30 days
Controls DFSMShsm expiration of dump copy during

Automatic Dump processing
TAPEEXPIRATIONDATE(yyyyddd)
Default is 1999365 if specifying SETSYS
TAPESECURITY(EXPIRATION |
EXPIRATIONINCLUDE)
Specified date written to tape HDR1 label, can be used

by tape management system for vaulting, etc.
Expiration of dump copy should be controlled by

DFSMShsm, not tape management system

OW17661 (r1.2.0)
UNIT(unit)
First default is SETSYS UNIT specification, if none, then
defaults to d/t3400-6
VTOCCOPIES(n)
VTOC copy required to perform individual data set
restore from dump copy and RECOVER * FROMDUMP
APPLYINCREMENTAL processing, also needed for LIST
DUMPVOLUME DUMPCONTENTS command
Default is 2 copies
Written to Migration Level 1
STACK(n)
Specifies the number of dump copies DFSMShsm should
attempt to place on a single dump tape during Automatic
Dump processing
Added to DFSMShsm r1.3.0 and r1.4.0 in OW27973
Dump copies are written as separate files on the tape
Tape is expired when all dump copies have been

invalidated
Default is 1, recommended range is 10 - 12
ARC0654I issued if specified number of dump copies

were not contained on a single tape
Consider trade-off of full tapes versus reduced parallelism

implied by serial nature of dump stacking
Setting Up
ABARS
ABARS Processing Setup
SETSYS MAXABARSADDRESSSPACE(n)
Default is 1
SETSYS ABARSPROCNAME(name)
Default is DFHSMABR
SETSYS ARECOVERREPLACE |
NOARECOVERREPLACE
Disabled in DFSMShsm r1.1.0 and higher
Controls whether REPLACE parameter can be specified

on ARECOVER command
SETSYS ABARSBUFFERS(n)
Default is 1
ABARS Processing Setup
(cont)
SETSYS ARECOVERUNITNAME(unit)
Default is d/t3400-6
Used when ARECOVERing user tape data sets
SETSYS ABARSUNITNAME(unit)
Used for ABARS files created by ABACKUP
SETSYS ARECOVERML2UNIT(unit)
Used when ARECOVERing data sets to ML2
ABARS Log Options
SETSYS
ABARSACTLOGTYPE(SYSOUT(class) | DASD)
Available in DFSMShsm r1.1.0 and higher
Default is SYSOUT, using class from SETSYS SYSOUT

command
DASD allocations done using UNIT=SYSALLDA
DASD Activity Logs copied as part of ABACKUP output
SETSYS ABARSACTLOGMSGLVL(FULL |
REDUCED)
Available in DFSMShsm r1.1.0 and higher
REDUCED eliminates informational DFSMSdss messages

from ABARS Activity Log
Setting Up
Primary and
ML1 volumes
ADDVOL PRIMARY Command
AUTOBACKUP | NOAUTOBACKUP
AUTODUMP(class) | NOAUTODUMP
AUTOMIGRATION | NOAUTOMIGRATION
Default is not to perform the function
Must specify between 1 and 5 previously-defined

dumpclasses if AUTODUMP requested
BACKUPDEVICECATEGORY(TAPE | DASD |
NONE)
Be aware of effect on Primary volume selection during
RECALL if SETSYS RECALL specifies LIKE parameter
MIGRATE(days) | DELETEBYAGE(days) |
DELETEIFBACKEDUP(days)
Indicates which space management technique to use
Number of days defaults to SETSYS DAYS value
ADDVOL PRIMARY Command
(cont)
THRESHOLD(high% low%)
Volume eligible for interval migration if high threshold
reached and valid thresholds exist
Must be between 100 and 0 and high threshold must

exceed low threshold to be considered valid
Default is THRESHOLD(100 0)
Typical value is (90 70)
ADDVOL MIGRATION(ML1)
Command
AUTODUMP(class) | NOAUTODUMP
Highly recommended that ML1 volumes be dumped
regularly, particularly if they contain an SDSP
SMALLDATASETPACKING |
NOSMALLDATASETPACKING
Must also allocate KSDS for small-data-set-packing data
set and issue SETSYS SDSP
THRESHOLD(high%)
No low threshold is defined for ML1, all eligible data sets
migrated to ML2 if any ML1 reaches high threshold and
valid thresholds are defined
Default is THRESHOLD(100)
ADDVOL MIGRATION(ML1)
Command (cont)
OVERFLOW | NOOVERFLOW
Supported in base DFSMShsm r1.3.0, requires OW07781
(r1.2.0)
OVERFLOW specifies that the volume may be used for

backup copies generated by (H)BACKDS command
when the data set being backed up is at least 500 tracks
in size and has already failed allocation on a
NOOVERFLOW ML1 volume
DRAIN | NODRAIN
Prevents new migration and backup copies from being
allocated on the volume
Must be issued on all HSM images sharing the ML1

volume
Converting to
SMS
Converting to SMS
SETSYS equivalents in SMS Management

Class specifications
SETSYS DAYS = PRIMARY DAYS NON-USAGE
SETSYS ML1DAYS = LEVEL 1 DAYS NON-USAGE
SETSYS SCRATCHFREQUENCY = EXPIRE AFTER

DAYS NON-USAGE
SETSYS VERSIONS = NUMBER OF BACKUP VERS

(DATA SET EXISTS)
SETSYS FREQUENCY = BACKUP FREQUENCY
Converting to SMS (cont)
ADDVOL equivalents in SMS Storage Group

specifications
ADDVOL PRIMARY(AUTOMIGRATE) = AUTO
MIGRATE
ADDVOL PRIMARY(AUTOBACKUP) = AUTO BACKUP
ADDVOL PRIMARY(AUTODUMP(class)) = AUTO DUMP

with DUMP CLASS specified
Additional Readings
DFSMShsm Storage Administration Reference (SH211075)
DFHSM System Programmer's Command Reference (SH350083)
DFSMShsm Storage Administration Guide (SH211076)
DFHSM System Programmer's Guide (SH350085)
DFSMShsm Implementation and Customization Guide (SH211078)
DFHSM Installation and Customization Guide (SH350084)
DFSMSdfp Storage Administration Reference (SC264920)
MVS/DFP Storage Administration Reference (SC264566)
Visit our web site

http://www.storage.ibm.com/software/sms/hsm/hsmhome.htm

3032 - A Guided Tour of The DFSMSHSM Parmlib, Part 1 of 2

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

3032 - A Guided Tour of The DFSMSHSM Parmlib, Part 1 of 2

Uploaded by

Copyright:

Available Formats

Joint SHARE/GUIDE Technical Conference

3032/3033: Advanced HSM: A Guided

Project: MVS Storage Management (MVSS) Project

Setting up the General Environment

Setting Up Space Management

Setting Up Primary and ML1 Volumes

Identify the Parmlib to be used

HSMPARM DD card in HSM startup procedure

DFSMShsm r1.3.0 supports concatenated parmlib

Identify which ARCCMDxx to be used

CMD=xx parameter on MVS START command for

CMD=xx parameter on EXEC card in startup procedure

Verify using QUERY STARTUP command

Protect the Parmlib Member

Should reside in RACF-protected library

Limit write access to parmlib to prevent unintended

Record Changes in Prolog

ARCCMDxx should contain a prolog in which

Prolog should identify the date of change, and who

Flag changed commands

Use Comments Liberally

Comments enclosed within /* */ pair

Can appear anywhere in command line

Comment can span lines in ARCCMDxx

Particularly important for PATCHes and any other

Conditional processing based on Host identifier

Specify only the 1-character hostid, not the Y or N

Single command following ONLYIF executed based

Useful for sharing ARCCMDxx across systems

NEVER SOMETIMES ALWAYS

HOLD ADDVOL ALTERDS

SETSYS CDSVERSIONBACKUP options are preserved

All information for tape ML2, tape Backup

Volume attributes for Primary volumes

Space Management technique for Primary

Volume serial for Primary and ML1 volumes

Unit type for Primary and ML1 volumes

DASD ML2 keyranges

Primary and Secondary Space Management

RECALL pool information

ARECOVER pool information

Preserved across startups

Not preserved across startups

Defaults change with maintenance and new

Improved change control if all commands

One-stop setup verification

SETSYS JES2 or JES3 Any other command

SETSYS JES2 | JES3

SETSYS SWAP | NOSWAP

SETSYS CSALIMITS | NOCSALIMITS

AUTH userid DBA(USER | CONTROL)

First authorized user must be authorized in

USERDATASETSERIALIZATION uses SYSDSN

SETSYS EMERGENCY | NOEMERGENCY

SETSYS REQUEST | NOREQUEST

SETSYS CONVERSION | NOCONVERSION

Does not apply to system-reblockable data sets

Default prior to DFSMShsm r1.3.0 is 2K blocksize

SETSYS DEBUG | NODEBUG

Replacement for SETSYS EXITS

New exits added to DFSMShsm

ARCEDEXT - ABARS Expiration Date

ARCM2EXT - ABARS Migration Level 2