VOLS TSO Command

VOLS is a TSO command that displays information about DASD volumes that are currently online; the information displayed for each volume includes

It is located in File #360 of the CBT tape and is part of a collection contributed by the Wilson Street Regional Computing Center for the State of Wisconsin.


There are several versions of the program included on the CBT tape.  The earliest version dates from March 1983 and is the version that will run correctly under MVS 3.8j.  However, that version does not contain the code required to handle 3390 DASD.  The latest version includes several modifications which break the source for assembly under MVS 3.8j, but did include a change by Sam Golob which replaced 2314 DASD capability with 3390 DASD capability.  Since I believe both 2314 and 3390 DASD can be reasonably assumed to be in general use in the Hercules/MVS 3.8j community, I have made the modifications necessary to allow for DASD of types 2314, 3330, 3311 (3330-11), 3350, 3380, and 3390.  Sorry, no 2311, but it can be added easily within my changes if someone requires it.

No additional changes are required to assemble this program, although it does require a couple of macros from the same file (BEGIN and FINISH).  The single jobstream provided here includes the modified program source plus the two required macros and also includes the HELP text module (updated to reflect the added DASD type) that will be accessible from TSO.

The jobstream - vols$.jcl - is contained in the archive vols.rar [MD5: 231c30620cd4d2644cd2a382b56d42c2].  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 VOLS 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 01/2015 - added support for 3340 and 3375 DASD.


Utilizing VOLS

VOLS accepts several operands to limit the output produced by allowing the selection of DASD volumes by several criteria.  Issued with no operands, the default action is to list information for all DASD volumes currently online:

The operand TYPE (which may be abbreviated T and may also be specified with the synonyms DEVICETYPE, DEVT, or ATTRIBUTE) may be used to limit the volumes selected for display by either DASD type (2314, 3330, 3311, 3350, 3380, or 3390) or storage class (private, public, or storage, which may be abbreviated PR, PU, or S, respectively):

The operand UCBADDR (which may be abbreviated U) or its synonym ADDRESS (which may be abbreviated AD) may be used to limit the volumes selected for display to a specific address or group of addresses.  Up to three characters may be entered for the value with this operand.  The comparison for selection is done from the left side of the device address, so if only a single character is entered, the selection will have the effect of selecting all devices on a channel.

The operand VOLUME (which may be abbreviated V) or its synonym SERIAL (which may be abbreviated S) may be used to limit the volumes selected for display by the value of the volume serial.  Up to six characters may be entered for the value with this operand.  If less than six characters are entered, a group of volumes may be selected:

The operand CLEAR (which may be abbreviated C) will cause the terminal screen to be cleared before the output from the command is displayed.

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 19, 2015 .