How to specify a retention period (ICRETPD) for IMS DB Image Copies?

Products

• Database Copier for IMS for z/OS
• DATABASE MANAGEMENT SOLUTIONS FOR IMS FOR Z/OS

Issue/Introduction

Requirement to standardize the retention period for production IMS DB image copies (e.g., 60 days) using the ICRETPD parameter within the DBOCTRL control statements. Need to know if additional parameters are required to enable ICRETPD.

Resolution

To successfully use the ICRETPD parameter in Image Copy jobs, the following requirements must be met:

1. Mandatory ICALLOC Parameter: The ICRETPD parameter requires ICALLOC=YES to be specified in the DBOCTRL control statements. This parameter enables the retention period functionality exclusively for dynamically allocated image copies IMS DB Retention.
2. JCL Modification: When ICALLOC=YES is used, any manual DBCCOPY1 DD statements must be removed from the copy job JCL IMS DB Retention.
3. Scope: The ICRETPD value specifically defines the number of days the created image copy will be retained IMS DB Retention.

Example Control Statements

The following example shows the correct syntax for implementing a 30-day retention period:

//DBOCTRL DD * FUNCTION=COPY,IMSID=xxxx,DBD=D200,ICPREF=xxx.xxxxxxx.DBC,ICRETPD=30,ICUNIT=SYSDA,FLASH=YES,ICALLOC=YES,DDNAME=D200,DBRC=YES,DELETEFLASH=YES