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:The New engine page contains three tabs:
- From the navigation toolbar, click Administration > Engine Connections.
- From the Engine Connections page, click Create new and select the engine type you want to create, either Distributed or z/OS.
- Optionally, perform the Test connection by clicking the related button.
- 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.
- 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.
- Reporting
- To enable a user to manage reports, check the Enable reporting checkbox and enter the user ID and password.
- 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:
- From the Engine Connections page, click the three-dot menu of the engine that you want to edit and click Edit.
- Browse through the Engine info, Manage sharing, and Reporting tabs to modify engine options and information.
- Click Save.
- Manage sharing
- You can manage the sharing options of an existing engine
directly from a pop-up panel. Perform the following steps:
- From the Engine Connections page, click the three-dot menu of the engine that you want to edit and click Manage sharing.
- Edit sharing options from the Share engine connection pop-up panel.
- 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.