CICS VSAM Transparency for z/OS, Version 1.2


Adding a new data set to CICS VT

CICS® VT builds and displays a list of files that match the DIM name pattern you specify in the screen shown in Figure 1. When you are working with a new data set, specify a blank name pattern and the "Data set list" screen is displayed:

Figure 1. CICS VT data set list panel
 ----------------------------- CICS VT: Data set list --------------------------
 Command ===> ADD_____________________________________________ 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                      
 ---- -------- ---------- ---------- ------ ------- --------------------        
   _  ACCOUNT                                       Y                 
   _  ACCTFIL                                       Y                 
   _  ACCX001                                       Y                 
   _  ACC01                                         Y                 
   _  ACC02                                         Y                 
   _  ACC03                                         Y                 
   _  ALTNUNQ                                       Y                 
   _  AMBSRL                                        Y                 
   _  APPLCTL             MULTIRD      A      L     Y                 
   _  AWAAFES                                       Y                 
   _  AWLONGC1                                      Y                 
   _  AWMIN                                         Y                 
   _  AWMSRL                                        Y                 
   _  AWSQC                                         Y                 
   _  AWTLRC                                        Y                 
   _  AWVIDIVP                                      Y                 

You add a new file by specifying the command ADD on the command line. The following panel is displayed:

Figure 2. CICS VT add data set information panel
 --------------------- CICS VT: Add data set information ---------------------
Command ===> _________________________________________________________________
                                                                              
DIM name                         ===> VIDKSDS                                 
                                                                              
DB2 field build user exit        ===>            If selected, you must build  
                                                 all fields for the data set  
                                                 with this exit.              
                                                                              
DB2 I/R/D exit                   ===>                                         
I/R/D user exit processing order ===>           (B=Before,A=After,' '=Both)   
I/R/D user exit language         ===>           (A=Assembler,L=LE enabled)    
                                                                              
DIM ready to be generated        ===> N                                       
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
Enter=Update  PF3=Exit                                                        

The field descriptions are as follows:

Table 1. Field descriptions
Field Description
DIM name A name of 7 characters or less that is unique within CICS VT and represents the VSAM base cluster. For example, you could use the name of the DD that is used to access the base cluster in a batch program. Alternatively, you could use a variation of the CICS file control name and change a single character.
DB2® field build user exit Leave this field blank unless you are writing an FBE that builds every field in the data set. The CICS VT Data Reengineering and Customization Guide deals with exits.
DB2 I/R/D exit If you are using an IRD exit for data re-engineering, specify the name here. Otherwise leave this field blank.
I/R/D exit processing order When you use an IRD exit, you must specify whether it should be processed before, after, or both before and after the SQL update call performed by CICS VT. Leave blank unless you specify an IRD exit program.
I/R/D exit language Specify a value of A if the exit is written in assembler, or L if it is written in an LE/370 language. Leave blank unless you specify an IRD exit program.
DIM ready to be generated CICS VT does not allow you to generate a DIM unless this field is set to Y. This field value should be specified as N until you have completed the mapping for this data set.

The action codes in Figure 1 apply to data sets that have already been mapped to CICS VT. This is shown in the next screen:

Figure 3. CICS VT 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                      
 ---- -------- ---------- ---------- ------ ------- --------------------        
  _   VIDKSDS                                 N  
  _   VIDK002                                 Y                                 
  _   VIDK003                                 Y                                 
  _   VIDX001                                 Y                                 
  _   VIDX002                                 Y                                 
 ******************************* Bottom of data ********************************

Action codes are specified at a DSN or DIM level and have the following meanings:

A
Add a new data set This is the same as the ADD command.
U
Start of changeUpdate information for an existing data set.End of change The options you can update are those shown in Adding a new data set to CICS VT.
S
Select the data set for mapping.
G
Generate a DIM driver. This option is only allowed when the Ready for gen field is set to Y.
D
Delete all information from CICS VT for this data set.

Note the entry for the DIM name VIDKSDS, which was added in Adding a new data set to CICS VT earlier as a new file. The Ready for gen field for this DIM is set to N, to indicate that the mapping is not complete.





Last updated: November 9, 2012 20:42:47