Generating the DIM

Driver modules are generated by batch utilities. There are two stages in the generation process. You initiate the driver generation process by selecting option 2 from the CICS® VT "Data set list" panel, shown in Figure 1:

Figure 1. Data set list panel
                          
 ----------------------------- CICS VT: Data set list ---------------------Row 1 of 5
 Command ===> ________________________________________________ Scroll ===> CSR_
                                                                                
 Commands:      ADD   - Add data set information   ALL      – Generate all                              
                                                                                  
 Action codes:  A     - Add data set information                                  
                U     - Update data set information                                  
                S     - Data set mapping information                                 
                G     - Generate CICS VT data set modules (DIM and DDM)                        
                D     - Delete data set information from CICS VT                       

 Press: Enter to continue   PF3 to exit   PF1 for help
                                                                                
 Actn                                I/R/D  Ready                               
 code DIM name Build exit I/R/D exit order  for gen Status                      
 ---- -------- ---------- ---------- ------ ------- --------------------        
  G   VIDKSDS                                 N
  _   VIDK002                                 Y                                 
  _   VIDK003                                 Y                                 
  _   VIDX001                                 Y                                 
  G   VIDX002                                 Y                                 
 ******************************* Bottom of data ******************************** 

Specify G in the Actn code for the DIM you want to generate. CICS VT will only allow you to select a DIM for generation if the Ready for gen field has the value Y. If this value is N, specify a value of U in the Actn code field, then specify a value of Y in the DIM Ready to be generated field of the "Update data set information" panel, shown in Figure 2.

Figure 2. Update data set information panel
 
  ---------------------- CICS VT: Update data set information ---------------------
 Command ===> __________________________________________________________________
                                                                                
 DIM name                         ===> VIDKSDS                                 
                                                                                
 Field build user exit            ===> ________   If selected, you must build   
                                                  all fields for the dataset    
                                                  with the specified exit.        
                                                                                
 I/R/D user exit name             ===>                                   
 I/R/D user exit processing order ===>           (B=Before,A=After,' '=Both)    
                                                                                
 DIM ready to be generated        ===> Y                                        
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 Enter=Update  PF3=Exit

You can generate drivers for more than one data set or alternate index at the same time.

When you have made your selection, CICS VT redisplays this panel showing the DIMs that you have selected. Press Enter to continue and the job submit panel is presented, as shown in Figure 3.

Figure 3. Generate DIM and DDM job submit panel
  
------------------------ CICS VT: Generate drivers ------------------------------
 Command ===> __________________________________________________________________
                                                                                
                                                                                
 DB2 owner for driver bind    ===> DBADM___                                     
                                                                                
 No of concurrent threads     ===> 01         01-99   PF1 for more information  
                                                                                
 Automatically submit stage 2 ===> Y                                            
                                                                                
 SUBMIT or EDIT generated JCL ===> SUBMIT                                       
                                                                                
 Generated JCL data set name  ===> _____________________________________________
 Start of change (If not specified then data set ‘prefix.VID.ISPFILE' will be allocated) End of change 
                                                                                
 Verify job card statement:                                                          
 ===> //VIDJOB JOB (ACCT,PGMer-name),CLASS=L,MSGCLASS=X,NOTIFY=&SYSUID__ <===  
 ===> //WHERESMY JCLLIB ORDER=my.SVIDCNFG.custom_________________________ <===  
 ===> ___________________________________________________________________ <===  
 ===> ___________________________________________________________________ <===  
                                                                                
                                                                                
 Press: Enter to continue   PF3 to exit   PF1 for Help                          

The field descriptions in this panel are as follows:

Field Description
DB2® owner for driver bind The value of the OWNER parameter for the DB2 package and plan bind. This overrides the default value in Figure 1.
No of concurrent threads The maximum number of concurrent threads per user for this data set. This overrides the default value in Figure 1.
Automatically submit stage 2 There are two separate jobs to generate CICS VT drivers, referred to as generation stage 1 and generation stage 2. If you specify a value of Y for the Automatically submit stage 2 option, the second job is automatically submitted. A value of N means that you have to submit it manually. See Driver generation stage 2 for more information.
SUBMIT or EDIT generated JCL Specify SUBMIT to submit the stage 1 generation job automatically. If you specify EDIT you can review or edit the generated JCL, in which case you must manually submit the job for processing. The SUBMIT and EDIT commands can be abbreviated to S and E.
Generated JCL data set name Specify a sequential data set where the JCL will be created. This is a temporary data set that will be created if it doesn't exist. Your TSO profile prefix is used as the high-level qualifier for the temporary data set. If you don't use a TSO profile prefix, the value you specified for the field Assign HLQ of CICS VT data sets generated in Figure 1 is used.
Verify job card statement The job card that is used for the generation jobs.

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_gen_dim.html