BCF Purge utility

To delete BCF records from the REGISET or the BCF history data set, use the program BCFXPURG.

Member #BCFPURG of the sample library (as shown in the following figure) contains JCL to run BCFXPURG.

BCF Purge utility JCL

//BCFXPURG JOB (ACCT),'BCF V3 PURGE UTIL',CLASS=A,MSGCLASS=X,
//     NOTIFY=&SYSUID,REGION=4M
//PURGE     EXEC   PGM=BCFXPURG,
// PARM='SSID=BCFQ'                             <== SUBSYSTEM ID
//*
//STEPLIB   DD DSN=BMC.BCF.LOAD,DISP=SHR        <== BCF LOAD LIBRARY
//          DD DSN=BMC.AES.LOAD,DISP=SHR        <== AES LOAD LIBRARY
//*
//BCFHIST   DD DISP=SHR,DSN=BMCBCF.QA.VSAM.HIST <== HISTORY FILE
//*
//SYSPRINT DD SYSOUT=*                         <== OUTPUT REPORTS
//*
//SYSIN     DD *                                <== UTIL Control STMTS
  REPORTS   JOB(RRD3105) STARDATE(-9) ENDDATE(-1)
//

The following statements are used in the JCL:

EXEC	(required) The program to execute is BCFXPURG. For the SSID parameter, code the subsystem ID of the BCSS that accesses the REGISET containing the records you want to delete.
STEPLIB DD	(required) Provide the data set name of the library that contains the AR/CTL and BCF component load modules.
BCFHIST DD	(required) Provide the data set name of the BCF history data set that contains the BCF records you want to purge.
SYSPRINT DD	(required) Specify SYSOUT=* or define it as a DASD data set.
SYSIN DD	(required) This control statement data set can contain several types of control statements. You must supply at least one control statement; however, the keywords on the control statements are optional. If you do not specify which items should be purged by supplying keywords and values for reports, options, skeletons, and log volumes, all records containing those types of data will be purged (depending on the control statement).

You can specify the following SYSIN commands to control the utility:

REPORTS

(optional) Purges the specified reports from the history data set. The following keywords are valid; all are optional. If you do not supply them, all statistics are purged.

Keyword	Description
JOB	The job name associated with the reports you want to purge.
STEP	The step name associated with the reports you want to purge.
PSB	The program specification block (PSB) name associated with the reports you want to purge.
STARDATE	The beginning date of a range of reports, in mm/dd/yyyy format or -nnnnn (relative date) format.
ENDDATE	The ending date of a range of reports, in mm/dd/yyyy format or -nnnnn (relative date) format.

OPTIONS

(optional) Purges the specified options records from the REGISET. The following keywords are valid; all are optional. If you do not supply them, all statistics are purged.

Keyword	Description
LEVEL	The system or job step level.
IMSID	The IMSID of the IMS system for which the options apply. Valid only at the system level.
JOB	The job name associated with the options you want to purge. Valid only at the job step level.
STEP	The step name associated with the options you want to purge. Valid only at the job step level.
PSB	The PSB name associated with the options you want to purge. Valid only at the job step level.

SKELS

(optional) Purges the specified skeleton records from the REGISET. The following keywords are valid; all are optional. If you do not supply them, all statistics are purged.

Keyword	Description
LEVEL	The global, system, or job step level.
DDNAME	The ddname for the skeleton records you want to purge.
DEVCLASS	The device class for the skeleton records you want to purge. Valid only at the system level.
IMSID	The IMSID of the IMS system for which the skeleton records apply. Valid only at the system level.
JOB	The job name associated with the skeleton records you want to purge.
STEP	The step name associated with the skeleton records you want to purge.
PSB	The PSB name associated with the skeleton records you want to purge.

LOGVOLx	(optional) Purges the specified log volume records from the history data set In the ddname, substitute 1 or 2 for x to specify primary log volume records or secondary log volume records. The following keywords are valid; all are optional. If you do not supply them, all primary or secondary log volume records are purged.

Keyword	Description
JOB	The job name associated with the log volume records you want to purge.
STEP	The step name associated with the log volume records you want to purge.
PSB	The PSB name associated with the log volume records you want to purge.
STARDATE	The beginning date of a range for specified log volume records, in mm/dd/yyyy format or -nnnnn (relative date) format.
ENDDATE	The ending date of a range for specified log volume records, in mm/dd/yyyy format or -nnnnn (relative date) format.

BCF Purge utility

APPLICATION RESTART CONTROL 4.1 (ARCHIVED)

On this page