This document describes how to use the Integration Server Wrapper.
To start the Integration Server Wrapper wizard
In the context menu of a Software AG IDL file, choose .
This starts the wizard with a list of existing Integration Server Wrapper connections.
Note:
If the selected IDL file is not valid because of a syntax error,
an error dialog comes up and the wizard does not start.
If you are using the wizard for the first time without any predefined Integration Server connections, continue with Step 2a: Create a New Integration Server Connection.
Or:
If Integration Server
Connections are already defined, or if you want to communicate with
an additional Integration Server, continue with
Step 2b: Use an Existing
Integration Server Connection.
To create a new Integration Server connection
Define the new Integration Server connection on the wizard page.
Notes:
Choose and continue with Step 3: Select the Connection Type.
To use an existing Integration Server connection
Select Choose an existing Integration Server Connection and an Integration Server connection from the list.
The selected connection is verified by a
ping command. If the response is valid, the
button is enabled, if not, an error message
is displayed.
Continue with Step 3: Select the Connection Type.
To create an additional Integration Server connection
Select Create a new Integration Server Connection and continue with Step 2a: Create a New Integration Server Connection.
The page shown for this step and the instructions given depend on the version of the EntireX Adapter inside the selected Integration Server. The following variants exist:
In this step you can either create a new Integration Server connection or update adapter services to an existing Integration Server connection.
To create a connection for EntireX Adapter 9.0 or above
Select a connection type from the drop down list.
Click and continue with Step 4a: Define Adapter Services for an RPC Connection
Or:
Step 4b: Define Adapter Services for an RPC Listener or a Reliable RPC Listener, depending on the selected connection type.
To update an existing connection for EntireX Adapter 9.0 or above
Select a connection from List of Connections.
As a result, you are informed on how many adapter services will be created, modified or left unchanged.
The update process can be characterized as follows:
For each IDL program the meta data is updated.
For each new IDL program an adapter service is created.
An adapter service that has already existed before the update is updated if it is contained in the IDL file for the update.
A connection remains unchanged with respect to its type and settings (broker ID, server address, user ID, etc.).
Click Finish.
A connection is created with IDL programs A and B. Later, the update operation uses IDL programs A and C. After the update, the service for A is modified, the service for B is unchanged, and the service for C is new.
To select a connection type forEntireX Adapter 8.2 or below
Select a Connection type from the list of available types.
Notes:
IN parameters only. If the selected IDL file contains OUT parameters, the connection types for Reliable RPC are not available.
Click and continue with Step 4a: Define Adapter Services for an RPC Connection
Or:
Step 4b: Define Adapter Services for an RPC Listener or a Reliable RPC Listener, depending on the selected connection type.
To create a connection and related adapter services:
Select a package for the created objects.
Define a folder name. If the folder does not exist, it will be created.
Define a connection name.
Define the parameters of the connection type. See the EntireX Adapter for Integration Server documentation at http://documentation.softwareag.com/webmethods/entirex_adapter.htm for details about these parameters.
As a result, the folder will contain the connection and the adapter services (one for each IDL program). The name of a service is the same as the respective IDL program.
The default settings for new RPC adapter services are:
the Default package; if not available, the first package
the IDL library name for the Folder Name
the IDL library name with the suffix "Connection" for the Connection Name
Notes:
WmEntireX) with the version currently used.
To create an RPC Listener or a Reliable RPC Listener
Select a package for the created objects.
Define a folder name. If the folder does not exist, it will be created.
Define a connection name.
Define a listener name.
As a result, the following objects will be created:
one connection of type "RPC Listener" or "Reliable RPC Listener"
one listener object
and in addition for Reliable RPC Listener:
one notification object for each RPC program
one trigger object for each RPC program
one document type object for each RPC program
The default settings for this page are:
the Default package; if not available, the first package
the IDL library name for the Folder Name
the IDL library name with the suffix "Connection" for the Connection Name
the IDL library name with the suffix "Listener" for the Listener Name
in the table that maps RPC Program Name to IS service Name, the IS service must already be defined. Modification is not recommended.
the Broker ID from the IDL file properties; if there are no properties available, the values from the general Software AG IDL preferences are used
the Server Address from the IDL file properties; if there are no properties available, the values from the general Software AG IDL preferences are used
Notes:
WmEntireX) with the version currently used.
To finish the Wizard
Choose .
As a result, the folder contains multiple objects as listed under the corresponding step.
Note:
See Mapping Software AG IDL
to Integration Server Data Types.