ABCs of z/OS System Programming Volume 3 - IBM Redbooks

4.9 IEHLIST utility
//VTOCLIST JOB ...
//STEP1 EXEC PGM=IEHLIST
//SYSPRINT DD SYSOUT=A
//DD2 DD UNIT=3390,VOLUME=SER=SBOXED,DISP=SHR
//SYSIN DD *
LISTVTOC VOL=3390=SBOXED,INDEXDSN=SYS1.VTOCIX.TOTTSB
/*
Figure 4-13 IEHLIST utility
Using IEHLIST
IEHLIST is a system utility used to list entries in the directory of one or more partitioned data
sets or PDSEs, or entries in an indexed or non-indexed volume table of contents. Any number
of listings can be requested in a single execution of the program.
Listing a PDS or PDSE directory
IEHLIST can list up to ten partitioned data set or PDSE directories at a time.
The directory of a partitioned data set is composed of variable-length records blocked into
256-byte blocks. Each directory block can contain one or more entries that reflect member or
alias names and other attributes of the partitioned members. IEHLIST can list these blocks in
edited and unedited format.
The directory of a PDSE, when listed, will have the same format as the directory of a
partitioned data set.
Listing a volume table of contents (VTOC)
IEHLIST can be used to list, partially or completely, entries in a specified volume table of
contents (VTOC), whether indexed or non-indexed. The program lists the contents of selected
data set control blocks (DSCBs) in edited or unedited form.
Chapter 4. Storage management software 121