Create a New API Project

Using the Service Archive (.sar) file for the service: create, export and deploy the API Project.

Instructions to create a new z/OS API Project can be found on IBM’s website at Invoke CICS Catalog Manager Services

  1. Select File > New > z/OS Connect EE API Project. The New Project window will display.
  2. In the New Project window enter the following information:
    1. The Project name is CATLGAPI.
    2. the API Name will populate with catlgapi. It is an editable field.
    3. The Base Path will populate with /catlgapi. It is an editable field.
    4. Enter an optional description.
    5. Select the Finish button. The New Project window will close and the API Editor will display.

      New API Project window shows the project name, API name and Base Path name described in the instructions

      Figure 268. New API Project
  3. In the API Editor, remove the POST, PUT, and DELETE methods by selecting the box with a red X to the right of the Method. GET should be the only remaining Method.

    Four Methods before removal shows the POST, GET, PUT, and DELETE methods. There is an arrow selecting the Remove the POST Method button which is a red X.

    Figure 269. API Editor with Four Methods before removal
  4. In the Path field, change the path name to /items/{itemsID}

    Path equals itemsID and the GET Method is the only method that remains.

    Figure 270. Path equals itemsID
  5. In the Project Explorer panel, right-click to select the CATLG > z/OS Connect EE > Export z/OS Connect EE Service Archive. The Export Service Package window displays.

    Export Service Package window displays the File Name CATLG. The workspace button is selected.

    Figure 271. Export Service Package Window
  6. Select the Browse button. The Select Workspace Folder window will display.
    1. Select CATLGAPI.

      Select a Workspace Folder displays all the available workspaces. CATLG and CATLGAPI display. CATLGAPI is selected.

      Figure 272. Select a Workspace Folder
    2. Select the OK Button. The Select Workspace Window will close. The Export Service Package window displays the Folder is mapped to /CATLGAPI.

      CATLGAPI Export Service Package window shows the /CATLGAPI folder is selected and associated to the CATLG.sar file.

      Figure 273. CATLGAPI Export Service Package window
    3. Select the OK button. The Export Service Package window closes. The CATLG.sar file is ready to be exported.