LISTVOL TSO Command

The LISTVOL TSO command displays the volume serial number for the DASD volumes on which selected datasets are allocated. Although the DD TSO command displays more useful information for datasets, I had this pulled from the CBT tape so I thought I would include it here.

The source for LISTVOL is located in File #48 of the older version #129 CBT tape. It also requires a separate external module - LOCINDEX - which is located in File #50. The help text is located in File #51, combined with the help for another command.

Installation

The older versions of the CBT tape, including #129 require a bit of pre-processing to get to the point of installing. So, I have completed several steps "behind the scene" which gave me the contents of the CBT tape image extracted into individual files on a 3350 volume. I then "punched" the contents of the three relevant files - 48, 50, and 51 - to get them over to PC manageable files. Then I built a single install jobstream to:

assembles the two modules
link- edits them into SYS2.CMDLIB
copies the help text into SYS2.HELP

There were no changes required to either source for MVS 3.8j, although I did need to supply an EQUATE macro to define the Register EQUates. If you do not have SYS2.CMDLIB and SYS2.HELP defined on your system, you can edit the jobstream, replacing these names with SYS1.CMDLIB and SYS1.HELP before submitting it.

The resulting jobstream - listvol$.jcl - is contained in the archive listvol.tgz [MD5: E3D1254D9838BFCA42E8E99DE830AE14]. Download the archive and extract the jobstream (WinZip on Windows/?? or tar on Linux). Submit the jobstream to assemble and link the single load module for LISTVOL into SYS2.CMDLIB and copy the help text into SYS2.HELP. If you don't have SYS2.CMDLIB defined, you will need to modify the jobstream to specify a different target load library. Also if you do not have SYS2.HELP defined, you may modify the jobstream to place the help information into SYS1.HELP.

Utilizing LISTVOL

Here is the help text for the LISTVOL command:

THE LISTVOL COMMAND LISTS THE VOLUMES OF CATALOGED DATASETS.
THE OUTPUT IS MORE COMPACT THAN LISTC VOL.

SYNTAX -                                                
    LISTVOL   LEVEL('DSNAME')         DA('DSLIST')          
              VOL('SER')                                    
    DEFAULTS - LEVEL(USERID)

OPERANDS -                                              
  LEVEL('DSNAME')                                           
             - SPECIFIES EITHER HIGHER LEVEL QUALIFIERS OF  
               CATALOG STRUCTURE OR CONTAINS EMBEDDED ASTERISK
               AS PART OF THE NAME.                           
  DATASET('DSLIST')                                           
             - SPECIFIES A DSNAME LIST FOR WHICH YOU DESIRE TO
               HAVE VOLUME INFORMATION LISTED.                
  VOLUME('VOLSER')                                            
             - SPECIFIES LEADING CHARACTERS OF VOLUME SERIAL.  ONLY
               DATASETS CATALOGED ON VOLUMES BEGINNING WITH THE
               SPECIFIED CHARACTERS WILL BE LISTED.

I hope that you have found my instructions useful. If you have questions that I can answer to help expand upon my explanations and examples shown here, please don't hesitate to send them to me:

Return to Site Home Page

This page was last updated on January 17, 2015 .