Creating new accounts
Configure and use IBM® Power® connector, which contains information for administrators and application developers who want to exchange data with IBM Power systems.
Procedure
- In the Flow services page, click the + (Plus) icon to create a new deploy anywhere flow service.
- Select Deploy Anywhere Flow Service and click Create.
- Provide a name and description for the deploy anywhere flow service. The description is optional.
- From the list, select a Runtime on which you run a deploy anywhere flow service.
- On the flow service step, type IBM Power to select the IBM Power connector.
- In the Type to choose action box, click Add Custom Action. The Connect account page is displayed.
- Create an account that can be used to access IBM
Power Systems in the
Account page.
- Enter the name and description for the action.
- Select the runtime. The runtime on which the action or account is deployed. By default, the
selection on the Flow Editor page is considered. However, if you change the
Runtime on Add account wizard, the connection is redeployed.Note: The Runtime that is selected in the Default runtime field takes precedence during the connection redeployment.
- Click the + (Plus) icon to add an IBM Power account. You are redirected to the Add account wizard.
- Add account details in the Add account wizard.
- Connect to account IBM Power
- The name of the account by which the IBM Power system is known to IBM Power developers, clients, and partners.
- Default system user
- Use the default user for the system name specified in the System name field.
- User
- Username of the IBM Power system.
- Password
- The password of the user who is defined in the User field or the default user for the system name that is specified in the System name field.
- System name
- Hostname or IP address of the IBM Power system.
- Service type
- Type of service that represents the various ways to interact with and use an IBM
Power systems service type capability, such
as for data management, system administration, or other tasks. The specific usage and functionality
can vary depending on the context and the software or tools that are used to establish the
connections. Following are the possible values.
- COMMAND
- Runs the noninteractive Control Language (CL) commands or Report Program Generator (RPG) programs. You can run system administration and automation tasks.
- DATAQUEUE
- Runs read or write and other operations on the dataqueue of the IBM Power system. Dataqueues are used for asynchronous communication between programs on the system.
Note: Create an account with COMMAND service type if you want to use services like Call Command or Call Program, and an account with DATAQUEUE service type if you want to use services like Read DataQueue or Write DataQueue. - Current library
- Optional. Library that is used for accessing the IBM Power system resources. The library that is specified in the Current library field is available as %CONN_CURLIB% environment variable in your service.
- Socket Properties
- Any socket properties that you prefer to add for this account, which the IBM Toolbox for Java™ sets on its client-side sockets. You can select or type the property name and enter the value in the corresponding input text field.
- Property Name
- Name of the property. You can select the property from the list or use the + icon to add a property.
- Property Value
- Value for the property selected.
- Other Properties
- Any additional properties that you prefer to add for this account. You can type the property name and enter the value in the corresponding input text field.
Note: IBM Power connector for Develop Anywhere, Deploy Anywhere enabled tenants does not support SSL connections. - Click Next. The Add account > Advance Setting page is displayed.
- Configure the connection pooling manually in the Advance Setting
page.Note: Connection pooling is enabled by default.
- Enable connection pooling
- Manual - Toggle the slider to the right to enable configuration of the connection pooling details manually. The default value is manual. Disable the Manual connection pooling to use system-defined values.
- Minimum and maximum Pool Size
- Minimum and maximum connection pool size for this account. Minimum Pool Size- Number of connections to create when the connection is enabled. The system maintains the specified Minimum Pool Size of connections, irrespective of whether these connections remain idle. Maximum Pool Size - Maximum number of connections that can exist at a time in the connection pool.
- Block timeout
- Number of milliseconds that webMethods Integration waits to obtain a connection with the system before it times out and returns an error. For example, you have a pool with maximum pool size of 20. When receiving 30 simultaneous connection requests, 10 requests are queued, awaiting a connection from the pool. If you set the Block timeout value to 5000, the 10 requests wait for 5 seconds to establish a connection before they time out and return an error. If the services that use the connections require 10 seconds to complete and return connections to the pool, the pending requests encounter failure and return an error message stating the unavailability of the connections. If you set the Block timeout value too high, you might encounter problems resulting in error. If a request contains errors that delay the response, other requests are not sent. This Block timeout must be tuned along with the Maximum Pool Size setting to accommodate such bursts in processing.
- Expire timeout
- Number of milliseconds that an idle connection can remain in the pool before it is closed and removed from the pool. The connection pool removes inactive connections until the number of connections in the pool is equal to the Minimum Pool Size. The timer for an inactive connection is reset when the connection is used. If you set the Expire timeout value too high, the connection pool might accumulate numerous unused and idle connections. It not only consumes local memory but also ties up a connection on your backend resource. It might have an adverse effect if your resource has a limited number of connections. If you set the Expire timeout value too low, the performance might degrade because of the increased activity of creating and closing connections. The Expire timeout must be tuned along with the Minimum Pool Size setting to avoid excessive opening and closing of connections during processing.
- Click Next. The Add account > Synchronize page is displayed.
- Click Next. The Next button is enabled only after a successful validation. The Add account > Test and review page is displayed.
- Review the account details.
What to do next
- Click Test connection to verify the connection. A success message appears when the connectivity is successful.
- Click Enable and then click Done. You are redirected to the Add custom action page and the newly created account appears in the Connect to account list. You can use this account to run any IBM Power custom action created under the same project.