IMS Online Reorganization Facility
The Image Copy function integrates with IMS Online Reorganization Facility and creates batch image copies for all the reorganized databases that are registered as recoverable with DBRC.
Supported image copy features
The following table summarizes the image copy features that are supported for IMS Online Reorganization Facility.
| Feature | Feature is supported? | |
|---|---|---|
| Format of output image copy data set | Batch image copy | Yes |
| Compressed image copy | Yes | |
| Fast Recovery image copy | Yes | |
| Data access method | Advanced Image Copy Services support Note 1 | Yes |
| High Performance Input/Output interface | Yes | |
| OS access method | Yes | |
| Processing type | Parallel processing | Yes |
| Dynamic allocation of output image copy data sets Note 2 | Yes | |
| Batch image copy and concurrent image copy | Batch | |
| Processing option | Stacking output image copies | Yes |
| Database pointer check (HASH Check) | Yes | |
| Checkpoint Restart | - | |
| Creating multiple image copies at one time (maximum number of image copies) | Yes (2) | |
| Virtual image copy process | Yes | |
| Processing option control | Site default table | Yes |
| IMS command interface | Integration with IMS Tools Online System Interface | - |
| IMS Tools KB support | Central management of reports | Yes |
|
Notes:
|
||
How to request and control the image copy process
If you specify the ICEIN(ddname) keyword on the REORG HRFSYSIN DD statement, an image copy is created for each reorganized database data set. You can also code ddname DD statement in the IMS Online Reorganization Facility JCL to gain granular control over the image copy process.
Control statements for the image copy process are read from the following resources:
- HRFSYSIN DD control statement of IMS Online Reorganization Facility JCL stream.
- ICEINDD statement of IMS Online Reorganization Facility JCL stream. This DD statement name must be the ddname that the ICEIN keyword of the HRFSYSIN DD statement specifies.
- IMS HP Image Copy site default table, if the site default module is found in the STEPLIB concatenation.
You can specify ICEIN control statement keywords in the ICEIN DD statement, but ICEIN control statement keywords are not mandatory. If you do not supply ICEIN control statement keywords or keywords related to the image copy process in the HRFSYSIN DD control statement, the image copy process is run with default values.
Usage notes:
- GLOBAL, AIC, IC, and WAIT statements are supported. GROUP, ACIC, and CIC statements are not supported.
- 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.
- If you specify an ICEIN keyword that is not supported in IMS Online Reorganization Facility jobs, the keyword is ignored. No notification message is issued to alert that invalid ICEIN keywords are found.
- Some HRFSYSIN keywords are mutually exclusive with ICEIN control statement keywords. For example, if you specify IC.VIC=Y in the HRFSYSIN DD statement, then you cannot specify VIC=Y in the ICEIN DD statement. For such keywords, consider specifying the equivalent ICEIN keywords in the ICEIN DD. The following table summarizes the HRFSYSIN keywords that are mutually exclusive with ICEIN keywords.
| HRFSYSIN keyword | Equivalent ICEIN keyword |
|---|---|
| IC.VIC(Y | N) | VIC=Y | N |
| IC.VICDSN(dsname) | VICDSN=dsname |
| PTRCHECK(Y | N | HISTORY | BITMAP | FSEMAP | MAXFSD) | HDPC=(Y | N | HISTORY | BITMAP | FSEMAP | MAXFSD) |
| IC1DSN | DSN=expression |
| IC2DSN | DSN2=expression |
| ICNUM | ICOUT=(*|ddn) for single image
copy ICOUT=(*|ddn,*|ddn) for dual image copies |
| ICDYN | ICDALLOC=Y | N |
| ICHLQ | ICHLQ=hlq|(hlq1,hlq2) or ICHLQ=hlq for primary image copy ICHLQ2=hlq2 for secondary image copy |
| ICMID | DSN=expression for primary image
copy DSN2=expression for secondary image copy |
| ICID | DSN for primary image copy DSN2 for secondary image copy |
| ICTRLR | &GDG in DSN=expression |
| ICVOLCT | VOLCNT=nnn |
| IC.COMP | COMP=Y | N |
| IC.COMPRTN | COMPRTN=routine |
| ICDDN | ICOUT=(ddn) for single image
copy ICOUT=(ddn,ddn) for dual image copies |
For information about invoking the Image Copy function in IMS Online Reorganization jobs, see the IMS Database Solution Pack IMS Online Reorganization Facility User's Guide.
Supported keywords and default values for the image copy process
The following table shows the ICEIN 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 | Topics |
|---|---|---|---|---|---|
| COMP | Yes | Yes | Y or N | N | COMP keyword |
| COMPRTN | Yes | Yes | routine | FABJCMP1 | 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 |
| DATA_MOVER | Yes | No | ADRDSSU or EMCSNAP | ADRDSSU | DATA_MOVER keyword |
| DBBUF | 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 |
| DSNTYPE | Yes | Yes | LARGE or BASIC | BASIC | DSNTYPE keyword |
| EXPDT | No | No | yyyyddd or yyddd | None | EXPDT keyword |
| EXPDT2 | No | Yes | yyyyddd or yyddd | None | EXPDT2 keyword |
| FASTIC | Yes | No | (opt,COPY) or NO | NO | FASTIC 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 Note 1 | Yes | Yes | Y|N|(Y,HISTORY, BITMAP,FSEMAP, MAXFSD,DBDIST, DEPDIST,SEGIO,VLSSUMM) Note 1 | N | 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 |
| ICHLQn | Yes | Yes | None | ICHLQn keyword | |
| ICNMRULE | Yes | No | Y or N | N | ICNMRULE keyword |
| ICOUT Note 2 | Yes | Yes | One of the following formats: Note 2
|
* | ICOUT keyword |
| ITKBLOAD | Yes | No | dsn or *NO | *NO | ITKBLOAD keyword |
| ITKBSRVR Note 3 | Yes | No | servername or *NO | *NO | ITKBSRVR 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 |
| OFFLDSTACK | Yes | Yes | ddn, *, or N | N | OFFLDSTACK keyword |
| OFFLDTYPE | Yes | Yes | N, S, or F | N | OFFLDTYPE keyword |
| PART | No | Yes | partname | None | PART keyword |
| RETPD | No | Yes | parm | None | RETPD keyword |
| RETPD2 | No | Yes | parm | None | RETPD2 keyword |
| SHDWDELETE | Yes | No | EACH or ALL | EACH | SHDWDELETE keyword |
| SHDWDSN | Yes | No | shdwhlq.SHDW.dbdname.ddname or name_expression | shdwhlq.SHDW.dbdname.ddname | SHDWDSN keyword |
| SHDWHLQ | Yes | Yes | hlq | None | SHDWHLQ keyword |
| SHDWMGMTCL | Yes | Yes | mgmt_class_name | None | SHDWMGMTCL keyword |
| SHDWSTORCL | Yes | Yes | store_class_name | None | SHDWSTORCL keyword |
| SHDWVOLSER | Yes | Yes | volser or (volser1,volser2,...) | None | SHDWVOLSER keyword |
| SPACE | Yes | Yes | (CYL|TRK|blk, primary, secondary) | None | SPACE keyword |
| SPMN | Yes | Yes | YES or NO | NO | SPMN keyword |
| STACK | Yes | Yes | One of the following formats:
|
None | STACK keyword |
| STACKBASE | Yes | No | TEMP or 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 |
| THRESHOLDS | Yes | Yes | keyword=value| (keyword1=value1, keyword2=value2,...) | - | THRESHOLDS 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 Note 4 | Yes | Yes | Y or N or (Y or N,ONPC or OFFPC) Note 4 | N | VIC keyword |
| VICDSN | Yes | No | expression | 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 | N | WAITALOC keyword |
| WAITMSG | Yes | No | Y or N | Y | WAITMSG keyword |
| WAITTIME | Yes | No | nnnn | 30 | WAITTIME keyword |
| ZIIPMODE | Yes | No | COND or NEVER | NEVER | ZIIPMODE keyword |
|
Notes:
|
|||||