Archiving data (CMRPURG)
If specified, CMRPURG can also archive and purge selected data to a tape data set and merge it with other archive tapes.
Refer to the MainView for CICS Customization Guide for information about using CMRPURG to archive CMRDETL records in a single or dual data set environment.
The execution JCL for CMRPURG is shown in the following figure. Descriptions corresponding to the numbered statements follow the JCL.
Note
Sample JCL for the CMRPURG program is in the CMRPURGE member of your BBSAMP data set.
Sample JCL to run to merge, archive, and purge CMRDETL records
//jobname JOB user parameters
/*JOBPARM user parameters
//JOBLIB DD DISP=SHR,DSN=CMR.CMRV5.BBLINK
//ARCHIVE EXEC PGM=CMRPURG
//TAPEIN DD DISP=OLD,DSN=PREV.HISTORY.FILE (1)
//TAPEOUT DD DISP=(NEW,CATLG),DSN=CMR.MERGED.ARCHIVE,UNIT=TAPE (2)
//CMRWRK1 DD DSN=CMR.CMRWRK1,SPACE=(CYL,(10,10)),UNIT=SYSDA (3)
// DISP=(NEW,DELETE,CATLG)
//CMRDETL DD DISP=SHR,DSN=CMR.CMRV5.CMRDETL (4)
//REPORT DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DATE=mmddyyyy (5)
HISTORY=YES (6)
The numbered items in the following list explain the JCL statements of the example CMRPURG job shown in the figure:
identifies a data set that is to be merged and archived with the purged records.
identifies the output tape data set for the purged records. The default DCB is
DSORG=PS,RECFM=VB,LRECL=32736,BLKSIZE=32740
.(specifies a data set, CMRWRK1, to hold all records that are not archived during the reorganization phase. The recorder data sets also must be defined with REUSE so that reorganization can occur. The records can be written to either tape or disk.
identifies the CMRDETL or CTGDETL recorder data sets to be processed. Archiving each data set to a separate tape as separate jobs increases access to statistical data because there is less volume. More days can then be kept online without requiring a purge.
specifies the date for purging. This statement must start in column 1. All data stamped with this or a previous date is purged and, if requested, archived to the output tape data set. DATE=12319999 purges all the data from the recorder data set.
Note
If 12319999 is specified, the CMRWRK1 data set is not required.
The date for purging can also be specified as a number of days preceding today. The format is
DATE=*-
nnwhere nn is a two-digit number of days before today. Note that the date calculated can represent a day in the previous year. The actual date calculated by the program is displayed in an informational message on the report output.
specifies the type of history tape manipulation to be performed. This statement must start in column 1. Valid values are as follows:
NO specifies that no input or output history tapes are to be used. All data that has a date earlier than the DATE value will be purged.
OUT specifies that no input tape is to be used. Only an output tape is to be created containing the data to be purged.
YES specifies that both input and output tapes are to be used. The data on the input tape is to be merged with the data to be purged from the MainView for CICS recorder data sets and written to the output tape.
LEAVE= specifies whether to leave data in the data set or purge it after archival. This statement must start in column 1. Valid values are as follows:
NO specifies that data is removed from the data set. The default is NO (it is not specified in the sample). NO is required for single CMRDETL environment. It is not recommended in dual data set environment because data will not be available for online access after the switch.
YES specifies that data remains in the data set after archival. This value is recommended only for dual CMRDETL or CTGDETL data set environment. It provides online access to the data after a data set switch occurs.
Comments
Log in or register to comment.