IMS Database Reorganization Expert
The Image Copy function integrates with IMS Database Reorganization Expert and creates batch image copies while the reorganization job is running.
The Image Copy
function can be invoked by the Smart Reorg
utility. The following two types of image copy processing are supported:
- Type-A image copy
- The image copy process runs during the reorganization phase. Image copies are taken while secondary indexes are being built and the database data sets are being reloaded to shadow data sets.
- Type-B image copy
- The image copy process runs after the reorganization phase. Image copies are taken after the completion of reloading shadow data sets and while building secondary indexes.
Supported image copy features
The following table summarizes the image copy features that are supported for IMS Database Reorganization Expert.
| Feature | Feature is supported? | ||
|---|---|---|---|
| Type-A image copy | Type-B image copy | ||
| Format of output image copy data set | Batch image copy | Yes | Yes |
| Compressed image copy | Yes | Yes | |
| Fast Recovery image copy | - | - | |
| Data access method | Advanced Image Copy Services support | - | - |
| High Performance Input/Output interface | - | Yes Note 1 | |
| OS access method | - | Yes Note 1 | |
| Processing type | Parallel processing | Yes Note 2 | Yes |
| Dynamic allocation of output image copy data sets Note 3 | Yes | Yes | |
| Batch image copy and concurrent image copy | Batch | Batch | |
| Processing option | Stacking output image copies | - | Yes |
| Database pointer check (HASH Check) | Yes | Yes | |
| Checkpoint Restart | - | - | |
| Creating multiple image copies at one time (maximum number of image copies) | Yes (2) | Yes (2) | |
| Virtual image copy process | Yes | Yes | |
| Processing option control | Site default table | Yes | Yes |
| IMS command interface | Integration with IMS Tools Online System Interface | - | - |
| IMS Tools KB support | Central management of reports | Yes Note 1 | Yes Note 1 |
|
Notes:
|
|||
How to request and control the image copy process
If you specify the IC=YES keyword in the REORG control statement block and supply allocation information for image copy data sets, an image copy is created for each reorganized database data set.
Other ICEIN control statement keywords are not mandatory. If you do not code other ICEIN control
statement keywords, the image copy process is run with default values. If you want to specify
keywords to control the image copy process, use the following resources:
- ICEIN DD statement of IMS Database Reorganization Expert JCL stream.
- IMS HP Image Copy site default table. The site default module must be included in the STEPLIB concatenation.
Usage notes: Image copy processing type (Type-A or Type-B) is
determined based on the ICTYPE keyword in the REORG control statement block. If you do not specify
the ICTYPE keyword, processing type is selected based on the database organization type.
Type-A image copy:
- AIC statement is always assumed, which means that batch image copies are created and data sets are processed in parallel.
- GLOBAL and AIC statements are supported. IC and WAIT statements can also be specified but these statements are not effective. GROUP, ACIC, and CIC statements are not supported.
- Tape devices cannot be specified on the DD statement for image copies of secondary index database data sets.
- When secondary index database data sets are processed and you specified the RETPD or EXPDT keyword, then you will receive message IEC507D (WTOR message MSGIEC507D). When this message is displayed, enter U to proceed.
Type-B image copy:
- AIC statement is always assumed, which means that batch image copies are created and data sets are processed in parallel. If you want to process data sets sequentially, specify IC statements in the ICEIN DD statement.
- GLOBAL, AIC, IC, and WAIT statements are supported. GROUP, ACIC, and CIC statements are not supported.
For information about invoking the Image Copy function in IMS Database Reorganization Expert jobs, see the IMS Database Reorganization Expert User's Guide.
Supported keywords and default values for the image copy process
The following table summarizes the keywords that you can use to control the image copy process.
| Keyword | Can be specified in ICEIN GLOBAL statement? | Can be specified in ICEIN IC or AIC statement? | Acceptable values | System default | Topic |
|---|---|---|---|---|---|
| COMP | Yes | Yes | Y or N | N | COMP keyword |
| COMPRTN | Yes | Yes | routine | FABJCMP3 | COMPRTN keyword |
| COMPMODE | Yes | No | Y or N | None | COMPMODE keyword |
| DATACLAS | No | Yes | class-name | None | DATACLAS keyword |
| DATACLAS2 | No | Yes | class-name | None | DATACLAS2 keyword |
| DBBUFNote 1 | Yes | Yes | nnnn | The value that is optimized for the data sets | DBBUF keyword |
| DBD | No | Yes | dbdname | None | DBD keyword |
| DDN | No | Yes | ddname | None | DDN keyword |
| DSN | Yes | No | expression | None | DSN keyword |
| DSN2 | Yes | No | expression | None | DSN2 keyword |
| EXPDT | No | No | yyyyddd oryyddd | None | EXPDT keyword |
| EXPDT2 | No | Yes | yyyyddd or yyddd | None | EXPDT2 keyword |
| GDGBASE | Yes | No | Y or N | N | GDGBASE keyword |
| GDGLIMIT | Yes | No | nnn | 10 | GDGLIMIT keyword |
| GROUPDIGITS | Yes | No | Y or (NO,DBSTAT) | Y | GROUPDIGITS keyword |
| HDPC | Yes | Yes | Y, (Y [,HISTORY,BITMAP, FSEMAP,MAXFSD]), N, or O |
Y | HDPC keyword |
| HPIO | Yes | Yes | Y or N or X | Y | HPIO keyword |
| ICBUF | Yes | No | nnnnn | The value that is optimized for the image copy data sets | ICBUF keyword |
| ICCAT | Yes | No | Y or N | Y | ICCAT keyword |
| ICDALLOC | No | No | Y or N | Y | ICDALLOC keyword |
| ICHLQ | Yes | Yes | hlq1 or (hlq1,hlq2) | None | ICHLQ keyword |
| ICHLQ2 | No | Yes | hlq2 | None | ICHLQ2 keyword |
| ICNMRULE | Yes | No | Y or N | N | ICNMRULE keyword |
| ICOUT | Yes | Yes | One of the following formats:
|
* | ICOUT keyword |
| IXKEYCHK | Yes | No | Y or N | N | IXKEYCHK keyword |
| KEYLABEL | Yes | Yes | 'key_label' | None | KEYLABEL keyword |
| LBI | Yes | No | Y or N | N | LBI keyword |
| MGMTCLAS | No | Yes | mgmt-class-name | None | MGMTCLAS keyword |
| MGMTCLAS2 | No | Yes | mgmt-class-name | None | MGMTCLAS2 keyword |
| MSGFREQ | Yes | Yes | nnnn | 0 | MSGFREQ keyword |
| PART | No | Yes | partname | None | PART keyword |
| RETPD | No | Yes | parm | None | RETPD keyword |
| RETPD2 | No | Yes | parm | None | RETPD2 keyword |
| SPACE | Yes | Yes | (CYL|TRK|blk, primary, secondary) | None | SPACE keyword |
| STACK | Yes | Yes | One of the following formats:
|
None | STACK keyword |
| STACKBASE Note 2 | Yes | No | TEMP|REAL | TEMP | STACKBASE keyword |
| STORCLAS | No | Yes | store-class-name | None | STORCLAS keyword |
| STORCLAS2 | No | Yes | store-class-name | None | STORCLAS2 keyword |
| TASKCTL | Yes | No | nnn | None | TASKCTL keyword |
| T2CHK | Yes | Yes | (nn,ll) | (0,7) | T2CHK keyword |
| UNIT | Yes | Yes | unit-name or (unit-name,unit-count) | SYSALLDA | UNIT keyword |
| UNIT2 | No | Yes | unit-name or (unit-name,unit-count) | SYSALLDA | UNIT2 keyword |
| USER | Yes | No | NO or user-id or (user-id1,user-id2,...) | NO | USER keyword |
| VIC | Yes | Yes | Y N (Y,ONPC) (Y,OFFPC) (N,ONPC) (N,OFFPC) |
N | VIC keyword |
| VICDSN | Yes | No | dsname | None | VICDSN keyword |
| VOLCNT | No | Yes | nnn | 1 | VOLCNT keyword |
| VOLSER | No | Yes | volser or (vol1,vol2,...) | None | VOLSER keyword |
| VOLSER2 | No | Yes | volser or (vol1,vol2,...) | None | VOLSER2 keyword |
| WAITALOC | Yes | No | Y or N | Y | WAITALOC keyword |
| WAITMSG | Yes | No | Y or N | Y | WAITMSG keyword |
| WAITTIME | Yes | No | nnnn | 30 | WAITTIME keyword |
|
Notes:
|
|||||