Creating a z/OS Asset

How to create z/OS Asset in z/OS Connect Designer.

Ensure that z/OS Connect Designer is running as described in Starting the z/OS Connect Designer and importing an OpenAPI definition and that the flow diagram for your API is displayed.

A z/OS Asset describes a specific resource on a z/OS application, like Db2®, IBM® MQ, CICS®, or IMS and the methods that z/OS Connect must use to access that resource.

You can add a z/OS Asset in the z/OS Connect Designer with one of the following methods,
  • Click next to z/OS Assets in the navigation tree to start the Add z/OS Asset wizard.
  • Expand Paths and click the operation that you want to add a z/OS Asset to. For example, employees{ID}/GET. In the Operation Viewer, click to start the z/OS Asset wizard.
Choose one of these methods to display the Operation flow diagram in the Operation Viewer as seen in Figure 1.
Figure 1. Operation flow diagram to add a z/OS Asset
Operation flow diagram to add a z/OS Asset
  1. Click Add new z/OS Asset then Next.
    If you started the Add z/OS Assets wizard by using the Paths route, you can also use an existing asset. For this procedure, use the Add new z/OS Asset option.
    Figure 2. Selecting a new or existing z/OS Asset.
  2. Click Choose an option.
    Figure 3. Selecting the type of z/OS Asset.
  3. Expand the list and click Db2 native REST service followed by Next.
    Other z/OS Asset types will be available in the future.
    Figure 4. Selecting the type of z/OS Asset (continued).
  4. Click Choose an option.
    Figure 5. Selecting the Db2 connection.
  5. Select the Db2 connection that you need from the list.
    For example, db2Conn.
    When you select the connection, the screen populates with the configuration fields for that connection. These configuration details can be added by either importing from the Db2 service manager or manually adding the details. In this example, use the Import from Db2 service manager option.
    Figure 6. Configuring the Db2 connection.
    Import from Db2 service manager
    1. Select the Service Name you require from the table.
      Note, if you see numerous service names to select from, you can filter the search by typing the name of the service you want in the Filter Table search field . You can also read through the table pages by using the page numbers and by clicking the arrows
      Figure 7. Importing the Db2 connection native REST service.
      Click by the selected service to view the Request and Response structures that are defined for the Db2 service selected.
      Figure 8. Viewing the Request and Response structures.
    2. With the Db2 service name selected, click Import.
      The z/OS Asset Db2 service manager details are displayed.
      Figure 9. The completed configuration the Db2 connection.
    3. Click Next.
      The new z/OS Asset name and description can be modified at the stage.
      Figure 10. Saving the z/OS Asset configuration.
    4. Click Add z/OS Asset.
      The z/OS Asset wizard closes. You see in the Operation flow diagram the z/OS Asset is created and displayed on the main canvas.
      Figure 11. The z/OS Asset configured in the Operation flow diagram.
  6. View your newly created z/OS Asset.
    The new z/OS Asset is visible in z/OS Assets. The node to the right of z/OS Assets has increased by 1. Expand the to view your z/OS Asset details.
    Figure 12 illustrates the result of following this procedure.
    Figure 12. Add z/OS Asset procedure is successful