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.


dfhxa_t310.html | Timestamp icon Last updated: Monday, 5 June 2017