LISTH

This control statement enables you to print a list of all or part of the index information concerning its history data sets. It is also used to produce a list of available volumes in the tape pool (if any). This information is maintained in the SCDS file.
smfd127
This control statement enables you to print a list of all or part of the index information concerning its history data sets. LISTH is also used to produce a list of available volumes in the tape pool (if any). This information is maintained in the SCDS file.
Statement Format:
LISTH
►►─ LISTH ─┬─ SID(sid1,...sidn,) ─────────────────────────┬───────────────────► ├─ XSID(sid1 ... sidn) ────────────────────────┤ ├─ EXCLUDESID(sid1 ...) ───────────────────────┤ ├─ ALL ────────────────────────────────────────┤ │ ┌─ , ──────────┐ │ └─ VOLUMES( ─▼─┬─ volser ─┬─┴─ ) ─┬──────────┬─┘ ├─ FREE ───┤ └─ DETAIL ─┘ └─ ALL ────┘ ►─┬────────────────────────┬─┬─────────────┬─┬─────────────────┬─────────────► ├─ FROM(date)TO(date) ───┤ ├─ PRIMARY ───┤ ├─ SELECT(list) ──┤ └─ JFROM(date)JTO(date) ─┘ └─ ALTERNATE ─┘ └─ EXCLUDE(list) ─┘ ►─┬───────────────────────────────────────┬──────────────────────────────────► ├─ LSNAME( ─┬─ lsname lsname ... ─┬─ ) ─┤ │ └─ NONE ──────────────┘ │ └─ SUBNAME( ─┬ subname subname ... ─┬ ) ┘ └ NONE ────────────────┘ ►─┬────────────────────────────┬─ . ─────────────────────────────────────────►◄ └─ MANFILE( ─┬─ YES ◄ ─┬─ ) ─┘ └─ NO ────┘
Operands and Descriptions:
SID(sid,sid,...)
Specifies one or more SMF IDs, up to a maximum of 20, for the history-file index. This operand is coded (sid1,sid2...).
This operand is the 4-character identifier that appears in the SMF data.
ALL
Specifies that index entries for all configurations are listed.
EXCLUDESID(sid1, sid2, …)
XSID(sid1, sid2, …)
The EXCLUDESID and XSID operands provide a way to indicate which systems the control statement does not apply to. One or more systems can be specified. Any configurations in the SCDS that have any of the named SIDs are not processed with the command. All other configured systems will be processed.
The EXCLUDESID and XSID operands are mutually exclusive synonyms of each other. These operands are also mutually exclusive with the SID operand and the ALL operand.
FROM(date) TO(date)
Specifies the beginning and ending of the period for which SMF index entries are displayed.
'date' is in Gregorian (mmddyy) format.
JFROM (jdate) JTO (jdate)
Specifies the beginning and ending dates for the period for which
'jdate' is in Julian date format (cyyddd).
PRIMARY
Specifies that index entries in the primary pool are the only ones to be listed.
ALTERNATE
Specifies that index entries in the alternate pool are the only ones to be listed.
VOLUMES (volser, volser, ...)
Produces a list of tape volume serials that are defined to this product. Only the volumes that are specified are listed.
VOLUMES (ALL)
Produces a list of all tape volume serials that are defined to this product.
VOLUMES (FREE)
Produces a list of all available volume serials in the free pool.
DETAIL
Specifies that the index entries that match the specified volume serials on the VOLUMES keyword are used.
SELECT(list)|EXCLUDE(list)
Lets you filter the history files index entries on an additional record type criteria. If SELECT is coded, all history files that contain at least one of the specified record types are listed in the LISTH output. If EXCLUDE is coded, all history files that contain only the specified record types and nothing else are excluded from the output.
The list may include any valid SMF record types from 0 through 2047. They may be coded as individual record types separated by commas or as a range of record types that are separated by colons. Up to 2047 values may be coded. Selection on subtypes is not allowed.
For example, SELECT(0,255,30:71) lists the history files that contain record types 0, 255, and 30 through 71. EXCLUDE(255) suppresses all history files that contain only type 255 records.
Entries that were manually added by ADDX do not contain information about their record types. Therefore, they are always listed in the LISTH output. Record type information may be updated by an EXTRACT run, which gathers information about record types, provided PARM=READ is not coded on the EXTRACT JCL.
LSNAME(NONE|lsname lsname ...)
Lets you filter the history file index entries on a specified logstream. Only the entries that contain the data from the selected logstreams are listed. Up to 21 logstreams may be coded.
If NONE is coded, no logstream-related history file entry is included in the output.
If LSNAME is not coded, all history files that are dumped from all logstreams is included.
SUBNAME(NONE|subname subname ...)
Lets you filter the history file index entries on a specified substream. Only the entries that contain the data from the selected substreams are listed. Up to 21 substreams may be coded.
If NONE is coded, no substream-related history file entry is included in the output.
If SUBNAME is not coded, all history files that are dumped from all substreams are included.
MANFILE(YES|NO)
Specifies whether the MAN file archives should be included in the LISTH output. The default value of YES lists all history files containing the data that was dumped from MAN files. NO limits the output to only logstream-related history files.
Sample LISTH Statements:
LISTH ALL . LISTH VOLUMES(FREE) .
LISTH statement output:
CA AUDIT TRAIL REPORT SMFD PAGE 1 CA SMF Director 12.7 SYSA 27 JUL yyyy 11:09:54 LISTH ALL . CA AUDIT TRAIL REPORT SMFD PAGE 3 CA SMF Director 12.7 SYSA 27 JUL yyyy 11:09:54 INDEXED SMF DATA FOR CONFIGURATION XE44 ------ FROM ------- ------- TO -------- ------ DUMPED ----- VOLID/ UNIT FILE -------------- DATA SET NAME ---------- SID X 04/29/2008 10:30:19 04/29/2008 10:44:44 07/08/2008 18:33:41 201825 3490 0001 SYSPROG.SF16.MM070898.T1833P79 XE44 P 04/29/2008 10:30:19 04/29/2008 10:44:44 07/10/2008 10:36:27 202338 3490 0001 SYSPROG.SF16.MM071098.T1036P26 XE44 P 05/20/2008 15:42:00 05/20/2008 21:59:00 05/21/2008 0:05:00 PMA003 3490 DISK SYSPROG.SF16.MS052008.T1542I1 XE44 P 05/21/2008 1:00:10 05/21/2008 21:59:00 05/22/2008 0:05:00 115193 3490 0001 SYSTEM.USER.SMFDATA.D052198 XE44 P CA AUDIT TRAIL REPORT SMFD PAGE 4 CA SMF Director 12.7 SYSA 27 JUL yyyy 11:09:54 INDEXED SMF DATA FOR CONFIGURATION XE44 ------ FROM ------- ------- TO -------- ------ DUMPED ----- VOLID/ UNIT FILE -------------- DATA SET NAME ---------- SID X 04/17/2008 12:00:00 04/29/2008 10:44:44 06/29/2008 12:32:56 PMA003 3390 DISK SYSPROG.SF16.MM062998.T1232A74 XE44 A 04/29/2008 10:30:19 04/29/2008 10:44:44 07/08/2008 18:33:41 PMA003 3390 DISK SYSPROG.SF16.MM070898.T1833A06 XE44 A 04/29/2008 10:30:19 04/29/2008 10:44:44 07/10/2008 10:36:27 PMA003 3390 DISK SYSPROG.SF16.MM071098.T1036A73 XE44 A CA AUDIT TRAIL REPORT SMFD PAGE 1 CA SMF Director 12.7 SYSA 27 JUL yyyy 13:17:07 LISTH VOLUMES(FREE) . AVAILABLE SMF DUMP VOLUMES: SMF100 SMF101 SMF102 SMF103 SMF104 SMF105 SMF106 CAF2900I RUN COMPLETE
Column Headings:
FROM
The oldest timestamp that was found in all records in the history file listed.
TO
The most recent timestamp that was found in all records in the history file listed.
DUMPED
The date and time that the history file was created.
VOLUME
The volume serial where the history file data set was originally written. History files that are written on DASD may be moved to different volumes by SMS.
UNIT
The unit type that was reported by the system when the history file was created. For virtual tape systems (VTS), the UNIT value reflects the tape device the VTS is emulating.
FILE
The file sequence number for history files that are written to tapes (real or virtual). For history files written to DASD, the value in this column is DISK. If the FILE value is preceded with an asterisk (*), the history file is past its expiration date and it is eligible for deletion using AUTODELETE.
DATA SET NAME
The data set name of the history file as generated during the dump process.
SID
The SMF ID of the data in the history file.
X
Indicates whether the history file is a primary (P) or alternate (A) history file.