What's new in IMS HP Image Copy

This topic summarizes the technical changes for this edition.

New and changed information is denoted by carets (Symbol that indicates the start of new or changed content) and (Symbol that indicates the end of new or changed content) at the beginning and end of the new or changed information. Editorial changes that have no technical significance are not noted.

Revision markers follow these general conventions:
  • Only technical changes are marked; style and grammatical changes are not marked.
  • If part of an element, such as a paragraph, syntax diagram, list item, task step, or figure is changed, the entire element is marked with revision markers, even though only part of the element might have changed.
  • If a topic is changed by more than 50%, the entire topic is marked with revision markers (so it might seem to be a new topic, even though it is not).
Revision markers do not necessarily indicate all the changes made to the information because deleted text and graphics cannot be marked with revision markers.
Start of change

SC19-2756-15 (May 2025)

Description Related APARs
Documentation update. Added descriptions for return codes and reason codes in message FABJ3945E. N/A
End of change

SC19-2756-14 (March 2025)

Description Related APARs
Added message FABJ3946E, which is issued only when the job runs in an IMS-managed ACBs environment to report the name of the DBD that could not be obtained. PH65481

SC19-2756-13 (March 2023)

Description Related APARs
Added information about creating image copies of a HALDB and the IMS catalog to the following topics: N/A

SC19-2756-12 (January 2023)

Description Related APARs
Image Copy function: Enables HASH pointer check to run in an IMS-managed ACBs environment for Fast Path databases. The following topics are updated: PH51029
Documentation updates. The following topics are updated: N/A

SC19-2756-11 (October 2022)

Description Related APARs
Image Copy function: The Image Copy function can wait and retry dynamic allocation of database data sets when they are already allocated by another application with the DISP=OLD option. The following topics are added or updated: PH49342

SC19-2756-10 (August 2022)

Description Related APARs
Image Copy function: Enables the HASH Pointer Check and Integrated DB Sensor to run in an IMS-managed ACBs environment for full-function databases. The following topics are updated: PH43078
Image Copy function: When FASTIC=(,DUMP) is applied, the Concurrent Image Copy (CIC) process retries to read CIs when CI or CA splits are detected. The following topics are updated or added: PM46198

SC19-2756-09 (July 2022)

Description Related APARs
Documentation updates to support IMS Administration Foundation, which activates the IMS administration web-browser interface of IBM® Unified Management Server for z/OS® to enable the management IMS systems and resources. N/A

SC19-2756-08 (March 2022)

Description Related APARs
Image Copy function, Recovery function, Create Image Copy function (FABJMAIN program): You can specify default values for the following keywords by using the Site Default Generation utility:
  • CAUNIT, DATACLAS, DATACLAS2, DATACLASn, ICHLQ2, ICHLQn, ICUNIT, LOGUNIT, MGMTCLAS, MGMTCLAS2, MGMTCLASn, RETPD, RETPD2, RETPDn, SHDWMGMTCL, SHDWSTORCL, STORCLAS, STORCLAS2, STORCLASn, TIMECHK
The following topics are updated:
PH40355

SC19-2756-07 (November 2021)

Description Related APARs
Image Copy function: RECALL keyword support. The RECALL keyword recalls input database data sets if the input database data sets are migrated by DFSMShsm so that the Image Copy function can process the database data sets. The following topics are added or updated: PH40359

SC19-2756-06 (October 2021)

Description Related APARs
Image Copy function and Recovery function: These functions can run in an IMS environment where the IMS management of ACBs is enabled. The following topics are added or updated: PH40351

SC19-2756-05 (August 2021)

Description Related APARs

Image Copy function: The DUMP process of Advanced Image Copy Services does not support creating image copy data sets of database data sets that are allocated as extended format data sets. Restrictions and an error message are added to the following topics:

 PH38959

Recovery function: If the input image copy data set is created by the DUMP or the COPY process of Advanced Image Copy Services or the IMS Database Image Copy 2 utility (DFSUDMT0), the Recovery function cannot use that image copy data set to recover the database data set with different allocation attributes. The allocation attributes of the database data set must be the same as the original database data set. The following topics are updated:

 N/A

SC19-2756-04 (June 2021)

Description Related APARs
Messages FABJ0315E and FABJ0451E are added. Also, message FABJ0450E is modified. PH32404 and PH31473
Support HISTORY option for DEDB Pointer Checker: Use the HISTORY option to record DEDB history data during DEDB HASH Check. For more information, see the following topics: PH30776
Descriptions about time stamp recovery are added. See the following topics: N/A

SC19-2756-03 (July 2020)

Description Related APARs
Support for encrypted database data sets: Functions and features of IMS HP Image Copy support encrypted database data sets. For more information, see Data set encryption support and KEYLABEL keyword. PH12098, PH19075, PH21572, and PH25480
Option to group digits printed in HASH Check reports: Use the GROUPDIGITS keyword to enable or disable digit grouping for the numeric values printed in Database Statistics reports and Partition Statistics reports of HD Pointer Checker, which are generated by HASH Check. For more information, see GROUPDIGITS keyword. PH10418
Option to stop all IMS image copy processes when an error occurs: Use the IC_ERROR keyword to terminate all image copy processes for all database data sets when an error occurs in one of the image copy processes. For more information, see IC_ERROR keyword. PH09623
Wildcard support for the DBD and PART keywords of the Image Copy function: The DBD keyword and the PART keyword of the Image Copy function support wildcard characters. For more information, see DBD keyword and PART keyword. PH06305
&GROUP symbolic parameter support for IMS Database Recovery Facility: The data set naming template support symbolic parameter &GROUP for the DBRC group name. For more information, see Data set naming template. PI78538
Support Fast Recovery image copy format for IMS Online Reorganization Facility: Image Copy jobs invoked by IMS Online Reorganization can create image copies in Fast Recovery image copy format. For more information, see IMS Online Reorganization Facility. PI63757
Support for EMC TimeFinder: The Create Image Copy function supports EMC TimeFinder as the data mover utility. For more information, see DATA_MOVER keyword. PI69169
Changes to the default values of the number of parallel Image Copy tasks: The default values for the number of tasks that can run in parallel in Image Copy jobs have changed. For more information, see the following topics: PI71145
Support for the large block interface: This APAR enhanced the Image Copy function to: PI95184

SC19-2756-02 (September 2016)

Description Related APARs
Support alias for the TOIXCFGR keyword:
  • The new TOSIXCFGRP keyword is an alias for the TOIXCFGR keyword and it functions identically to the TOIXCFGR keyword.
  • The new (HPIC) statement parameter, STACMDFAIL, is supported for the HPSRETCD control statement for return code handling.
For more information, see TOSIXCFGRP keyword and HPSRETCD control statement. 		PM54604
Support for up to 2048 ICEIN DD statements: You can specify up to 2048 ICEIN DD statements when you use the Image Copy function or the Create Image Copy function. PM60451
Support deletion of incomplete output image copy data sets: The new DEL_ICDS keyword deletes the image copy data set of the database data set when errors occur in the image copy process for the database data set. For more information, see DEL_ICDS keyword. PM68259
Support ICDALLOC keyword for the Site Default Generation utility: The default value of ICDALLOC keyword can be changed by using the Site Default Generation utility. For more information, see Setting default values for the FABJMAIN program. PM71579
Restrict reuse of output image copy data sets: The new NOREUSE keyword restricts the reuse of image copy data sets that are cataloged in the system. For more information, see NOREUSE keyword. PM76650
Store messages in the DFSPRINT data set in the IMS Tools Knowledge Base Output repository: Messages that are written to the DFSPRINT data set can now be stored in the Output repository of IMS Tools Knowledge Base. PM77057
IMS 13.1 support: IMS HP Image Copy supports IMS 13.1. PM75253
Switch from the batch image copy process to the concurrent image copy process: The new FALLBACK keyword requests to switch from the batch image copy process to the concurrent image copy process when exclusive authorization is not granted. For more information, see FALLBACK keyword. PM84891
Site Default Generation utility enhancement to support IMS compatible JCL: The Site Default Generation utility can now generate the site default table for use with IMS compatible JCL streams. You can set default values and have them applied when you run IMS HP Image Copy functions with IMS compatible JCL. For more information, see Setting default values (IMS compatible JCL). PM90276
IMS /START command support for offline databases: IMS HP Image Copy can issue, through the IMS Tools Online System Interface, the /START command to start the offline database, partition, or area. With this option, you can start IMS applications immediately after the database is initialized or reorganized. For more information, see TOIAUTO_STA keyword. PI20067
EMC TimeFinder support for Advanced Image Copy Services: The new DATA_MOVER keyword requests to use the EMC TimeFinder for the COPY and the FDUMP processes of Advanced Image Copy Services. For more information, see DATA_MOVER keyword. PI47936
Advanced Image Copy Services enhancement to support IMS Online Reorganization Facility: Advanced Image Copy Services is enhanced to support IMS Online Reorganization Facility. You can create image copies in Fast Recovery image copy format in IMS Online Reorganization Facility jobs. For more information, see IMS Online Reorganization Facility. PI63757
Support ICOUT=%NO parameter for FASTIC=N or FASTIC=(,DUMP): Before this enhancement, ICOUT=%NO, which specifies to create no image copy data sets, can only be used when the FASTIC keyword specifies (opt,FDUMP) or (opt,COPY). After this APAR is applied, you can also use ICOUT=%NO when FASTIC=N or FASTIC=(opt,DUMP). PI66117

SC19-2756-01

Description Related APARs
IMS GLOBAL keyword support: You can use the TOIAUTO keyword to control whether to issue the IMS commands for all online subsystems that share the database. See TOIAUTO keyword. PM10319 and PM12249
IMS Fast Path Online Tools support: You can call the Image Copy function within IMS Fast Path Online Tools jobs of IMS Fast Path Solution Pack for z/OS. See IMS HP Fast Path Utilities. PM11511
Online Pointer Checking function support: By using the Online Pointer Checking function, you can run a HASH pointer check without creating image copies. See Pointer checking online full-function databases. PM15237
FASTIC and DBALL keyword enhancements: This APAR adds the following enhancements:
  • You can specify the Image Copy function to run with the FCTOPPRCPrimary option of the DFSMSdss COPY command. See FASTIC keyword.
  • You can specify the Image Copy function to process only the DBDSs that are logically related. See DBALL keyword.
 PM28291
IMS Tools KB support in IMS Online Reorganization Facility jobs: You can store the IMS HP Image Copy reports and IMS HP Pointer Checker reports that are generated in IMS Online Reorganization Facility jobs in the IMS Tools KB Output repository. See Central management of reports. PM28407
DB Sensor support: By using the Integrated DB Sensor, you can collect statistics from databases while the Image Copy function is run and store the statistics in the IMS Tools KB Sensor Data repository. See Collect sensor data with Integrated DB Sensor. PM50159
The following fixes and changes were made:
  • The BYPDBAUTH keyword was added to bypass DBRC database authorization for index databases that are processed with the VIC=Y option.
  • You can create up to four image copy data sets for one DBDS or an area.
  • The default value for the I/O buffer of the image copy data set was changed to 50.
  • The size of the checkpoint file (used for the Checkpoint Restart function) was reduced.
  • The CIC_KSDS keyword was added to prevent a concurrent image copy from being created if the database is KSDS.
  • IMS HP Image Copy retries the DFSMSdss DUMP command process under certain conditions.
 PM34344, PM40738, PM45137, and PM46198