Version 9.6
 —  EntireX Adapter Installation and User's Guide  —

EntireX Adapter Services

This document describes how to configure and manage EntireX Adapter services. EntireX Adapter services allow clients to interact with EntireX RPC servers, Natural RPC servers, ACI servers, ApplinX, IMS Connect, and CICS ECI using a configured adapter connection. EntireX Adapter services are available for synchronous and asynchronous RPC calls (RPC and reliable RPC).

The following topics are covered:


Before Configuring or Managing Adapter Services

Start of instruction setTo prepare configuration and management of EntireX Adapter services

  1. Start your Integration Server and the IS Administration Console, if they are not already running.

  2. Make sure you have webMethods administrator privileges so that you can access the EntireX Adapter's administrative screens. See the Administering webMethods Integration Server for information on setting user privileges.

  3. Using the IS Administration Console, make sure the WmEntireX package is enabled. See Enabling and Disabling Packages for instructions.

  4. Start the Designer if it is not already running.

  5. Make sure you are viewing the Designer in the Service Development perspective, as described in Switching Perspectives in the Designer help.

  6. Using the Designer, create a user-defined package to contain the service, if you have not already done so. Add a dependency on WmEntireX package (version *.*) to your user-defined package. When you configure adapter services, you should always define them in user-defined packages rather than in the WmEntireX package. For more information on managing packages for the adapter, see Package Management.

  7. Generate the adapter connection with the EntireX Workbench.

    Or:
    Using the IS Administration Console, configure an adapter connection to use with the adapter service. See Configuring Adapter Connections for instructions.

Top of page

Configuring Adapter Services

The EntireX Adapter service enables you to send RPC calls to an EntireX RPC server or Natural RPC server. You configure EntireX Adapter services using a specific adapter connection. After you follow the steps in this section to configure the adapter service, you can invoke it from a flow or Java service. To use EntireX Adapter services, you provide values for the service's input signature in the pipeline. For more information on using EntireX Adapter services, see Using Adapter Services.

Start of instruction setTo create EntireX Adapter services

  1. In the EntireX Workbench, select the Software AG IDL file to use.

  2. In the context menu, choose Generate webMethods IS Connection from Software AG IDL....

Top of page

Using Adapter Services

Start of instruction setTo enable the EntireX Adapter service to send an RPC call to an EntireX RPC server

Top of page

Viewing Adapter Services

Use the Designer to view adapter services. Make sure you are viewing the Designer in the Service Development perspective, as described in Switching Perspectives in the Designer online help.

Start of instruction setTo view a service

  1. In the Designer Package Navigator view, expand the package and folder that contain the service you want to view.

  2. Select the service you want to view. The Designer displays the service in the Service Editor.

    As a result, the Adapter Service Editor for the EntireX Adapter service appears.

    Notes:

    1. You can select the Adapter Settings tab at any time to confirm adapter service properties such as the Adapter Name, Adapter Connection Name, and Adapter Service Template, as necessary.
    2. On the RPC Call tab, the EntireX Subprogram Name field holds the name of the IDL program called by this service. The tables Input Parameter and Output Parameter display names, the IDL types, and the parameter types in the pipeline.
    3. The Input/Output tab shows the service's input and output signatures. To use the EntireX Adapter service, you provide values for the signature input within the service pipeline in the Designer. See Using Adapter Services for instructions on using the EntireX Adapter service.
    4. For information on configuring the Input/Output and Adapter Settings tabs, see webMethods Service Development Help. These tabs apply to all services that you configure using the Designer. The information on Audit and Permissions appears in the Properties panel. For the results, see the Results panel.

Top of page

Deleting Adapter Services

Use the Designer to delete adapter services. Make sure you are viewing the Designer in the Service Development perspective, as described in Switching Perspectives in the Designer online help.

Start of instruction setTo delete a service

  1. In the Designer Package Navigator view, expand the package and folder that contain the service you want to delete.

  2. Right-click the service and then click Delete.

Top of page

Runtime Connection Allocation for Adapter Services

Adapter services of the EntireX Adapter are enabled for dynamically selecting a connection node. The connection name may be specified on the pipeline in the $connectionName field. This field has to be part of the services input signature. If $connectionName is not specified, the default connection name is used, usually the connection used to create the service.

See chapter 8 in webMethods Adapter Development Kit User's Guide , version 6.5 for more details on connection selection.

Connection selection is applicable to services that are generated with the EntireX Adapter (version 8.0 or higher) and helps to:

Top of page

Configure the Formatting of Decimal and Alphanumeric Parameters

Adapter services have two parameters to configure the formatting of decimal parameters (IDL data types N, NU, P and PU, and alphanumeric parameters of fixed length (IDL data types A, K, and U).

To set these options, use the Designer and open the adapter service for the EntireX Adapter. In RPC Call, select Parameters for Decimal Numbers (N/P) or Parameters for fixed length Strings (A/K/U).

The following tables give an overview of parameters to be configured:

Top of page

Configuring Null Value Suppression

Null value suppression (NVS) allows you to suppress parameters with no specified value. Suppressed parameters will not appear in the result of the adapter service call.

Null value suppression is available for the following IDL data types:

To activate NVS in the context of adapter services, you need to modify each adapter service seperately using Designer. For each adapter service, select Null Value Suppression in RPC Call.

To fine tune NVS, the following suppression modes can be selected:

Suppression Mode for Parameters Explanation
No suppression (default) No suppression, all parameters are present in the output structure.
Suppress null elements String parameters with empty strings are suppressed, empty structures and arrays are suppressed.
Suppress null elements and trim array cells at end Same as above. In addition, all empty array elements at the end of the array will be removed from the array.
Suppress null elements and trim array cells at end containing null elements and zero numbers Same as above. In addition, numbers of numeric/decimal type (I1, I2, I4, N, P) with the value zero are treated as an empty value.

A string parameter is suppressed if the assigned string is:

Top of page