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:
----------------------------- 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:
--------------------- 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:
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:
----------------------------- 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:
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.