Creating configurable services

Use the web user interface or a command to create a configurable service that defines properties for an external service on which the integration node relies.

About this task

You can create a configurable service on your integration node, by using the web user interface or commands. You must provide a name for your configurable service that does not duplicate the name of an existing configurable service or IBM® predefined configurable service template. The name cannot start with a digit.

To create a configurable service by using the command line or a script, use the mqsicreateconfigurableservice command and include the following parameters:
  • Specify -c to identify the configurable service type.
  • Specify -o to identify the name of the configurable service.
  • Specify -n to identify the properties of the service where you want to override default values.
  • Specify -v to identify the values of the properties that you want to configure.
For example, to create an ActivityLog configurable service that is named MyActivityLog on an integration node that is named IBNODE, and change the number of log files from 4 (default) to 5, type the following command:
mqsicreateconfigurableservice IBNODE -c ActivityLog -o MyActivityLog -n numberOfLogs -v 5
To add a new configurable service by using the web user interface, complete the following steps.
Note: Not all configurable service types are available to select within the web user interface. If you want to create a configurable service and the type is not listed, you must create an instance of that type of configurable service by using the mqsicreateconfigurableservice command.

Procedure

  1. Start the web user interface for your integration node; see Accessing the web user interface.
    The navigator is displayed on the left side of the pane, showing the servers (integration servers), message flows, and other resources that are owned by your integration node.
  2. Expand the Operational Policy section in the navigator.
  3. Click the down arrow beside Configurable Services to display the menu, and then click Create.
  4. Enter a name for your configurable service.
    Note: If you are creating a JDBCProvider configurable service, consider the following requirements when you choose a name for the configurable service:
    • If you want to use your JDBCProvider configurable service with a JavaCompute node, or with a Java™ user-defined node, the name of your JDBCProvider configurable service must match the datasourceName parameter in the getJDBCType4Connection() call from the message node.
    • If you want to use your JDBCProvider configurable service with a Mapping node, the name of your JDBCProvider configurable service must match the database name that is used by the database transforms in your Graphical Data Map. For each database transform, the database name is determined by the database definition (.dbm file) in the Data Design project that was used to create the map.
    • If you want to use your JDBCProvider configurable service with a DatabaseRetrieve node, or with a DatabaseRoute node, the name of your JDBCProvider configurable service must match the value of the Data source name property of the message node.
  5. Select the type of configurable service to create and, select the template to use for your configurable service.
    Every configurable service type (except for User-Defined) has at least one template. If you have already created configurable services of the selected configurable service type, these configurable services are also available to select as the template.
    When you select a template, a number of properties are displayed with default values.
  6. Optional: If you are creating a UserDefined configurable service, no properties are displayed. Click Add to add the properties that you require. You can double-click the property names to edit the names.
  7. Enter values for the configurable service properties by using one of the following methods:
    • Double-click in the Value column next to the property that you want to change, and add or edit the value.
    • Click the More icon icon next to each property that you want to change, add or edit the value, and click OK.
    For information about the properties that are associated with each configurable service, see Configurable services properties.
  8. Optional: Expand the Associated Command section below the property table to see the command (that you can use from the command line or in a script) that creates the configurable service with the property values that you configured.
  9. Click Save to create the configurable service.

Results

The configurable service that you created is listed in the navigator and categorized by the configurable service type.
Note: By default, the list of configurable services includes the IBM predefined configurable service templates. You can hide the IBM predefined templates by clicking the Filter Options link at the top of the navigator, and then deselecting the Show IBM predefined templates check box.

What to do next

For most types of configurable service, your changes will take effect from the next time a message flow that uses the configurable service is called. For some types of configurable service (where it is stated in the documentation for the configurable service type) you must stop and start the integration server for the change to take effect.