Gathering mapping information

You can use a batch utility to collect information about one or more VSAM data sets and write it to the CICS® VT control tables. The member VIDAUTOJ in VID.SVIDSAMP is sample JCL for this utility, and is shown in Figure 1.

Figure 1. Sample JCL for VIDAUTOJ utility
//AUTOMAP  EXEC PGM=VIDMAPIN                             
Start of change //STEPLIB  DD  DSN=VID.SVIDLODE,DISP=SHR  End of change      
//         DD  DSN=DB2.SDSNLOAD,DISP=SHR                 
//SYSIN    DD  UNIT=VIO,SPACE=(CYL,(1,1))                
//SYSPRINT DD  UNIT=VIO,SPACE=(CYL,(1,1))
//SYSOUT   DD  SYSOUT=*                                                  
//REPORT   DD  SYSOUT=*                                  
//CATIN    DD  *   
VIDKSD1 VID.KSDS01
VIDKSD2 VID.KSDS02
VIDKSD3 VID.KSDS03 

The input to this utility is shown after the CATIN DD statement. The first parameter is the DIM name you select for this data set, and the second parameter is the name of the base cluster. The first parameter must start at position 1, and the second parameter must start at position 9. You can change the UNIT=VIO parameter for the DD statements SYSIN and SYSPRINT to UNIT=SYSDA or equivalent if VIO is not defined on your system.

Alternatively, you can use the ISPF dialogs to gather mapping information for a single data set using the ADD command shown in Selecting the DIM to be processed. There is an auto-mapping entry for a DIM called DUMDIM, which is added during the installation of CICS VT. This can be deleted after you have added a new DIM.

CICS VT calculates the size of the DB2® table and index objects from the primary and secondary space allocation information stored in the base cluster. If you gather mapping information using a test version of the data set cluster, you might have to manually update the tablespace and indexspace space parameters when you convert the production version of the data set.

The batch utility can be rerun if required, in which case previously gathered information for this DIM is deleted. Using the ISPF dialogs, if you attempt to analyze an already analyzed DIM, an error message is issued and no data is updated. If you need to reanalyze a data set, use the ISPF option F in the Auto mapping list panel first.


Information Information

Feedback


Timestamp icon Last updated: Monday, 10 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic/com.ibm.cics.vt.doc//topics/cvtug_gather_mapinfo.html