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.
Statement Format:
LISTH
►►─ LISTH ─┬─ SID(sid1,...sidn,) ─────────────────────────┬───────────────────►
├─ 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:
Specifies one or more SMF IDs, up to a maximum of 20, for the history-file index. This may be coded (sid1,sid2...).
This is the 4-character identifier that appears in the SMF data.
Specifies that index entries for all configurations are to be listed.
Specifies the beginning and ending of the period for which SMF index entries are to be displayed.
'date' is in Gregorian (mmddyy) format.
Specifies the beginning and ending dates for the period for which
'jdate' is in Julian date format (cyyddd).
Specifies that index entries in the primary pool are the only ones to be listed.
Specifies that index entries in the alternate pool are the only ones to be listed.
Produces a list of tape volume serials defined to this product. Only the volumes specified will be listed.
Produces a list of all tape volume serials defined to this product.
Produces a list of all available volume serials in the free pool.
Specifies that the index entries that match the specified volume serials on the VOLUMES keyword will be used.
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 will be listed in the LISTH output. If EXCLUDE is coded, all history files that contain only the specified record types and nothing else will be excluded from the output.
The list may include any valid SMF record types from 0 through 255. They may be coded as individual record types separated by commas or as a range of record types separated by colons. Up to 255 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.
Note: 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.
Lets you filter the history file index entries on a specified logstream. Only the entries that contain the data from the selected logstreams will be listed. Up to 21 logstreams may be coded.
If NONE is coded, no logstream-related history file entry will be included in the output.
If LSNAME is not coded, all history files dumped from all logstreams will be included.
Lets you filter the history file index entries on a specified substream. Only the entries that contain the data from the selected substreams will be listed. Up to 21 substreams may be coded.
If NONE is coded, no substream-related history file entry will be included in the output.
If SUBNAME is not coded, all history files dumped from all substreams will be included.
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 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.6 SYSA 27 JUL yyyy 11:09:54 LISTH ALL . CA AUDIT TRAIL REPORT SMFD PAGE 3 CA SMF Director 12.6 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.6 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.6 SYSA 27 JUL yyyy 13:17:07 LISTH VOLUMES(FREE) . AVAILABLE SMF DUMP VOLUMES: SMF100 SMF101 SMF102 SMF103 SMF104 SMF105 SMF106 CAF2900I RUN COMPLETE
| Copyright © 2011 CA. All rights reserved. | Tell Technical Publications how we can improve this information |