Create New Service Interface

  1. The Service Project Editor: Definition tab for the CATLG Service will display. In the Program field, enter Program name DK1API01.
  2. Select the Create Service Interface button in the Define Request and Response Service Interfaces section The Create Service Interface window will display.

    Create Service Interface button is in the middle of the image. An arrow displays over the Create Service Interface button.

    Figure 256. Create Service Interface Button
  3. In the Service Interface Name enter CATLG Select the OK button. The Create Service Interface window window will close. A new tab for CATLG will display in the Service Interface Editor.

    Create Service Interface window. the Service interface name is CATLG. An arrow displays over the OK button

    Figure 257. Create Service Interface window
  4. Right-click to select the Container1 > Edit Container. The Edit Container window will display.

    CATLG Edit Container displays Container 1 with a menu that displays import data structure and Edit container. An arrow displays over the Edit Container option.

    Figure 258. CATLG Edit Container
  5. Enter DK1APIC1-Con in the Container name field. Select the OK button. The Edit Container window will close.

    Edit Container Window displays the Container name is changed to DK1APIC1-Con. An arrow hovers over the OK button.

    Figure 259. Edit Container Window
  6. In the Service Interface Editor, right-click to select DK1APIC1-Con > Import Data Structure. The Import Window will display.

    Import data structure menu option displays on the DK1APIC1-Con.

    Figure 260. Import data structure
  7. In the Import Window
    1. The Import from field is automatically populated with z/OS system.
    2. The File type field is COBOL data structures only.
    3. Select the Source PDS.

      The Source PDS is shown as an import from z/OS System and a COBOL data structures with the Source PDS listed.

      Figure 261. Import Window
    4. Select the Browse button. The Import Application Data Structure Source window displays.
      1. Enter the Data Set Name or pattern.
      2. Expand the Data Set Name to display the copybooks.
      3. Select the CATLG copybook.

        Import Application Data Structure Source window displays the HLQ and the matching datasets. CATLG is selected

        Figure 262. Import Application Data Structure Source window
      4. Select the Finish button. The Import window will be populated with the Data Structure member and the Data Structure name.

        Import Window populated shows the Data structure member in the source PDS. The data structure name is associated with the WS_ROW_AREA.

        Figure 263. Import Window populated
      5. Select the OK button. The Import window will close.
  8. On the Service Interface Editor, expand DK1APIC1-Con to display the whole copybook. The WS_ROW_HEADER shows the RESTConnector specific information for the copybook. The WS_ROW_DATA is the related table data.

    DK1APIC1-Con expanded shows the entire copybook. The WS_ROW_HEADER shows the fields specific to the API and the WS_ROW_DATA shows the related table.

    Figure 264. DK1APIC1-Con Expanded