Adapter Services

Overview

The following sections describe how to configure adapter services that you use to access the business methods exposed on the EJBs.

Note: You cannot configure Adapter for EJB services that invoke more than a single bean method.

You can configure the following types of services for use with Adapter for EJB:

CreateEJB 2.1. See Configuring CreateEJB 2.1 Services.
InvokeEJB 2.1. See Configuring InvokeEJB 2.1 Services.
CreateInvokeEJB 2.1. See Configuring CreateInvokeEJB 2.1 Services.
FetchEJB 3.0. See Configuring FetchEJB 3.0 Services.
InvokeEJB 3.0. See Configuring InvokeEJB 3.0 Services.
FetchInvokeEJB 3.0. See Configuring FetchInvokeEJB 3.0 Services.
Note: The 2.1 services, namely, CreateEJB 2.1, InvokeEJB 2.1, and CreateInvokeEJB 2.1 are used with EJB 2.1 or earlier versions. All the 3.0 services, namely, FetchEJB 3.0, InvokeEJB 3.0, and FetchInvokeEJB 3.0 are used only with EJB 3.0.

For a description of the adapter services, see Adapter Services. For information about using adapter services you create in a flow service, see Creating Flows for Adapter for EJB Services.

Before Configuring or Managing Adapter Services

About this task

To prepare to configure or manage an Adapter for EJB service

Procedure

Start your Integration Server and Integration Server Administrator, if they are not already running.
If your adapter services work with the EJB 3.0 standard, ensure that you have specified the 3.0 EJBs that will be accessed by your 3.0 adapter services in the config.xml file. For information about how to specify this information, see Configuring Adapter for EJB for Adapter Services.
Make sure you have webMethods administrator privileges so that you can access Adapter for EJB administrative screens. For information about setting user privileges, see the IBM webMethods Integration Server Administrator’s Guide for your release.
Using Integration Server Administrator, make sure the WmEJBAdapter package is enabled. For instructions, see Enabling Packages.
Using Integration Server Administrator:
1. Configure the adapter connection you plan to use with the adapter service. For instructions, see Configuring Adapter Connections.
2. Make sure the connection you plan to use with the adapter service is enabled. For instructions, see Enabling Adapter Connections.
Using Designer, create a user-defined package to contain the service, if you have not already done so. When you configure adapter services, you should always define them in user-defined packages rather than in the WmEJBAdapter package. For more information about managing packages for the adapter, see Adapter Package Management.

Configuring CreateEJB 2.1 Services

About this task

A CreateEJB 2.1 adapter service invokes a specific EJB creator or finder method on the EJB's remote home interface. For more information about the template used to create these services, see CreateEJB 2.1 Adapter Service. For more information about adapter services, see Adapter Services.

To configure a CreateEJB 2.1 adapter service

Procedure

Review the steps in Before Configuring or Managing Adapter Services.
Start Designer.

Note: Make sure the server with which you want to use Designer is running.
Right-click the package in which the service should be contained and select New > Adapter Service.
Select the parent namespace and type a name for the adapter service. Click Next.
Select IBM webMethods Adapter for EJB from the list of available adapter types. Click Next.
Select the appropriate Adapter Connection Name and click Next.
From the list of available templates, select the CreateEJB 2.1 template and click Finish.

The service is created and its parameters and controls are displayed in the adapter service editor.

In the editor, select the CreateEJB 2.1 tab and specify the following values:

Parameter	Description/Action
EJB Lookup Name	Lists the JNDI lookup names of all available EJBs on the application server. The name you select here determines the values that will appear in the EJB Create Method and Return Type parameters. At runtime, the service uses this name to look up the EJBHome object. The EJBs are listed alphabetically. By default, the first EJB in the list is initially selected.
EJB Create Method	Lists the available creator/finder methods for the selected EJB lookup name. The method selected will be executed by the service. The methods exposed by the EJB are listed alphabetically. By default, the first method in this list is initially selected. If the method has parameters, they appear in the parameter list. For each parameter, the default parameter name and the corresponding Java class type are shown in the first two columns of the parameter list. You may override a parameter's default name by entering a new name in the Override Parameter Name column. The value that appears in this column for a parameter is the value that appears in the configured method's input signature at runtime. If the method takes no parameters, the parameter list is empty.
Return Type	Lists the remote EJB method's Java return type for the selected EJB lookup name. This value is read-only.

Note: The EJB lookup name and EJB create method are displayed by default. If the lookup name and method have input parameters, the parameters are not displayed in the service's input signature until you reload the adapter values. Save the adapter service if you want to use the default values. If you change the lookup name or the create method, the values are automatically refreshed and the parameters appear in the adapter service editor. For more information about reloading adapter values, see Reloading Adapter Values.

You can select the Adapter Settings tab at any time to confirm adapter properties such as adapter type, connection name, and service template, as needed.
The Input/Output tab lists the input and output parameters, if any, for the method. If the create method has parameters, their names and types appear under the EJBHome_Args document. If this service is later used in a flow, its input and output signatures will be visible in the flow editor.

For additional information about using the Input/Output tab, see the IBM webMethods Service Development Help for your release.
Select File > Save.
To test the service directly from Designer, see Testing Adapter Services.

Configuring InvokeEJB 2.1 Services

About this task

An InvokeEJB 2.1 adapter service invokes one or more methods on a single remote EJB reference. For more information about the template used to create these services, see InvokeEJB 2.1 Adapter Service. For more information about adapter services, see Adapter Services.

To configure an InvokeEJB 2.1 service

Procedure

Review the steps in Before Configuring or Managing Adapter Services.
Start Designer.

Note: Make sure the server with which you want to use Designer is running.
Right-click the package in which the service should be contained and select New > Adapter Service.
Select the parent namespace and type a name for the adapter service. Click Next.
Select IBM webMethods Adapter for EJB from the list of available adapter types. Click Next.
Select the appropriate Adapter Connection Name and click Next.
From the list of available templates, select the InvokeEJB 2.1 template and click Finish.

The service is created and its parameters and controls are displayed in the adapter service editor.

In the editor, select the InvokeEJB 2.1 tab and specify the following values:

Parameter	Description/Action
EJB Lookup Name	Lists the JNDI lookup names of all available EJBs on the application server. The name you select here determines the values that will appear in the EJB Remote Method and Return Type parameters. At runtime, the service uses this name to match against a given EJB Handle object. The EJBs are listed alphabetically. By default, the first EJB in the list is initially selected.
EJB Remote Method	Lists the available remote methods for the selected EJB. The method selected will be executed by the service. The methods exposed by the EJB are listed alphabetically. By default, the first method in this list is initially selected. If the method has parameters, they appear in the parameter list. For each parameter, the default parameter name and the corresponding Java class type are shown in the first two columns of the parameter list. You may override a parameter's default name by entering a new name in the Override Parameter Name column. The value that appears in this column for a parameter is the value that appears in the configured method's input signature at runtime. If the method takes no parameters, the parameter list is empty.
Return Type	Lists the remote EJB method's Java return type for the selected EJB lookup name. This value is read-only.
Expand Collections?	Allows you to specify the format of the output of the remote method. When selected, only the elements in the collection are returned as output. When cleared, the collection itself is returned as output. By default, this option is selected.
Allow Null Return Value?	Allows Adapter for EJB to return a null value when the EJB method has a non-void return type. When selected, Adapter for EJB does not throw any exception if the EJB method returns a null value, and returns an object array with no elements in it. When cleared, Adapter for EJB throws an exception if the EJB method returns a null value. By default, this option is cleared.

Note: The EJB lookup name and EJB remote method are displayed by default. If the lookup name and method have input parameters, the parameters are not displayed in the service's input signature until you reload the adapter values. Save the adapter service if you want to use the default values. If you change the lookup name or the remote method, the values are automatically refreshed and the parameters appear in the adapter service editor. For more information about reloading adapter values, see Reloading Adapter Values.

You can select the Adapter Settings tab at any time to confirm adapter properties such as adapter type, connection name, and service template, as needed.
The Input/Output tab lists the input and output parameters, if any, for the method. If the remote method has parameters, their names and types will appear in the input signature under the EJBObject_Args document. If the service is subsequently used in a flow, its input and output signatures will be visible in the flow editor.

For additional information about using the Input/Output tab, see the IBM webMethods Service Development Help for your release.
Select File > Save.
To test the service directly from Designer, you must first include the InvokeEJB 2.1 service in a flow service. In the flow service you must map the output of a CreateEJB 2.1 adapter service (the remote EJBs it created) to the input of the InvokeEJB 2.1 adapter service. You cannot run an InvokeEJB 2.1 adapter service as a standalone service. For more information about testing an adapter service, see Testing Adapter Services.

Configuring CreateInvokeEJB 2.1 Services

About this task

A CreateInvokeEJB 2.1 adapter service combines the functionality of a CreateEJB 2.1 service and an InvokeEJB 2.1 service, enabling you to create one or more instances of a single EJB class and then invoke a single method on those instances. Additionally, a CreateInvokeEJB 2.1 service automatically calls the EJB-standard remove() method to release each session EJB instance. For more information about the template used to create these services, see CreateInvokeEJB 2.1 Adapter Service. For more information about adapter services, see Adapter Services. For more information about the RemoveEJB service, see Removing EJBs.

To configure a CreateInvokeEJB 2.1 service

Procedure

Review the section Before Configuring or Managing Adapter Services.
Start Designer.

Note: Make sure the server with which you want to use Designer is running.
Right-click the package in which the service should be contained and select New > Adapter Service.
Select the parent namespace and type a name for the adapter service. Click Next.
Select IBM webMethods Adapter for EJB from the list of available adapter types. Click Next.
Select the appropriate Adapter Connection Name and click Next.
From the list of available templates, select the CreateInvokeEJB 2.1 template and click Finish.

The service is created and its parameters and controls are displayed in the adapter service editor.

In the editor, select the CreateInvokeEJB 2.1 tab and specify the following values:

Parameter	Description/Action
EJB Lookup Name	Lists the JNDI lookup names of all available EJBs on the application server. The name you select here determines the values that will appear in the EJB Create Method and Return Type parameters, and also in the EJB Remote Method value on the Method to Invoke tab. The EJBs are listed alphabetically. By default, the first EJB in the list is initially selected.
EJB Create Method	Lists the available creator/finder methods for the selected EJB lookup name. The method selected will be executed by the service. The methods exposed by the EJB are listed alphabetically. By default, the first method in this list is initially selected. If the method has parameters, they appear in the parameter list. For each parameter, the default parameter name and the corresponding Java class type are shown in the first two columns of the parameter list. You may override a parameter's default name by entering a new name in the Override Parameter Name column. The value that appears in this column for a parameter is the value that appears in the configured method's input signature at runtime. If the method takes no parameters, the parameter list is empty.
Return Type	Lists the remote EJB method's Java return type for the selected EJB lookup name. This value is read-only.

Note: The EJB lookup name and EJB create method are displayed by default. If the lookup name and method have input parameters, the parameters are not displayed in the service's input signature until you reload the adapter values. Save the adapter service if you want to use the default values. If you change the lookup name or the create method, the values are automatically refreshed and the parameters appear in the adapter service editor. For more information about reloading adapter values, see Reloading Adapter Values.

Select the Method to Invoke tab and specify the following values:

Parameter	Description/Action
EJB Remote Method	Lists the available remote methods for the selected EJB. The method selected will be executed by the service. The methods exposed by the EJB are listed alphabetically. By default, the first method in this list is initially selected. If the method has parameters, they appear in the parameter list. For each parameter, the default parameter name and the corresponding Java class type are shown in the first two columns of the parameter list. You may override a parameter's default name by entering a new name in the Override Parameter Name column. The value that appears in this column for a parameter is the value that appears in the configured method's input signature at runtime. If the method takes no parameters, the parameter list is empty.
Return Type	Lists the remote EJB method's Java return type for the selected EJB lookup name. This value is read-only.
Expand Collections?	Allows you to specify the format of the output of the remote method. When selected, only the elements in the collection are returned as output. When cleared, the collection itself is returned as output. By default, this option is selected.
Allow Null Return Value?	Allows Adapter for EJB to return a null value when the EJB method has a non-void return type. When selected, Adapter for EJB does not throw any exception if the EJB method returns a null value, and returns an object array with no elements in it. When cleared, Adapter for EJB throws an exception if the EJB method returns a null value. By default, this option is cleared.

Note: The EJB lookup name and EJB remote method are displayed by default. If the lookup name and method have input parameters, the parameters are not displayed in the service's input signature until you reload the adapter values. Save the adapter service if you want to use the default values. If you change the lookup name or the remote method, the values are automatically refreshed and the parameters appear in the adapter service editor. For more information about reloading adapter values, see Reloading Adapter Values.

You can select the Adapter Settings tab at any time to confirm adapter properties such as adapter type, connection name, and service template, as needed.
The Input/Output tab lists the input and output parameters for methods. If the create method has parameters, their names and types appear under the EJBHome_Args document. Similarly, if the bean method has parameters, their names and types appear under the EJBObject_Args document. If the service is subsequently used in a flow, its input and output signature will be visible in the flow editor.

For additional information about using the Input/Output tab, see the IBM webMethods Service Development Help for your release.
Select File > Save.
To test the service directly from Designer, see Testing Adapter Services.

Configuring FetchEJB 3.0 Services

About this task

A FetchEJB 3.0 adapter service invokes a specific EJB finder method on the EJB's remote interface. For more information about the template used to create these services, see FetchEJB 3.0 Adapter Service. For more information about adapter services, see Adapter Services. For more information about the RemoveEJB service, see Removing EJBs.

To configure a FetchEJB 3.0 adapter service

Procedure

Review the section Before Configuring or Managing Adapter Services.
Start Designer.

Note: Make sure the server with which you want to use Designer is running.
Right-click the package in which the service should be contained and select New > Adapter Service.
Select the parent namespace and type a name for the adapter service. Click Next.
Select IBM webMethods Adapter for EJB as the adapter type and click Next.
Select the appropriate Adapter Connection Name and click Next.
From the list of available templates, select the FetchEJB 3.0 template and click Finish.

The service is created and its parameters and controls are displayed in the adapter service editor.

In the editor, select the FetchEJB 3.0 tab and specify the following values:

Parameter	Description/Action
EJB Lookup Name	Lists the JNDI lookup names of all available 3.0 EJBs on the application server. The selected JNDI name determines the EJB to be fetched. At runtime, the service uses this name to look up the EJBRemote object. The EJBs are listed alphabetically. By default, the first EJB in the list is initially selected.

You can select the Adapter Settings tab at any time to confirm adapter properties such as adapter type, connection name, and service template, as needed.
The Input/Output tab lists the input and output parameters, if any, for the method. If the create method has parameters, their names and types appear under the EJBObject_Args document. If this service is later used in a flow, its input and output signatures will be visible in the flow editor.

For additional information about using the Input/Output tab, see the IBM webMethods Service Development Help for your release.
Click File > Save.
To test the service directly from Designer, see Testing Adapter Services.

Configuring InvokeEJB 3.0 Services

About this task

An InvokeEJB 3.0 adapter service invokes one or more methods on a single remote EJB reference. For more information about the template used to create these services, see InvokeEJB 3.0 Adapter Service. For more information about adapter services, see Adapter Services. For more information about the RemoveEJB service, see Removing EJBs.

To configure an InvokeEJB 3.0 service

Procedure

Review the steps in Before Configuring or Managing Adapter Services.
Start Designer.

Note: Make sure the server with which you want to use Designer is running.
Right-click the package in which the service should be contained and select New > Adapter Service.
Select the parent namespace and type a name for the adapter service. Click Next.
Select IBM webMethods Adapter for EJB as the adapter type and click Next.
Select the appropriate Adapter Connection Name and click Next.
From the list of available templates, select the InvokeEJB 3.0 template and click Finish.

In the adapter service editor, select the InvokeEJB 3.0 tab and specify the following values:

Parameter	Description/Action
EJB Lookup Name	Lists the JNDI lookup names of all available EJBs on the application server. The name you select here determines the values that will appear in the EJB Remote Method and Return Type parameters. At runtime, the service uses this name to match against a given EJB Handle object. The EJBs are listed alphabetically. By default, the first EJB in the list is initially selected.
EJB Remote Method	Lists the available remote methods for the selected EJB. The method selected will be executed by the service. The methods exposed by the EJB are listed alphabetically. By default, the first method in this list is initially selected. If the method has parameters, they appear in the parameter list. For each parameter, the default parameter name and the corresponding Java class type are shown in the first two columns of the parameter list. You may override a parameter's default name by entering a new name in the Override Parameter Name column. The value that appears in this column for a parameter is the value that appears in the configured method's input signature at runtime. If the method takes no parameters, the parameter list is empty.
Return Type	Lists the remote EJB method's Java return type for the selected EJB lookup name. This value is read-only.
Expand Collections?	Allows you to specify the format of the output of the remote method. When selected, only the elements in the collection are returned as output. When cleared, the collection itself is returned as output. By default, this option is selected.
Allow Null Return Value?	Allows Adapter for EJB to return a null value when the EJB method has a non-void return type. When selected, Adapter for EJB does not throw any exception if the EJB method returns a null value, and returns an object array with no elements in it. When cleared, Adapter for EJB throws an exception if the EJB method returns a null value. By default, this option is cleared.

Note: The EJB lookup name and EJB remote method are displayed by default. If the lookup name and method have input parameters, the parameters are not displayed in the service's input signature until you reload the adapter values. Save the adapter service if you want to use the default values. If you change the lookup name or the remote method, the values are automatically refreshed and the parameters appear in the adapter service editor. For more information about reloading adapter values, see Reloading Adapter Values.

You can select the Adapter Settings tab at any time to confirm adapter properties such as adapter type, connection name, and service template, as needed.
The Input/Output tab lists the input and output parameters, if any, for the method. If the remote method has parameters, their names and types will appear in the input signature under the EJBObject_Args document. If the service is subsequently used in a flow, its input and output signatures will be visible in the flow editor.

For additional information about using the Input/Output tab, see the IBM webMethods Service Development Help for your release.
Select File > Save.
To test the service directly from Designer, you must first include the InvokeEJB 3.0 service in a flow service. In the flow service you must map the output of a FetchEJB 3.0 adapter service (the remote EJBs it created) to the input of the InvokeEJB 3.0 adapter service. You cannot run an InvokeEJB 3.0 adapter service as a standalone service. For more information about testing an adapter service, see Testing Adapter Services.

Configuring FetchInvokeEJB 3.0 Services

About this task

A FetchInvokeEJB 3.0 adapter service combines the functionality of a FetchEJB 3.0 service and an InvokeEJB 3.0 service, enabling you to create one or more instances of a single EJB class and then invoke a single method on those instances. Additionally, a FetchEJB 3.0 service automatically calls the EJB-standard remove() method to release each session EJB instance. For more information about the template used to create these services, see FetchInvokeEJB 3.0 Adapter Service. For more information about adapter services, see Adapter Services. For more information about the RemoveEJB service, see Removing EJBs.

To configure a FetchInvokeEJB 3.0 service

Procedure

Review the steps in Before Configuring or Managing Adapter Services.
Start Designer.

Note: Make sure the server with which you want to use Designer is running.
Right-click the package in which the service should be contained and select New > Adapter Service.
Select the parent namespace and type a name for the adapter service. Click Next.
Select IBM webMethods Adapter for EJB as the adapter type and click Next.
Select the appropriate Adapter Connection Name and click Next.
From the list of available templates, select the FetchInvokeEJB 3.0 template and click Finish.

In the adapter service editor, select the FetchInvokeEJB 3.0 tab and specify the following values:

Parameter	Description/Action
EJB Lookup Name	Lists the JNDI lookup names of all available 3.0 EJBs on the application server. The selected JNDI name determines the EJB to be fetched. At runtime, the service uses this name to look up the EJBRemote object. The EJBs are listed alphabetically. By default, the first EJB in the list is initially selected.
EJB Remote Method	Lists the available finder method for the selected EJB lookup name. The method selected will be executed by the service. The methods exposed by the EJB are listed alphabetically. By default, the first method in this list is initially selected. If the method has parameters, they appear in the parameter list. For each parameter, the default parameter name and the corresponding Java class type are shown in the first two columns of the parameter list. You may override a parameter's default name by entering a new name in the Override Parameter Name column. The value that appears in this column for a parameter is the value that appears in the configured method's input signature at runtime. If the method takes no parameters, the parameter list is empty.
Return Type	Lists the remote EJB method's Java return type for the selected EJB lookup name. This value is read-only.
Expand Collections?	Allows you to specify the format of the output of the remote method. When selected, only the elements in the collection are returned as output. When cleared, the collection itself is returned as output. By default, this option is selected.
Allow Null Return Value?	Allows Adapter for EJB to return a null value when the EJB method has a non-void return type. When selected, Adapter for EJB does not throw any exception if the EJB method returns a null value, and returns an object array with no elements in it. When cleared, Adapter for EJB throws an exception if the EJB method returns a null value. By default, this option is cleared.

You can select the Adapter Settings tab at any time to confirm adapter properties such as adapter type, connection name, and service template, as needed.
The Input/Output tab lists the input and output parameters for methods. If the fetch method has parameters, their names and types appear under the EJBObject_Args document. Similarly, if the bean method has parameters, their names and types appear under the EJBObject_Args document. If the service is subsequently used in a flow, its input and output signature will be visible in the flow editor.

For additional information about using the Input/Output tab, see the IBM webMethods Service Development Help for your release.
Select File > Save.
To test the service directly from Designer, see Testing Adapter Services.

Removing EJBs

Adapter for EJB also provides a non-configurable built-in service, RemoveEJB. The RemoveEJB service is packaged with Adapter for EJB and is available in the adapter's public namespace at pub.ejbadapter.removeEJB.

Note: The RemoveEJB service is used for EJB 2.1 or earlier services only, that is for CreateEJB 2.1, InvokeEJB 2.1, and CreateInvokeEJB 2.1. For 3.0 services, as there is no home interface, the bean is automatically released by the application server.

RemoveEJB is a generic non-configurable service that takes an EJB Handle as its only parameter and invokes the EJB-standard remove() method on the EJB object represented by that handle. If successful, RemoveEJB produces no output whatsoever. If it fails, it throws an AdapterServiceException.

To control the remote EJB's life-cycle, call the RemoveEJB service from a flow service to inform the application server that a particular EJB is no longer being used by the client. This is most important when dealing with stateful or entity EJBs.

Calling the RemoveEJB service on an EJB has slightly different consequences depending upon the type of that EJB:

For stateful session EJBs, its effect is to signal the end of the session to the application server.
For entity EJBs, the RemoveEJB service causes the underlying entity to be removed from the EJB container. For example, CreateEJB 2.1 is used to create a new entity EJB, which may result in the application server creating a new row in a table to hold that EJB's state. Subsequently passing the Handle of that EJB to the RemoveEJB service causes the application server to delete that row from the table.
For stateless session EJBs, it has no effect in the client. RemoveEJB simply notifies the application server that it is no longer using the EJB so that the server may, at its discretion, perform any housekeeping tasks.

The application server determines how and when the tasks above occur. If the client invokes the RemoveEJB service against an entity EJB, the client should consider that EJB to be deleted even if the application server does not actually delete the EJB at that point in time.

Testing Adapter Services

About this task

You use Designer to test adapter services. For information about testing and debugging services, see the IBM webMethods Service Development Help for your release.

To test an adapter service

Procedure

Review the steps in Before Configuring or Managing Adapter Services.
In Designer, expand the package and folder that contain the service you want to test.
Double-click the service you want to test.

Designer displays the configured service in the service template's Adapter Service Editor.
Select Run > Run As > Run Service.
For every service input field, you will be prompted to enter an input value. Enter a value for each input field and then click OK.
Click the Results tab to view the output from this service.

Note: Credentials you provide in the username and password fields override any connection.

Note: Specifying the $connectionName input parameter changes the connection for this execution of the service. To reconfigure the service to use a different connection, use the setAdapterServiceNodeConnection, which is located in the WmART package's pub.art.service folder. For more information about this service, see the IBM webMethods Integration Server Built-In Services Reference for your release.

Viewing Adapter Services

About this task

You use Designer to view adapter services.

To view an adapter service

Procedure

Review the steps in Before Configuring or Managing Adapter Services.
In Designer, expand the package and folder that contain the service you want to view.
Double click the service you want to view.

Designer displays the configured service in the service template's Adapter Service Editor.

Editing Adapter Services

About this task

You use Designer to edit adapter services.

To edit an adapter service

Procedure

In Designer, browse to and open the adapter service that you want to edit.
Double-click the service that you want to edit.

Designer displays the adapter service in the service template's Adapter Service Editor.
Do one of the following:
- If you have the VCS Integration feature enabled, right-click the service and select Check Out.
- If you do not have the VCS Integration feature enabled, right-click the service and select Lock for Edit.
- If you are using the local service development feature, from the Team menu in Designer, select the appropriate option to check out the service. The options available in the Team menu depend on the VCS client that you use.
Modify the values for the adapter service's parameters as needed. For detailed descriptions of the service's parameters, see the section on configuring a service for the specific type of service you want to edit.
After you complete your modifications, save the service and do one of the following:
- If you have the VCS Integration feature enabled, right-click the service and select Check In. Enter a check-in comment and click OK.
- If you do not have the VCS Integration feature enabled, right-click the service and select Unlock.
- If you are using the local service development feature, from the Team menu in Designer, select the appropriate option to check in the service. The options available in the Team menu depend on the VCS client that you use.
Save the service.

Deleting Adapter Services

About this task

You use Designer to delete adapter services.

To delete an adapter service

Procedure

Review the steps in Before Configuring or Managing Adapter Services.
In Designer, expand the package and folder that contain the service you want to delete.
Right-click the service and click Delete.

Validating Adapter Service Values

About this task

Designer enables Adapter for EJB to validate user-defined data for adapter services at design time. You can validate the values for a single adapter service or you can configure Designer to always validate the values for adapter services. Both options could potentially slow your design-time operations.

When you enable data validation for a single adapter service, Designer compares the service values against the resource data that has already been fetched from the selected adapter.

If you select the option to always validate values for adapter services, it will do so for all webMethods 6.x adapters installed on Integration Server.

For more information about the Adapter Service/Notification Editorand other Designer menu options and toolbar icons, see the IBM webMethods Service Development Help for your release.

Enabling Automatic Data Validation for a Single Adapter Service

About this task

To enable automatic data validation for a single adapter service

Procedure

Review the steps in Before Configuring or Managing Adapter Services.
In Designer, expand the package and folder that contain the service for which you want to enable automatic validation.
Double-click the service for which you want to validate the data.

Designer displays the configured adapter service in the service template's Adapter Service Editor.
Click the icon.

Validating Adapter Service Values for all Adapter Services

About this task

To validate adapter service values for all adapter services

Procedure

Review the steps in Before Configuring or Managing Adapter Services.
Start Designer.
Select the Window > Preferences >IBM> Service Development > Adapter Service/Notification Editor item.
Enable the Automatic data validation option.
Click OK.

Reloading Adapter Values

Designer enables Adapter for EJB to reload and validate user-defined data for adapter services at design time. You can reload values for a single adapter service or you can configure Designer so it automatically reloads the values for adapter services. Both options could potentially slow your design-time operations.

When you reload adapter values for a single adapter service, Designer compares the service values against the resource data that has already been fetched from the selected adapter.

If you select the option to always reload values for adapter services, it will do so for all webMethods 6.x adapters installed on Integration Server.

For more information about the Adapter Service/Notification Editor, other menu options, and toolbar icons, see the IBM webMethods Service Development Help for your release.

Reloading Adapter Values for a Single Adapter Service

About this task

To reload the adapter values for a single adapter service

Procedure

Review the steps in Before Configuring or Managing Adapter Services.
In Designer, expand the package and folder that contain the service for which you want to enable automatic validation.
Double-click the service for which you want to validate the data.

Designer displays the configured adapter service in the service template's Adapter Service Editor.
Click the icon.

Reloading Adapter Values for all Adapter Services

About this task

To reload the adapter values for all adapter services

Procedure

Review the steps in Before Configuring or Managing Adapter Services.
Start Designer.
Select the Window > Preferences > IBM > Service Development > Adapter Service/Notification Editor item.
Enable the Automatic polling of adapter metadata option.
Click OK.