z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Tape Libraries
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Successful query volume residence processing

z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Tape Libraries
SC23-6867-00

When the query volume residence function is successful and the volume resides in a library, the following fields in the LCSPL (LCS external services parameter list (CBRLCSPL macro)) are updated:
  • The name of library in which the volume resides is returned in field LCSLIBNM. This may be the library name found in the volume record or the library name specified in the QVR invocation. TVILIBNM contains the library name stored in the TCDB for comparison.
  • If the library is an ATLDS, the flag LCSATL is turned on.
  • If the library is an MTL, the flag LCSMTL is turned on.
  • If a console name has been specified for the library, it is returned in LCSCONSN. Otherwise, LCSCONSN is set to blanks.
  • If VOLINFO=YES was specified, LCSTVI@ contains the address of the requested volume information. The information is mapped by macro CBRTVI. See Tape volume information (CBRTVI macro) for more information on this macro. Information pertaining to TVIERROR (the constant values) is mapped by macro CBRVERR.
    Note: The caller must free the storage obtained for the tape volume information. To ensure that the correct amount of storage is freed, use the TVILENG field in the TVI header section to free this storage.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014