Configuring the example application

Edit online

The base application includes a transaction (ECFG) that you can use to configure the example application.

Before you begin

The configuration transaction uses mixed case information. You must use a terminal that can handle mixed case information correctly.

About this task

The transaction lets you specify a number of aspects of the example application. These include:
  • The overall configuration of the application, such as the use of Web services
  • The network addresses used by the Web services components of the application
  • The names of resources, such as the file used for the data store
  • The names of programs used for each component of the application
The configuration transaction lets you replace CICS®-supplied components of the example application with your own, without restarting the application.

Procedure

  1. Enter the transaction ECFG to start the configuration application.
    CICS displays the following screen:
    
CONFIGURE CICS EXAMPLE CATALOG APPLICATION                                    
                                                                              
                                                                              
           Datastore Type ==> VSAM               STUB|VSAM                    
     Outbound WebService? ==> NO                 YES|NO                       
          Catalog Manager ==> DFH0XCMN                                        
          Data Store Stub ==> DFH0XSDS                                        
          Data Store VSAM ==> DFH0XVDS                                        
      Order Dispatch Stub ==> DFH0XSOD                                        
Order Dispatch WebService ==> DFH0XWOD                                        
            Stock Manager ==> DFH0XSSM                                        
           VSAM File Name ==> EXMPCAT                                         
  Server Address and Port ==> myserver:99999                                  
  Outbound WebService URI ==> http://myserver:80/exampleApp/dispatchOrder     
                          ==>                                                 
                          ==>                                                 
                          ==>                                                 
                          ==>                                                 
                          ==>                                                 
                                                                              
                                                                              
                                                                              
                                                                              
PF              3 END                                          12 CNCL
  2. Complete the fields.
    Datastore Type
    Specify STUB if you want to use the Data Store Stub program.
    Specify VSAM if you want to use the VSAM data store program.
    Outbound WebService
    Specify YES if you want to use a remote Web service for your Order Dispatch function, that is, if you want the catalog manager program to link to the Order Dispatch Web service program.
    Specify NO if you want to use a stub program for your Order Dispatch function, that is, if you want the catalog manager program to link to the Order Dispatch Stub program.
    Catalog Manager
    Specify the name of the Catalog Manager program. The program supplied with the example application is DFH0XCMN.
    Data Store Stub
    If you specified STUB in the Datastore Type field, specify the name of the Data Store Stub program. The program supplied with the example application is DFH0XSDS.
    Data Store VSAM
    If you specified VSAM in the Datastore Type field, specify the name of the VSAM data store program. The program supplied with the example application is DFH0XVDS.
    Order Dispatch Stub
    If you specified NO in the Outbound WebService field, specify the name of the Order Dispatch Stub program. The program supplied with the example application is DFH0XSOD.
    Order Dispatch WebService
    If you specified YES in the Outbound WebService field, specify the name of the program that functions as a service requester. The program supplied with the example application is DFH0XWOD.
    Stock Manager
    Specify the name of the Stock Manager program. The program supplied with the example application is DFH0XSSM.
    VSAM File Name
    If you specified VSAM in the Datastore Type field, specify the name of the CICS FILE definition. The name used in the example application as supplied is EXMPCAT.
    Server Address and Port
    Outbound WebService URI
    If you specified YES in the Outbound WebService field, specify the location of the Web service that implements the dispatch order function. If you are using the supplied CICS endpoint set this to: http://myserver:myport/exampleApp/dispatchOrder where myserver and myport are your CICS server address and port respectively.