Defining the 3270 interface

The example application is supplied with a 3270 user interface to run the application and to customize it. The user interface consists of two transactions, EGUI and ECFG. Start of changeA third transaction, ECLI, is used for the CICS Web service client.End of change

  1. Use the CEDA transaction to create TRANSACTION definitions for the transactions.
    1. To define transaction EGUI, enter the following: CEDA DEF TRANS(EGUI) G(EXAMPLE) PROG(DFH0XGUI).
    2. To define transaction ECFG, enter the following: CEDA DEF TRANS(ECFG) G(EXAMPLE) PROG(DFH0XCFG)
    3. Start of changeOptional: To define transaction ECLI, enter the following: CEDA DEF TRANS(ECLI) G(EXAMPLE) PROG(DFH0XCUI)End of change
    Use the default values for all other attributes.
    Note: The correct operation of the example application does not depend on the names of the transactions, so you can use different names if you wish.
    Alternatively, you can copy the TRANSACTION definitions for EGUI and ECFG from CICS® supplied group DFH$EXBS, and the definition for ECLI from group DFH$EXWS.
  2. Start of changeOptional: If you do not wish to use program autoinstall, use the CEDA transaction to create PROGRAM definitions for the base application programs and MAPSET definitions for the BMS maps.
    1. Define MAPSET resource definitions for the BMS maps in members DFH0XS1, DFH0XS2, and DFH0XS3. For details of what is in each member, see Components of the base application.
    2. Define PROGRAM resource definitions, using the command CEDA DEF PROG(program) G(EXAMPLE). You should create definitions for the following COBOL programs:
      Start of change
      Table 1. SDFHSAMP members containing COBOL source for the base application.
      Member name Description
      DFH0XCFG Program invoked by transaction ECFG to read and update the VSAM configuration file
      DFH0XCMN Controller program for the catalog application. All requests pass through it.
      DFH0XGUI Program invoked by transaction EGUI to manage the sending of the BMS maps to the terminal user and the receiving of the maps from the terminal user. It links to program DFH0XCMN.
      DFH0XODE One of two versions of the endpoint for the order dispatch Web service. This is the version that runs in CICS. It simply sets the text "Order in dispatch" in the return COMMAREA.
      DFH0XSDS A stubbed or dummy version of the data store program that allows the application to work when the VSAM catalog file has not been set up. It uses data defined in the program rather than data stored in a VSAM file.
      DFH0XSOD A stubbed version of the order dispatch program. It sets the return code in the COMMAREA to 0 and returns to its caller. It is used when outbound Web services are not required.
      DFH0XSSM A stubbed version of the stock manager (replenishment) program. It sets the return code in the COMMAREA to 0 and returns to its caller.
      DFH0XVDS The VSAM version of the data store program. It accesses the VSAM file to perform reads and updates of the catalog.
      DFH0XWOD The Web service version of the order dispatch program. It issues an EXEC CICS INVOKE WEBSERVICE to make an outbound Web service call to an order dispatcher
      End of change
      Use the default values for all other attributes.
    3. Start of changeOptional: To define COBOL program DFH0XCUI, enter the following: CEDA DEF PROG(DFH0XCUI) G(EXAMPLE). Use the default values for all other attributes. This program is required if you want to use transaction ECLI that starts the Web service client.End of change
    End of change