RLSE TSO Command

RLSE is a TSO command that releases unused DASD space allocated to datasets.

It is located in File #300 of the #249 version of the CBT tape and is part of a collection of TSO commands from Jim Marshall of the Air Force.  It was originally written by Bill Godfrey at the Planning Research Corporation in November of 1978.


The jobstream to assemble, the link-edit, and install the help text - rlse$.jcl - is contained in the archive rlse.tgz [MD5: 6577C469CD5555C798EE4F88F44BCCE5].  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 RLSE 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 RLSE

The help text for RLSE is really all that is required to understand and use the command:

Function -
  The RLSE command is used to free up unused space from an 
  existing dataset.
Syntax -
         RLSE  'dataset-name'  LEAVE('tracks')  EXTENTS
  REQUIRED - 'dataset-name'
  DEFAULTS - all unused tracks are released if neither 'LEAVE'
             nor 'EXTENTS' is specified.             

  ALIAS    - none
Operand -
  'dataset-name' - Specifies the name of the dataset which 
                   is to have its unused space released.
  LEAVE('tracks') - 'tracks' is the number of unused tracks 
                    not to be freed.
  EXTENTS - This keyword indicates that only unused secondary 
            extents are to be freed.  The primary extent and 
            any partially used secondary extents are not freed 
            even if they contain unused space.  This keyword and
            LEAVE are mutually exclusive. 
Example -
   rlse jay001.format.loadlib 

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 .