Configuring the example application

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

You can 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
With the configuration transaction, you can 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
    If you are using the CICS web service client, specify the IP address and port of the system on which the example application is deployed as a web service.
    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 the Outbound WebService to: http://myserver:myport/exampleApp/dispatchOrder where myserver and myport are your CICS server address and port.