Function

The cache cleanup batch utility (B97DECCH) removes list data whose retention period has expired from the Adabas Audit Data Retrieval cache spool.

The retention period of data in the cache spool is specified using the LST parameter B97_CLEANUP_CACHE=n in the B97LSTxx member in the BETA.PARMLIB, where n refers to a number of days (default: 5).

Running B97DECCH

You should run this utility on a daily basis to ensure that obsolete list data is deleted from the Adabas Audit Data Retrieval cache spool.

Tailored JCL for this job can be found in member B97DECCH in the BETA97.CNTL and in the corresponding step of the B97DAILY job.

You can also submit this batch utility online using option S.3.6 from the "Primary Selection Menu". This will generate JCL from member SE97CCLN of the BETA97.ISPSLIB (skeleton library).

JCL

+--------------------------------------------------------------------+
|jobcard |
|//B97DECCH EXEC PGM=BST01RFF,REGION=0M,PARM=('S=97', |
|// 'PGM=B97DECCH', |
|// 'B01LST=xx', |
|// 'B97LST=xx', |
|// 'SIGNON=YES') |
|//* |
|//STEPLIB DD DISP=SHR,DSN=BETA97.LOAD |
|// DD DISP=SHR,DSN=BSA.LOAD |
|//* |
|//SFFPARM DD DISP=SHR,DSN=BETA.PARMLIB |
|//B97DEF DD DISP=SHR,DSN=BETA97.DB.DEF |
|//* |
|//IRMLOG DD SYSOUT=* |
|//IRMERROR DD SYSOUT=* |
|//IRMPRINT DD SYSOUT=* |
|//SYSPRINT DD DUMMY |
|//SFFFDUMP DD SYSOUT=* |
|//SYSABEND DD SYSOUT=* |
|//* |
+--------------------------------------------------------------------+

Return codes

0	The program terminated normally.
4	The program did not find any data to be removed; the program terminated normally.
>4	One or several errors occurred during processing. Please check the job log for details. Some return codes are program-specific. Others are standard return codes which can also be modified. More information on standard return codes can be found in "Return codes".

IRMLOG

A processing log is written to DD IRMLOG. It contains the following information:

• Current value of the LST parameter B97_CLEANUP_CACHE, which determines the retention period of data in the cache spool; the batch utility B97DECCH deletes all data that has not been accessed for the specified number of days.
• Usage of cache spool in percent before B97DECCH
• Number of 4-MB blocks of data processed and number of 4-MB blocks of data deleted
• Usage of cache spool in percent after B97DECCH

+-----------------------------------------------------------------------------------------------+
|IRM1561I PROGRAM: B97DECCH VERSION: V7R2M00 PTFLVL: ptflvl COMPILED: date, time |
|IRM2100I CACHE CLEANUP PROCESSING STARTED - DATE: 12.03.2020, TIME: 11:06:14 |
|IRM2130I ************************************************************************************* |
|IRM2130I CACHE CLEANUP HAS BEEN STARTED FOR THE LAST 0005 DAYS |
|IRM2130I 050 % OF CACHE DATASETS ARE USED |
|IRM2130I 0001500 OBJECTS PROCESSED AND 0000750 OBJECTS DELETED |
|IRM2130I 025 % OF CACHE DATASETS ARE USED |
|IRM2130I ************************************************************************************* |
|IRM2199I CACHE CLEANUP PROCESSING ENDED - DATE: 12.03.2020, TIME: 11:06:14, RC: 0000 |
+-----------------------------------------------------------------------------------------------+