Using Advanced Image Copy Services with the Image Copy function

Advanced Image Copy Services is initiated if the FASTIC keyword of the ICEIN control statement is present in IMS HP Image Copy JCL.

Before you begin

Ensure that all the input database data sets are cataloged.

Procedure

In FABJMAIN JCL, code the EXEC statement as follows:
```
// EXEC  PGM=FABJMAIN,REGION=nM,IMSPLEX=plex-name,DBRCGRP=dbrcgrp
```
Where:

IMSPLEX

If you need to start IMSplex through the IMS HP Image Copy job, specify the IMSPLEX parameter.

DBRCGRP

If you use the DBRCGRP keyword of IMS, you must specify the DBRCGRP parameter.
Code DD statements to define the input and output data sets. For more information, see DD statements for creating image copies.

Tip: It is recommended that you specify the DSSPRINT DD statement. This DD statement specifies the output stream for printing DFSMSdss messages, which are useful when you troubleshoot DFSMSdss problems.
Code the ICEIN DD statement and control statement keywords. The following JCL example starts an image copy job that uses Advanced Image Copy Services.
```
//EXAMPLE1   JOB   
//           EXEC PGM=FABJMAIN
//STEPLIB    DD DISP=SHR,DSN=HPS.HPSLMD0
//           DD DISP=SHR,DSN=IMS.SDFSRESL
//DFSRESLB   DD DISP=SHR,DSN=IMS.SDFSRESL
//IMS        DD DISP=SHR,DSN=IMS.DBDLIB
//IMSDALIB   DD DISP=SHR,DSN=IMS.EXAMPLE.MDALIB
//DFSPRINT   DD SYSOUT=*
//ICEPRINT   DD SYSOUT=*
//DSSPRINT   DD SYSOUT=*
//ICEIN      DD *
  GLOBAL   UNIT=TAPE,VOLCNT=99,ICHLQ=ICOUT.DBT,FASTIC=(PREF,DUMP)           1 
  IC       DBD=HDAMDB01,DDN=HDAMDD01,ICOUT=*                                2 
  IC       DBD=HDAMDB01,DDN=HDAMDD02,ICOUT=*                                2 
```
1 On the GLOBAL statement, code the FASTIC keyword to enable Advanced Image Copy Services. The FASTIC keyword is in effect for all image copies created in this job step.
Supply two operands for the FASTIC keyword:
- The first operand (FREQ, REQ, PREF) specifies whether to fail the job when DFSMSdss Advanced Copy Services cannot be used or continue the job by using standard I/O instead.
- The second operand (COPY, FDUMP, DUMP) specifies the DFSMSdss Advanced Copy Services function to use. The format of the image copies is determined based on the second operand. For more information, see Format of image copy data sets.
For FASTIC keyword operands, see the following topics:
2 Code IC, AIC, CIC, or ACIC statements. Advanced Image Copy Services is supported for both the batch image copy process (IC/AIC) and the concurrent image copy process (CIC/ACIC).

Only one database data set can be specified on one image copy statement. To create image copies of multiple database data sets, code one image copy statement for each database data set.
Submit the job.

Results

During the job, the following DFSMSdss API messages are generated in the DFSPRINT data set. This example is when FASTIC=(REQ,COPY) is specified.

Figure 1. Messages produced in DFSPRINT data set

DFS391I    D A T A   B A S E   D A T A   S E T   I M A G E   C O P Y   U T I L I T Y        
                                                                                            
                                                                                            
      S Y S I N   C O N T R O L   C A R D                                                   
D1 P1E      P1E1     P1E1IC1                   N                                            
      E N D   O F   S Y S I N   C O N T R O L   C A R D                                     
DFS391I    **COPY DATA BASE P1E      DDNAME P1E1                                            
FABJ4237I LOGICAL COPY COMPLETE FOR DB/AREA P1E    DDN P1E1     DSN MDOOLEY.HPIC.P1E1 
FABJ4239I PHYSICAL COPY BEGIN FOR DB/AREA P1E      DDN P1E1     DSN MDOOLEY.HPIC.P1E1 
FABJ4233I PHYSICAL COPY COMPLETE FOR DB/AREA P1E   DDN P1E1     DSN MDOOLEY.HPIC.P1E1 
FABJ4217I NOTIFY.IC SUCCESSFUL FOR DBD P1E      DDN P1E1                                    
**** END OF MESSAGES FOR DB/AREA: P1E      DDNAME: P1E1     DSNAME: MDOOLEY.HPIC.P1E1       
                                                                                            
...
                                                                                                                   
DFS339I    FUNCTION IM HAS COMPLETED NORMALLY RC=00

Message FABJ4237I indicates that logical copy processing was successful.
Message FABJ4239I indicates that physical copy processing has begun.
Message FABJ4233I indicates that physical copy processing was successful.

When image copy processing for each database ends, database authorization is released. The following messages are written to the job log (using WTO).

Figure 2. Messages issued during FASTIC processing

FABJ4260I COPY PROCESSING COMPLETE FOR DB/AREA P1E    0000 OF 0003 DATASETS FAILED
+FABJ4262I END OF UNAUTHORIZATION PROCESS FOR DBD=P1E
FABJ4261I COPIED DB/AREA P1E      DDN P1E1     DSN MDOOLEY.HPIC.P1E1
FABJ4261I COPIED DB/AREA P1E      DDN P1E2     DSN MDOOLEY.HPIC.P1E2
FABJ4261I COPIED DB/AREA P1E      DDN P1E3     DSN MDOOLEY.HPIC.P1E3
FABJ4263I ALL DATABASES WERE RELEASED FROM HPIC PROCESS

Message FABJ4262I is issued at the time when:

For the FASTIC COPY option, image copy data sets of the database data sets are created.
For the FASTIC FDUMP option, shadow data sets are created.
For the FASTIC DUMP option, logical copy completed.