System Setup › Oracle Host Software Component (HSC) and Storage Management Component (SMC) › Method Two: HSC/SMC Exits › SLSUX08

SLSUX08

SLSUX08 influences specific VOLSER mount requests. The CA Vtape sample SLSUX08 exit can be found in HLQ.CCUUSAMP(SLSUX08).

The sample SLSUX08 exit checks the VOLSER prefix to determine if the mount is for a CA Vtape Virtual Volume. When the VOLSER belongs to CA Vtape, the exit sets a return code of 12 to tell HSC the allocation should be handled by a non-silo drive. When a prefix match does not occur, the exit sets a return code of 0 to tell HSC to honor the UNIT information in the JCL.

The sample SLSUX08 exit is the default HSC exit with the following modifications:

         USING SLSUX08P,R10         MAP PARM LIST                       
*        LA    R15,64               INACTIVE EXIT                       
* ADDED CODE FOR VTAPE PROCESSING                                     
         L     R11,UX08VOLP         LOAD POINTER ADDRESS              
         USING SLSUX08V,R11         MAP PARM LIST                     
         LA    R15,12               USE NON-LIBRARY DRIVES            
         CLC   UX08VLSR(1),=CL1'x'  YOUR VIRTUAL TAPE PREFIX NUMBER   
         BE    RETURN                                                 
         LA    R15,0                USE LIBRARY DRIVES                  
         SPACE                                                        
RETURN   DS    0H

The exit is called after the HSC software has already processed the allocation request and made a decision on what action should be taken. Passing a return code of zero back in the exit tells the HSC software that the decision it has already made is not going to be changed by the exit. If the decision was to intercept the mount, it will be intercepted. If the decision was to not intercept the mount, it will not be intercepted.

If you eject tapes from your silo and do not have any manual or floor drives to mount the ejected tapes on, then you need the mount to occur in the silo and the tape inserted into the silo. A return code of 16 passed back in SLSUX08 informs the HSC software that it should prefer the silo and intercept the mount. This will cause the insert WTOR to be issued.

Consult the HSC User Exit Guide for other available SLSUX08 return codes that may be required in your environment.

Once the sample source has been updated for your environment, it must be assembled and linked with the HSC provided JCL and macro libraries and the resulting load module placed in the CA Vtape or HSC loadlib. If the CA Vtape loadlib is used, it must be concatenated in front of the HSC loadlib in the HSC started task. Consult the HSC manuals on how to activate the exit.