Syntax of the ADDVOL command

Read syntax diagramSkip visual syntax diagram
>>-ADDVOL--volser--UNIT(unittype)------------------------------->

>--+-BACKUP--+----------------+---+----------------------------><
   |         '-| Fragment A |-'   |   
   +-DUMP--+----------------+-----+   
   |       '-| Fragment B |-'     |   
   +-MIGRATION-+----------------+-+   
   |           '-| Fragment C |-' |   
   '-PRIMARY-+----------------+---'   
             '-| Fragment E |-'       

A: BACKUP optional parameters

|--(-+------------------+-)--+--------------------+-------------|
     +-DAILY--+-------+-+    '-THRESHOLD(thresh1)-'   
     |        '-(day)-' |                             
     '-SPILL------------'                             

B: DUMP optional parameters

|--(-+------------------------+-)--+------------------+---------|
     '-+-DUMPCLASS-+--(class)-'    '-DENSITY(-+-2-+-)-'   
       '-DCLASS----'                          +-3-+       
                                              '-4-'       

C: MIGRATION optional parameters

                                       .-NODRAIN-. .-MIGRATIONLEVEL1-----.                    
|--(-+-------------------------------+-+---------+-+---------------------+-| Fragment D |-)-->
     |                  .-,-----.    | '-DRAIN---' +-+-MIGRATIONLEVEL1-+-+                    
     |                  V       |    |             | '-ML1-------------' |                    
     +-+-AUTODUMP-+--(----class-+--)-+             '-+-MIGRATIONLEVEL2-+-'                    
     | '-AD-------'                  |               '-ML2-------------'                      
     '-+-NOAUTODUMP-+----------------'                                                        
       '-NOAD-------'                                                                         

>--+--------------------+---------------------------------------|
   '-THRESHOLD(thresh1)-'   

D: MIGRATION optional parameters

   .-NOOVERFLOW-.                                  
|--+------------+--+---------------------------+----------------|
   '-OVERFLOW---'  +-+-SMALLDATASETPACKING-+---+   
                   | '-SDSP----------------'   |   
                   '-+-NOSMALLDATASETPACKING-+-'   
                     '-NOSDSP----------------'     

E: PRIMARY optional parameters

     .-NOAUTOBACKUP-----. .-NOAUTODUMP------------------. .-AUTOMIGRATION-------.                    
|--(-+------------------+-+-----------------------------+-+---------------------+-| Fragment F |-)-->
     +-+-AUTOBACKUP-+---+ |                 .-,-----.   | +-+-AUTOMIGRATION-+---+                    
     | '-AB---------'   | |                 V       |   | | '-AMIG----------'   |                    
     '-+-NOAUTOBACKUP-+-' +-+-AUTODUMP-+--(---class-+-)-+ '-+-NOAUTOMIGRATION-+-'                    
       '-NOAB---------'   | '-AD-------'                |   '-NOAMIG----------'                      
                          '-+-NOAUTODUMP-+--------------'                                            
                            '-NOAD-------'                                                           

>--+--------------------------------------------+--------------->
   '-+-TRACKMANAGEDTHRESHOLD-+-(---+-high-+---)-'   
     '-TMT-------------------'     '-low--'         

>--+--------------.-100-----.-----+-----------------------------|
   '-THRESHOLD(-+-+---------+-+-)-'   
                | '-thresh1-' |       
                | .-0-------. |       
                '-+---------+-'       
                  '-thresh2-'         

F: PRIMARY optional parameters

   .-AUTORECALL-------.                                            .-MIGRATE----------------------.   
|--+------------------+-+----------------------------------------+-+------------------------------+--|
   +-+-AUTORECALL-+---+ '-+-BACKUPDEVICECATEGORY-+--(-+-TAPE-+-)-' +-+-DELETEBYAGE-+--(days)------+   
   | '-AREC-------'   |   '-BUDEVCAT-------------'    +-DASD-+     | '-DBA---------'              |   
   '-+-NOAUTORECALL-+-'                               '-NONE-'     +-+-DELETEIFBACKEDUP-+--(days)-+   
     '-NOAREC-------'                                              | '-DBU--------------'         |   
                                                                   '-MIGRATE--+--------+----------'   
                                                                              '-(days)-'              

Note:
  1. The required parameters BACKUP, DUMP, MIGRATION, and PRIMARY are volume-type parameters; that is, they specify the type of volume to be managed by DFSMShsm.
  2. The ADDVOL command cannot be used with SMS-managed volumes.
  3. If multiple optional subparameters are used in one ADDVOL command, they are placed within one set of parentheses with a space between each subparameter, as shown below:
       ADDVOL PRIM01 UNIT(3390) +
       PRIMARY(AUTOBACKUP MIGRATE(8) AUTORECALL) THRESHOLD(90 70)