When you specify the LISTCAT command and include the CREATION or
EXPIRATION parameter (or both), entries that have a creation or expiration
date are selected according to the number of days you specify in the
subparameter.
For example, in Figure 1 only
the entry USER.ALIAS is listed as a result of the LISTCAT CREATION(5)
job because it was created more than 5 days ago and all the objects
were created on the same day as the LISTCAT. When that job is run
on an older catalog, each entry that was created the specified number
of days ago or earlier is listed (that is, the CREATION number of
days specifies that all objects in the catalog at least 5 days old
are to be listed). The creation date of the data and index objects
of a cluster or alternate index is always the same as the creation
date of its associated cluster or alternate index object.
When you list all entries of a catalog, and you specify the CREATION
parameter, each user catalog connector entry is also listed regardless
of its creation date.
The LISTCAT CREATION keywords on the LISTCAT command are ignored
if the LIBRARYENTRIES or VOLUMEENTRIES keywords are also supplied.
Date filtering cannot be done for these types of entries being listed.
When the LISTCAT EXPIRATION(365) job is run, each entry whose expiration
date occurs within 365 days of today's date is listed, as in Figure 2.
When you list all entries of a catalog and you specify the EXPIRATION
parameter, each volume entry is listed because volume entries have
no expiration date.
The following can have a creation or expiration date: ALTERNATEINDEX,
CLUSTER, DATA, GDG, INDEX, NONVSAM, PAGESPACE and PATH.
The LISTCAT EXPIRATION keywords on the LISTCAT command are ignored
if the LIBRARYENTRIES or VOLUMEENTRIES keywords are also supplied.
Date filtering cannot be done for these types of entries being listed.
Figure 1. Example
of LISTCAT CREATION(5) Output***************************************************************************************************************/
/* LIST EACH CATALOG ENTRY WHOSE CREATION DATE IS 5 DAYS AGO OR EARLIER */
/* (THAT IS, THE OBJECT IS AT LEAST 5 DAYS OLD) */
/***************************************************************************************************************/
LISTING FROM CATALOG -- ICFUCAT1
LISTCAT -
CREATION(5) -
CATALOG(ICFUCAT1/ )
ALIAS --------- USER.ALIAS
THE NUMBER OF ENTRIES PROCESSED WAS:
AIX -------------------------0
ALIAS ---------------------1
CLUSTER ---------------0
DATA ---------------------0
GDG -----------------------0
INDEX --------------------0
NONVSAM -------------0
PAGESPACE ---------0
PATH --------------------0
SPACE ------------------0
USERCATALOG ----0
TOTAL ------------------1
THE NUMBER OF PROTECTED ENTRIES SUPPRESSED WAS 0
IDC0001I FUNCTION COMPLETED, HIGHEST CONDITION CODE WAS 0
Figure 2. Example
of LISTCAT EXPIRATION(365) Output /******************************************************************/
/* LISTCAT 'USER' ENTRIES THAT HAVE EXPIRATION DATES WITHIN THE */
/* NEXT 365 DAYS */
/******************************************************************/
LISTCAT -
EXPIRATION(365) /* LIST EXPIRATION OF 365 */ -
NAME /* NAMES ONLY */ -
CATALOG(ICFUCAT1) /* IN CATALOG ICFUCAT1 */
LISTING FROM CATALOG -- ICFUCAT1
CLUSTER ------- 00000000000000000000000000000000000000000000
DATA ------- ICFUCAT1
INDEX ------ ICFUCAT1.CATINDEX
CLUSTER ------- SYS1.VVDS.V1P0101
DATA ------- SYS1.VVDS.V1P0101
CLUSTER ------- SYS1.VVDS.V1P0201
DATA ------- SYS1.VVDS.V1P0201
CLUSTER ------- SYS1.VVDS.V1P0202
DATA ------- SYS1.VVDS.V1P0202
CLUSTER ------- SYS1.VVDS.V1P0301
DATA ------- SYS1.VVDS.V1P0301
CLUSTER ------- SYS1.VVDS.V1P0302
DATA ------- SYS1.VVDS.V1P0302
CLUSTER ------- SYS1.VVDS.V338001
DATA ------- SYS1.VVDS.V338001
ALIAS --------- USER.ALIAS
CLUSTER ------- USER.DUMMY
DATA ------- USER.DUMMY.CLDATA
INDEX ------ USER.DUMMY.CLINDEX
GDG BASE ------ USER.GDGBASE
NONVSAM ---- USER.GDGBASE.G0003V00
NONVSAM ---- USER.GDGBASE.G0004V00
NONVSAM ---- USER.GDGBASE.G0005V00
NONVSAM ---- USER.GDGBASE.G0006V00
NONVSAM ------- USER.GDGBASE.G0001V00
NONVSAM ------- USER.GDGBASE.G0002V00
AIX ----------- USER.KSDS1.AIX1CLUS
DATA ------- USER.KSDS1.AIX1DATA
INDEX ------ USER.KSDS1.AIX1INDX
PATH ------- USER.KSDS1.PATHAIX1
CLUSTER ------- USER.KSDS1.CLUSTER
DATA ------- USER.KSDS1.CLDATA
INDEX ------ USER.KSDS1.CLINDEX
PATH ------- USER.KSDS1.PATHCL
NONVSAM ------- USER.MODEL
NONVSAM ------- USER.NONVSAM.DATA.SET
NONVSAM ------- USER.PDSE
THE NUMBER OF ENTRIES PROCESSED WAS:
AIX -------------------1
ALIAS -----------------1
CLUSTER ---------------9
DATA -----------------10
GDG -------------------1
INDEX -----------------4
NONVSAM ---------------9
PAGESPACE -------------0
PATH ------------------2
SPACE -----------------0
USERCATALOG -----------0
TOTAL ----------------37
THE NUMBER OF PROTECTED ENTRIES SUPPRESSED WAS 0
IDC0001I FUNCTION COMPLETED, HIGHEST CONDITION CODE WAS 0
IDC0002I IDCAMS PROCESSING COMPLETE. MAXIMUM CONDITION CODE WAS 0