What is the purpose of the CA RC/Extract Utility Extract option "Use Image Copy ==> T (for TEMPLATE)"?

Document ID : KB000021207
Last Modified Date : 14/02/2018
Show Technical Document Details


When performing an Extract Using an Image Copy that you wish to specify, it is necessary to use the CA RC/Extract for DB2 for z/OS (RCX) batch parm IMAGECOPY. It is one of the few times when using RCX that manually edited cards need to be added to a BATCH UTILITY JCL script by the user.

Samples are as follows:

IMAGECOPY(extID-image.copy.dataset.partition_number)    Extracting from a part level image copy
IMAGECOPY(extID-image.copy.dataset(0))                  Extracting from a image copy on a GDG
IMAGECOPY(extID-image.copy.dataset)                     Extracting from a non-GDG image copy dataset that would be a full copy
extid= the RC/Extract reported extract id
(0) indicates a GDG is being used.



When a Utility extract is being started and the Extract Option "Use Image Copy ==> T" , RCX generates some sample code for the user to use when the JCL is generated.

 	-- -- 	
 	-- The generated control cards contain model IMAGECOPY -- 	
 	-- cards that must be edited. The format of these cards -- 	
 	-- are: -- 	
 	-- -- 	
 	-- IMAGECOPY(nnnn-:creator.tbname) -- 	
 	-- -- 	
 	-- where nnnn is the extract id assigned to each table. -- 	
 	-- -- 	
 	-- The ":creator.tbname" should be changed to specify -- 	
 	-- the desired image copy dataset for the table. To -- 	
 	-- use a concatenation of datasets you can specify -- 	
 	-- multiple cards for the same extract id. For example: -- 	
 	-- -- 	
 	-- IMAGECOPY(0001-IMAGE.COPY.PART1(0)) -- 	
 	-- IMAGECOPY(0001-IMAGE.COPY.PART2(0)) -- 	
 	-- -- 	
 	-- Note: the above example is specifying a GDG dataset. -- 	
 	-- -- 	

These inserted comment lines provide a sample and the requirements for the manual edit so that the correct format is used. The T option does not do anything else other than to provide this template of the IMAGECOPY parm.

The user could then add in actual code like this:


These lines are added between the .DATA line and the .ENDDATA line.

Note that the normal IMAGECOPY(YES) or IMAGECOPY(NO) card is replaced by these IMAGECOPY statements that refer to specific datasets.