CVAFDSM Macro Overview and Specification

The CVAFDSM macro is used to obtain volume information for an indexed or nonindexed VTOC.

The CVAFDSM macro can be used for an indexed VTOC to obtain:

One or more extents that describe unallocated space on the volume
A count of free DSCBs on the VTOC
A count of free VTOC index records in the VTOC index.
A value that represents the highest allocated DSCB as determined by the VTOC INDEX.

The CVAFDSM macro can be used for an nonindexed VTOC to obtain:

One or more extents that describe unallocated space on the volume

The format of the CVAFDSM macro is:


>>-+-------+--CVAFDSM--ACCESS=MAPDATA--,MAP=-+-INDEX--+--------->
   '-label-'                                 +-VOLUME-+   
                                             '-VTOC---'   

>--+---------------+--+--------------------+-------------------->
   '-,EXTENTS=addr-'  |            .-NO--. |   
                      '-,RTA4BYTE=-+-YES-+-'   

>--+--------------------------+--+-----------------+------------>
   |                 (1)      |  +-,UCB=-(ucbaddr)-+   
   '-,MAPRCDS=-+-YES--------+-'  '-,DEB=addr-------'   
               +-(YES,addr)-+                          
               |    (2)     |                          
               +-NO---------+                          
               '-(NO,addr)--'                          

>--+-----------------+--+--------------+--+--------------+------>
   |         .-NO--. |  '-,CTAREA=addr-'  '-,HADSCB=addr-'   
   '-,COUNT=-+-YES-+-'                                       

>--+----------------------------+--+------------------------+--->
   |          .-NOKEEP--------. |  |          .-NO--------. |   
   '-,IOAREA=-+-KEEP----------+-'  |          |     (3)   | |   
              +-(KEEP,addr)---+    '-,BRANCH,-+-YES-------+-'   
              '-(NOKEEP,addr)-'               +-(YES,SUP)-+     
                                              '-(YES,PGM)-'     

>--+--------------------+--+-------------------+---------------><
   |          .-NOTOK-. |  |      .-I--------. |   
   '-,EADSCB=-+-OK----+-'  '-,MF=-+-L--------+-'   
                                  '-(E,addr)-'

Notes:

Default if MF=I.
Default if MF=L or MF=(E, addr).
If YES is coded, the default is SUP.