Creating and defining the VSAM data sets
Two KSDS VSAM data sets are used to define and populate the example application. One data set contains configuration information for the example application. The other contains the sales catalog.
Procedure
- Locate the JCL to create the VSAM data sets. During CICS® installation, the JCL is placed in the hlq.SDFHINST library:
- Member DFH$ECNF contains the JCL to generate the configuration data set.
- Member DFH$ECAT contains the JCL to generate the catalog data set.
- Modify the JCL and access method services commands.
- Supply a valid JOB card.
- Supply a suitable high-level qualifier for the data
set names in the access method services commands. As supplied, the JCL uses a high-level qualifier of
HLQ
.The following command defines the configuration file:
whereDEFINE CLUSTER (NAME(hlq.EXMPLAPP.EXMPCONF)- TRK(1 1) - KEYS(9 0) - RECORDSIZE(350,350) - SHAREOPTIONS(2 3) - INDEXED - ) - DATA (NAME(hlq.EXMPLAPP.EXMPCONF.DATA) - ) - INDEX (NAME(hlq.EXMPLAPP.EXMPCONF.INDEX) - )
hlq
is a high-level qualifier of your choice.The following command defines the catalog file:
where:DEFINE CLUSTER (NAME(hlq.EXMPLAPP.catname)- TRK(1 1) - KEYS(4 0) - RECORDSIZE(80,80) - SHAREOPTIONS(2 3) - INDEXED - ) - DATA (NAME(hlq.EXMPLAPP.catname.DATA) - ) - INDEX (NAME(hlq.EXMPLAPP.catname.INDEX) - )
hlq
is a high-level qualifier of your choice-
catname
is a name of your choice. The name used in the example application as supplied isEXMPCAT
.
- Run both jobs to create and populate the data sets.
- Use the CICS Explorer® to create a FILE definition for the catalog file.
-
Select Definitions > File Definitions. Right-click in the Name column and click
New to create a new file definition. Type
EXAMPLE in the Resource Group text box, and
type EXMPCAT in the Name text box. Click
Finish to define the FILE definition.
Alternatively, you can copy the file definition from the CICS supplied group DFH$EXBS.
- Double-click the new EXMPCAT file. In the File Definition (EXMPCAT) CICS Example Application editor, select the VSAM tab. Type hlq.EXMPLAPP.EXMPCAT in the Data set name to be used text box.
- Select the Attributes tab and
set the operations of the following attributes to Yes:
- Add
- Browse
- Delete
- Read
- Update
- Use the default values for all other attributes.
-
Select Definitions > File Definitions. Right-click in the Name column and click
New to create a new file definition. Type
EXAMPLE in the Resource Group text box, and
type EXMPCAT in the Name text box. Click
Finish to define the FILE definition.
- Use the CICS
Explorer to create a FILE definition for the configuration file.
-
Select Definitions > File Definitions. Right-click in the Name column and click
New to create a new file definition. Type
EXAMPLE in the Resource Group text box, and
type EXMPCONF in the Name text box. Click
Finish to define the FILE definition.
Alternatively, you can copy the file definition from the CICS supplied group DFH$EXBS.
- Double-click the new EXMPCONF file. In the File Definition (EXMPCONF) CICS Example Application window, select the VSAM tab. Type hlq.EXMPLAPP.EXMPCONF in the Data set name to be used text box.
- Select the Attributes tab and
set the operations of the following attributes to Yes:
- Add
- Browse
- Delete
- Read
- Update
- Use the default values for all other attributes.
-
Select Definitions > File Definitions. Right-click in the Name column and click
New to create a new file definition. Type
EXAMPLE in the Resource Group text box, and
type EXMPCONF in the Name text box. Click
Finish to define the FILE definition.
Results
The data sets are populated, and the FILE definitions for the catalog file and the configuration file have been created and are ready to install.