Querying the residence of a volume

The Query Volume Residence (QVR) function allows you to determine the tape library in which a specified volume resides. If VOLINFO=YES is specified, the returned information is mapped by the CBRTVI macro. See Tape volume information (CBRTVI macro) for more information on this macro.

Figure 1 provides the CBRXLCS Assembler macro syntax that is used to perform the query volume residence function:

Figure 1. CBRXLCS QVR assembler macro syntax

CBRXLCS  TYPE=TAPE
         ,FUNC=QVR
         ,VOLUME=volume-serial-number
         [,LIBNAME={library-name}]
         [,TCDBCHK={YES | NO}]
         [,VOLINFO={YES | NO}]
         [,SUBPOOL={spno}]
         [,LOC={ANY | BELOW}]
         [,STORADDR={TVI-storage-address}]

When a value is requested, the keyword operand may be:

The name of the field that contains the requested value
The number, in parentheses, of a general register in the range of 2 through 12 that contains the address of the field