z/OS DFSMSrmm Managing and Using Removable Media
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


CHANGEVOLUME: Specific volume optional operands

z/OS DFSMSrmm Managing and Using Removable Media
SC23-6873-00

Read syntax diagramSkip visual syntax diagram
>>-+-CHANGEVOLUME-+--volser--+--------------------------+------->
   '-CV-----------'          |                      (1) |   
                             '-ACCESS(-+-NONE---+-)-----'   
                                       +-READ---+           
                                       '-UPDATE-'           

>--+------------------------------+----------------------------->
   '-ACCOUNT(account_information)-'   

>--+-------------------------------------+---------------------->
   |           .-+---+-------.           |   
   |           | '-,-'       |           |   
   |           V             |   (1) (2) |   
   '-ADDUSERS(-----user_ID---+-)---------'   

>--+------------------------------------+----------------------->
   |                            (3) (4) |   
   '-+-ASDATE-+-(assigned_date)---------'   
     '-DATE---'                             

>--+------------------------------------+--+----------------+--->
   |                            (3) (4) |  |          (4)   |   
   '-+-ASTIME-+-(assigned_time)---------'  +-AUTOMOVE-------+   
     '-TIME---'                            |            (4) |   
                                           '-MANUALMOVE-----'   

>--+---------------------+--+-----------------------+----------->
   |                 (4) |  |           (4)         |   
   '-BIN(bin_number)-----'  '-CAPACITY(-----nn-mb-)-'   

>--+-------+--+--------------------------------+---------------->
   +-CLOSE-+  |                        (1) (3) |   
   '-OPEN--'  '-COMPACTION(-+-*----+-)---------'   
                            +-NONE-+               
                            +-IDRC-+               
                            '-YES--'               

>--+-------------+---------------------------------------------->
   +-CONFIRMMOVE-+   
   |       (4)   |   
   '-CMOVE-------'   

>--+---------------------------------------------+-------------->
   |                       .-+---+-------.       |   
   |                       | '-,-'       |       |   
   |                       V             |   (1) |   
   '-+-CONFIRMRELEASE-+--(---+-REPLACE-+-+-)-----'   
     '-CRLSE----------'      +-RETURN--+             
                             +-ERASE---+             
                             +-INIT----+             
                             +-NOTIFY--+             
                             '-SCRATCH-'             

>--+-------------------------------+---------------------------->
   |                           (3) |   
   '-CONTAINER(container_name)-----'   

>--+-------------------------+---------------------------------->
   |                     (4) |   
   '-CRDATE(create_date)-----'   

>--+----------------------------+------------------------------->
   |                    (3) (4) |   
   '-CRSYSID(system_ID)---------'   

>--+-------------------------+---------------------------------->
   |                     (4) |   
   '-CRTIME(create_time)-----'   

>--+------------------------------+----------------------------->
   '-CURRENTLABELVERSION(-+-1-+-)-'   
                          +-3-+       
                          '-4-'       

>--+-------------------------------------+---------------------->
   |           .-+---+-------.           |   
   |           | '-,-'       |           |   
   |           V             |   (1) (2) |   
   '-DELUSERS(---+-user_ID-+-+-)---------'   
                 '-*-------'                 

>--+-------------------------+--+-------------------+----------->
   |                     (3) |  '-DESCRIPTION(text)-'   
   '-DENSITY(-+-*----+-)-----'                          
              +-1600-+                                  
              +-3480-+                                  
              '-6250-'                                  

>--+-------------------------------+---------------------------->
   |                       (1) (3) |   
   '-DSNAME(data_set_name)---------'   

>--+-----------------------------------+------------------------>
   |                               (3) |   
   '-ERROR(-| ERROR parameters |-)-----'   

>--+----------------------------------+------------------------->
   |        .-CONVENIENCE-.   (4) (5) |   
   '-EJECT(-+-------------+-)---------'   
            '-BULK--------'               

>--+----------------------------+------------------------------->
   |                        (1) |   
   +-EXPDT(expiration_date)-----+   
   |                        (1) |   
   '-RETPD(parmlib_default)-----'   

>--+--------------------------+--+-----------+--+--------+------>
   |                      (1) |  |       (6) |  +-HOLD---+   
   '-FEATCD(feature_code)-----'  '-FORCE-----'  '-NOHOLD-'   

>--+--------------------------------------+--------------------->
   |                                  (4) |   
   '-HOME(-+-library_name---------+-)-----'   
           +-LOCDEF_location_name-+           
           '-SHELF----------------'           

>--+---------------------+--+---------------------------+------->
   '-INITIALIZE(-+-Y-+-)-'  |                   (1) (3) |   
                 '-N-'      '-JOBNAME(job_name)---------'   

>--+----------------------------------------------------------------+-->
   '-+-+-------------------------+--+---------------------------+-+-'   
     | |                .-L-.    |  '-KEYLABEL1(keylabel1_name)-' |     
     | '-KEYENCODE1--(--+-H-+--)-'                                |     
     '-NOKEYLABEL1------------------------------------------------'     

>--+----------------------------------------------------------------+-->
   '-+-+-------------------------+--+---------------------------+-+-'   
     | |                .-L-.    |  '-KEYLABEL2(keylabel2_name)-' |     
     | '-KEYENCODE2--(--+-H-+--)-'                                |     
     '-NOKEYLABEL2------------------------------------------------'     

>--+---------------------+--+--------------------+-------------->
   |                 (3) |  |                (1) |   
   '-LABEL(-+-SL-+-)-----'  '-LEVEL(version)-----'   
            +-NL-+                                   
            '-AL-'                                   

>--+------------------------------------+----------------------->
   |                        (1) (3) (4) |   
   '-LOANLOC(loan_location)-------------'   

>--+----------------------------------------------+------------->
   |                                          (4) |   
   '-LOCATION(-+-SHELF--------------------+-)-----'   
               +-HOME---------------------+           
               +-library_name-------------+           
               |                      (1) |           
               +-LOCDEF_location_name-----+           
               |       (1)                |           
               +-LOCAL--------------------+           
               |         (1)              |           
               +-DISTANT------------------+           
               |        (1)               |           
               '-REMOTE-------------------'           

>--+-------------------+---------------------------------------->
   |           (3) (4) |   
   '-MEDIANAME---------'   

>--+---------------------------------------+-------------------->
   |                                   (3) |   
   '-MEDIATYPE(-+-*----------------+-)-----'   
                +-CST--------------+           
                +-ECCST------------+           
                +-EHPCT------------+           
                +-HPCT-------------+           
                +-+-MEDIA5-+-------+           
                | '-ETC----'       |           
                +-+-MEDIA6-+-------+           
                | '-EWTC---'       |           
                +-+-MEDIA7-+-------+           
                | '-EETC---'       |           
                +-+-MEDIA8-+-------+           
                | '-EEWTC--'       |           
                +-+-MEDIA9-+-------+           
                | '-EXTC---'       |           
                +-+-MEDIA10-+------+           
                | '-EXWTC---'      |           
                +-+-MEDIA11-+------+           
                | '-EATC----'      |           
                +-+-MEDIA12-+------+           
                | '-EAWTC---'      |           
                +-+-MEDIA13-+------+           
                | '-EAETC---'      |           
                '-medinf_mediatype-'           

>--+---------------------+--+-----------------------+----------->
   '-MEDINF(medinf_name)-'  |                   (3) |   
                            '-NEWVOLUME(volser)-----'   

>--+---------+--+------------+---------------------------------->
   '-NOABEND-'  |        (4) |   
                +-NOWORM-----+   
                |      (4)   |   
                '-WORM-------'   

>--+----------------------------+------------------------------->
   |                        (1) |   
   '-NUMBER(product_number)-----'   

>--+-------------------------------------------+---------------->
   |                    (4)                    |   
   +-+-NOSTORAGEGROUP-+------------------------+   
   | '-NOSTORGRP------'                        |   
   |                                       (4) |   
   '-+-STORAGEGROUP-+-(storage_group_name)-----'   
     '-STORGRP------'                              

>--+----------------------------+------------------------------->
   |            (3)             |   
   '-OPENCOUNT(-----+-count-+-)-'   
                    '-+nn---'       

>--+------------------------------------+----------------------->
   |                                (3) |   
   '-ORIGINALEXPDT(expiration_date)-----'   

>--+---------------------+--+-------------------------------+--->
   |                 (1) |  |                           (1) |   
   '-OWNER(owner_ID)-----'  '-OWNERACCESS(-+-ALTER--+-)-----'   
                                           +-READ---+           
                                           '-UPDATE-'           

>--+------------------------+--+---------------------------+---->
   |          (3)           |  |                   (4) (7) |   
   '-PERCENT(-----percent-)-'  +-POOL(pool_prefix)---------+   
                               |                   (4)     |   
                               +-RACK(rack_number)---------+   
                               |        (4)                |   
                               '-NORACK--------------------'   

>--+------------------------------+----------------------------->
   |           (1)                |   
   +-NOPREVVOL--------------------+   
   |                          (1) |   
   '-PREVVOL(previous_volser)-----'   

>--+--------------------------------------+--------------------->
   |                          (1) (3) (4) |   
   '-READDATE(last_read_date)-------------'   

>--+---------------------------------------------------+-------->
   |                                               (3) |   
   '-RECORDINGFORMAT(-+-*----------------------+-)-----'   
                      +-18TRACK----------------+           
                      +-36TRACK----------------+           
                      +-128TRACK---------------+           
                      +-256TRACK---------------+           
                      +-384TRACK---------------+           
                      +-EFMT1------------------+           
                      +-EFMT2------------------+           
                      +-EEFMT2-----------------+           
                      +-EFMT3------------------+           
                      +-EEFMT3-----------------+           
                      +-EFMT4------------------+           
                      +-EEFMT4-----------------+           
                      '-medinf_recordingformat-'           

>--+---------------------------------------+-------------------->
   |                .-+---+--------.       |   
   |                | '-,-'        |       |   
   |                V              |   (1) |   
   '-RELEASEACTION(---+----------+-+-)-----'   
                      +-SCRATCH--+             
                      +-REPLACE--+             
                      +-RETURN---+             
                      +-INIT-----+             
                      +-NOINIT---+             
                      +-ERASE----+             
                      +-NOERASE--+             
                      +-NOTIFY---+             
                      '-NONOTIFY-'             

>--+--------------------+--+-------------------------------+---->
   '-REPLACE(-+-YES-+-)-'  '-REQUIREDLABELVERSION(-+-0-+-)-'   
              '-NO--'                              +-3-+       
                                                   '-4-'       

>--+-------------------------------+---------------------------->
   |                           (4) |   
   '-RETAINBY(-+-FIRSTFILE-+-)-----'   
               +-SET-------+           
               '-VOLUME----'           

>--+----------------------------------+------------------------->
   |                              (4) |   
   '-RETENTIONMETHOD(-+-EXPDT-+-)-----'   
                      '-VRSEL-'           

>--+------------------------------------+----------------------->
   |                                (1) |   
   +-SECLEVEL--(--security_class--)-----+   
   '-NOSECLEVEL-------------------------'   

>--+-----------------------------------+------------------------>
   '-SPECIALATTRIBUTES(-+-NONE-----+-)-'   
                        '-RDCOMPAT-'       

>--+----------------------+--+--------------------------+------->
   '-STATUS(-+-MASTER-+-)-'  |                      (4) |   
             '-USER---'      '-TYPE(-+-LOGICAL--+-)-----'   
                                     +-PHYSICAL-+           
                                     '-STACKED--'           

>--+-----------------------+--+---------------------+----------->
   '-TZ({+|-}HH[:MM[:SS]])-'  |      .-+---+----.   |   
                              |      | '-,-'    |   |   
                              |      V          |   |   
                              '-USE(---+-IRMM-+-+-)-'   
                                       +-MVS--+         
                                       '-VM---'         

>--+---------------------+--+------------------+---------------->
   '-VENDOR(vendor_name)-'  |              (8) |   
                            '-VOL1(volser)-----'   

>--+------------------------------------+----------------------->
   |                            (3) (4) |   
   '-WRITEDATE(last_write_date)---------'   

>--+----------------------+------------------------------------->
   |      (3)             |   
   '-WMC(-----+-count-+-)-'   
              '-+nn---'       

>--+----------------------------------------------+------------><
   '-+-WORLDWIDEID-+--(--world_wide_identifier--)-'   
     '-WWID--------'                                  

ERROR parameters

|--+-----------------------+--+------------------------+--------|
   |       (3)             |  |        (3)             |   
   '-READ(-----+-count-+-)-'  '-WRITE(-----+-count-+-)-'   
               '-+nn---'                   '-+nn---'       

Notes:
  1. This operand cannot be specified for a SCRATCH volume, unless you specify the STATUS operand.
  2. You can specify a maximum of 12 user IDs.
  3. You can specify this operand only if you also specify the FORCE operand. To use the FORCE operand, you must have CONTROL access to the STGADMIN.EDG.MASTER security resource and UPDATE access to the STGADMIN.EDG.FORCE security resource.
  4. This operand can be specified if the user has CONTROL access to STGADMIN.EDG.MASTER resource.
  5. This operand can be specified only if the volume resides in a system-managed library.
  6. This operand can be specified to change a data value on a volume where information was recorded by DFSMSrmm during O/C/EOV processing. You must have CONTROL access to the STGADMIN.EDG.MASTER security resource and UPDATE access to the STGADMIN.EDG.FORCE security resource to use the FORCE operand.
  7. This operand cannot be specified if the volume resides in an IBM Tape Library Dataserver.
  8. This operand cannot be specified for SCRATCH volumes, LOGICAL volumes, STACKED volumes, or NOLABEL volumes.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014