Creating and managing engine connections

You can create engine connections from the Dynamic Workload Console.

About this task

Administration roles can create, modify, or delete engine connections.

Creating a new engine
To create an engine connection, perform the following steps:
  1. From the navigation toolbar, click Administration > Engine Connections.
  2. From the Engine Connections page, click Create new and select the engine type you want to create, either Distributed or z/OS.
  3. Optionally, perform the Test connection by clicking the related button.
The New engine page contains three tabs:
  • Engine info
  • Manage sharing
  • Reporting
Engine info
From the Engine info tab in the New engine page, you can define engine information within the available fields, and also choose whether to enable the Self-Service Catalog or Self-Service Dashboards on the new engine by checking the related checkboxes.
Optionally, you can check the status of the engine connection by clicking Test connection.
Manage sharing
From the Manage sharing tab, you can manage sharing options. When checking Enable sharing checkbox, two options are available:
  • Share with everyone: By selecting this option, any user and group can access the engine.
  • Only selected users: By selecting this option, the selected users and group can access the engine. Use the drop-down menu to select who can access the engine.
After having defined who can access the engine, you can check the Share credentials checkbox to share also the user ID and password with the selected users and groups.
Reporting
To enable a user to manage reports, check the Enable reporting checkbox and enter the user ID and password.
After having defined necessary information within the tabs, click Save at the bottom of the New engine page.
Managing existing engines
You can edit, delete, or modify sharing options of existing engines.
Note: You can modify or delete only engine connections that you have created.
A search bar is available to quickly find a specific engine. To check engine information, click the dropdown arrow within the engine card.
Edit
To edit an engine, perform the following steps:
  1. From the Engine Connections page, click the three-dot menu of the engine that you want to edit and click Edit.
  2. Browse through the Engine info, Manage sharing, and Reporting tabs to modify engine options and information.
  3. Click Save.
Manage sharing
You can manage the sharing options of an existing engine directly from a pop-up panel. Perform the following steps:
  1. From the Engine Connections page, click the three-dot menu of the engine that you want to edit and click Manage sharing.
  2. Edit sharing options from the Share engine connection pop-up panel.
  3. Click Save.
Test connection
You can check the status of an existing engine from the Engine Connections page by clicking the three-dot menu of the engine that you want to edit and selecting Test connection.
Delete
You can delete an existing engine from the Engine Connections page by clicking the three-dot menu of the engine that you want to edit and selecting Delete.

Troubleshooting: Generic z/OS connection failure

If the Test Connection action fails with a generic error for a z/OS engine, verify the backend configuration.

Cause: A mismatch in the configuration file often results in a generic failure message rather than a specific port error.

Remedy:

  • Ensure that the portNumber specified in the connectionFactory.xml file matches the actual listener port of the z/OS engine.