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.

1. 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.
2. Modify the JCL and access method services commands.
   1. Supply a valid JOB card.
   2. 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:

      DEFINE 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) -
                )

      where hlq is a high-level qualifier of your choice.

      The following command defines the catalog file:

      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) -
             )

      where:

      • 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 is EXMPCAT.
3. Run both jobs to create and populate the data sets.
4. Use the CICS Explorer® to create a FILE definition for the catalog file.
   1. 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.
   2. 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.
   3. Select the Attributes tab and set the operations of the following attributes to Yes:
      • Add
      • Browse
      • Delete
      • Read
      • Update
   4. Use the default values for all other attributes.
5. Use the CICS Explorer to create a FILE definition for the configuration file.
   1. 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.
   2. 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.
   3. Select the Attributes tab and set the operations of the following attributes to Yes:
      • Add
      • Browse
      • Delete
      • Read
      • Update
   4. Use the default values for all other attributes.