LISTSPC TSO Command

The LISTSPC TSO command displays allocation information for specified datasets or free space for selected DASD volumes. 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 LISTSPC is located in File #49 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 - 49, 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 - listspc$.jcl - is contained in the archive listspc.tgz [MD5: 32535ffe9f875b07f99451ae5a344cba]. 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 LISTSPC 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.

Update November 13, 2021: As with several of the CBT installation jobstreams which involved multiple CSECTs, this job worked correctly when this page was originally created (last updated in 2016), but on recent builds of MVS 3.8j received a S0C4 during the Link Edit step when the separately assembled CSECTs were being combined into a single load module. I have replaced the installation jobstream in the archive above with the jobstream from SYSCPK which assembles and links with no errors and will execute without the necessity of SYSCPK.

Utilizing LISTSPC

Here is the help text for the LISTSPC command:

THE LISTSPC COMMAND LISTS THE TRACKS ALLOCATED, TRACKS UNUSED, AND
NUMBER OF EXTENTS FOR CATALOGED DISK DATA SETS, INDIVIDUALLY OR IN
SMALL GROUPS. IT IS MORE EFFICIENT FOR THIS KIND OF DISPLAY THAN
THE SPACE COMMAND SINCE IT SEARCHES FOR CATALOGED DATA SETS
ONLY, WHEREAS SPACE SEARCHES FOR ANY DISK-RESIDENT DATA SETS -
CATALOGED OR NOT.

SYNTAX -
    LISTSPC   DATASET('DSNAME-LIST')  LEVEL('INDEX-LEVEL')
              VOLUME('VOLUME-LIST')  EXTENTS
    REQUIRED - DATESET('DSNAME') OR LEVEL('INDEX-LEVEL') OR
               VOLUME('VOLUME')
    DEFAULTS - NONE
    ALIAS    - NONE

OPERANDS -

  DATASET('DSNAME-LIST') -
               - SPECIFIES A LIST OF DATA SET NAMES ABOUT WHICH YOU WISH
                 TO HAVE SPACE INFORMATION DISPLAYED.
  LEVEL('INDEX-LEVEL') -
               - SPECIFIES AN INDEX LEVEL IN THE CATALOG FOR
                 WHICH YOU WANT SPACE INFORMATION. THIS MAY BE
                 A DSNAME CONTAINING ONE EMBEDDED ASTERISK.
  VOLUME('VOLUME-LIST') -
               - IF USED WITH THE DATASET PARAMETER, SPECIFIES THE
                 VOLUME THE DATA SET RESIDES ON. NO CATALOG SEARCH
                 WILL BE PERFORMED.
                 IF SPECIFIED ALONE, SPECIFIES A LIST OF VOLUMES FOR
                 WHICH FREE SPACE INFORMATION WILL BE PRODUCED.
  EXTENTS      - IF SPECIFIED, THEN THE EXTENTS FOR EACH DATA SET WILL
                 BE DISPLAYED WITH HEXADECIMAL ADDRESSES.

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 November 13, 2021 .