SUPERLST reads and edits the Volume Table of Contents (VTOC) information from one or more direct access volumes and prints information about the datasets on the selected volume(s) and a track usage map.  Optionally it lists the directory of each partitioned dataset on the selected volume(s). 

The source is located in File #134 of the CBT tape, which was submitted by Greg Price.  The original author of the program, according to comments in the source for the main module, was R. F. Morse
at the MIT Instrumentation Laboratory.



The archive superlst.tgz [111,764 bytes, MD5: c3883bcde0116181227c317ce2ca6178] contains a HET image (a14054.het), a jobstream (install.jcl), and a procedure (suprlist.jcl).  The tape contains two datasets: (1) is an IEBUPDTE stream that can be used to reload the PDS containing the source and macros obtained from the CBT tape and (2) the object modules for the component modules that, when linked together, provide the single load module to execute the program.  I have made a single change to the source code for two of the component modules (XVTCLIST, XVTCREAD) to add support for 2314 DASD types, which is frequently utilized under Hercules/MVS3.8j for support of the MVT Sort/Merge program.  In order to assemble the program from the source, several macros are required that are not publicly available, so I am distributing this by the assembled object code.

Extract the tape image and two jcl files from superlst.tgz (using WinZip on Windows/?? or tar on Linux).  The install jobstream, as supplied, will link-edit the load module into SYS2.LINKLIB.  If you don't have SYS2.LINKLIB defined, you will need to modify the jobstream to specify a target load library.  The suprlist.jcl procedure should be placed in SYS2.PROCLIB; if you do not have a SYS2.PROCLIB defined, you may place it in SYS1.PROCLIB.


Executing SUPERLST

The output produced by SUPERLST is modified by the inclusion of a PARM value on the EXEC statement.  

With no parameter supplied, a formatted Volume Table of Contents is produced; for each dataset located on the selected volume(s), the columns of the report include:  Dataset Name, Read (P)/Write (W) Protect indicator, Volume Serial, indicator (*) if volume sequence greater than 1, Reference Date, indicator (M) if dataset has been modified since last backup, Date Created, Expiration Date, Dataset Organization, Record Format, Block Length, Record Length, Key Length, Option Code, Tracks Allocated, Tracks Used, Percent of Allocated Tracks Used, Number of Extents, Secondary Allocation Quantity, and Allocation Type.  A sample of output with no PARM value is included at SUPERLST (no parm).

With parameter value of MAP supplied, the formatted VTOC listing is produced, along with the addition of a map of the allocated and available space on the selected volume(s) similar to that produced by the IEHMAP utility.  A sample of output with PARM=MAP is included at SUPERLST (MAP).

With a parameter value of PDS supplied, the formatted VTOC listing is produced, and additionally, for each Partitioned Dataset a line is produced following the line containing the VTOC information for the dataset which shows the number of members, number of aliases, total directory blocks allocated, and directory blocks used.  A sample of output with PARM=PDS is included at SUPERLST (PDS).

Finally, with a parameter of DUMP supplied, the formatted VTOC listing is produced, and additionally, each DSCB is shown in HEX format following their formatted listings.  A sample of output with PARM=DUMP is included at SUPERLST (DUMP).

The procedure to execute SUPERLST is:


and allows the program to be easily executed from the system console with a START command:

s suprlist,v={volser},p={parmvalue}

supplying the volume serial number of the volume for which the listing is to be produced with the variable v and the parameter value with the variable p.  The output class may also be modified by use of the c variable.  Issuing the start command with no parameter substitutions will result in a formatted VTOC report for volume MVSRES.

To produce a formatted VTOC listing of the volume PUB002 (which on my system is a 2314 volume), I use the command:

s suprlist,v=PUB002

which results in the listing included at SUPERLST (PUB002).

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 .