Volume Not in Library Support

In the past, for all calls to the CBRUXVNL exit, the supplied sample code linked to EDGLCSUX to retrieve the DFSMSrmm information for the volume. Now, calls to EDGLCSUX can be made only when it is determined that the request is for a tape volume. However, exit customization may be required in order to get complete benefit from this new support. The new input fields in CBRUXNPL are used during the job setup call to the exit to make an informed decision. The decision is added to CBRUXVNL and is partly selectable via conditional assembly to enable easy customization by you. An informed decision can be made when catalog information is available that confirms whether a volume is a tape or not. By default, the initial call to EDGLCSUX is made in these cases:

Job information is unavailable.
Catalog information is available, and the device type is a tape device. When catalog information is available, but the device type is not tape, the exit skips the link to EDGLCSUX.

DFSMSrmm provides the possibility to further enhance the EDGLCSUX calls by providing an option to compare the JCL esoteric unit name against a list of your known tape unit names. You can enable this additional option by customizing the default processing by:

Turning on the tape unit name checking code by changing the setting &TAPEDEC SETC to 'YES', and
Customizing the hardcoded list of tape unit names. The tape unit names are listed in the shipped table called TAPEUNITS. Ensure that you include in this table all the tape unit names your users code in their JCL. You can include esoteric, generic, and specific unit names. The default table is also shown.

Figure 1. Contents of the shipped table: TAPEUNITS

TAPEUNITS DC   A(TAPFIRST,8,TAPLAST)
****************************************************** 
*  Tape units list - may be customized                 
****************************************************** 
TAPFIRST DC    CL8'TAPE'                               
* insert your location tape unit names here            
* or edit any entry                                    
         DC    CL8'3400-6'                             
         DC    CL8'3420-8'                             
         DC    CL8'CART'                               
         DC    CL8'3480'                               
         DC    CL8'3480X'                              
         DC    CL8'3490'                               
         DC    CL8'3490E'                              
         DC    CL8'3590'                               
         DC    CL8'3590-1'                             
         DC    CL8'3590-E'                             
         DC    CL8'3590-B'                             
         DC    CL8'3590-H'                             
         DC    CL8'3590L'                              
         DC    CL8'3592'                               
         DC    CL8'3592-J'                             
         DC    CL8'SYS3480R'                           
         DC    CL8'SYS348XR'                           
         DC    CL8'VTS'                                
         DC    CL8'MTL'                                
         DC    CL8' '      any blank entry is ignored  
TAPLAST  DC    CL8'ATL'

When you have &TAPEDEC set to 'YES', CBRUXVNL checks the supplied unit name and calls EDGLCSUX only in the case where it matches some tape unit name within the TAPEUNITS table. Otherwise, the EDGLCSUX call is skipped.

In addition, the decision to issue message EDG8197I for non-RMM managed volumes is made selectable via an option flag in the EDGLCSUP parameter list. The CBRUXVNL exit shipped by DFSMSrmm sets this option flag ON when the device type supplied by catalog is a tape device or &TAPEDEC is set to 'YES'. Otherwise, this option flag is OFF. To change this decision, you can customize the CBRUXVNL source code. This ensures that you will see message EDG8197I when you believe the volume is a tape volume, and the tape volume is not managed by DFSMSrmm.