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

Question:

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
and
IMAGECOPY(extID-image.copy.dataset(0))                  Extracting from a image copy on a GDG
and
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.

 

Answer:

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.

 	.ALLOC FI(PTIMSG) SYSOUT(A) 	
 	------------------------------------------------------------- 	
 	-- -- 	
 	-- 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. -- 	
 	-- -- 	
 	------------------------------------------------------------- 	
 	.CALL EXTRACT 

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:

 IMAGECOPY(0001-TSDUMP.RCX1.TS1.SYSCP101.FULLCOPY)       
 IMAGECOPY(0002-TSDUMP.RCX1.TS2.SYSCP101.COPY(0)) 
 IMAGECOPY(0003-TSDUMP.RCX1.TS3.SYSCP101.COPY(0))
 IMAGECOPY(0004-TSDUMP.RCX1.TS4.SYSCP101.COPY.PART19)

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.