A
The Oracle Connect IMS/TM Interaction Metadata Definitions

Oracle Studio includes a wizard to help define the adapter inbound and outbound interactions and input and output structures used for these interactions. The interactions and input and output structures are maintained as metadata in the Metadata perspective of Oracle Studio.

This appendix contains the following sections:

• Interaction Metadata for the Adapter

Interaction Metadata for the Adapter

Use Oracle Studio to maintain the metadata for the IMS/TM adapter.

1. On the machine where Oracle Studio is installed, from the Start menu, choose Start > Programs > Oracle > Studio > Studio.

2. Select the machine defined in "Configuring Oracle Connect for IMS/TM".

3. Click the + next to the Bindings node.

4. Click the + next to the NAV binding node.

5. Click the + next to the Adapters node to display the adapters.

6. Right-click the IMS/TM adapter in the Configuration Explorer and choose Edit Metadata to open the Metadata perspective.

7. Right-click the adapter in the Metadata Explorer and choose Edit definition.

The metadata editor opens, displaying the General tab, with general table details. The following tabs are used to edit the metadata:

• General Tab

• Interaction Tab

• Schema General Tab

• Schema Record Tab

The following tab provides an XML representation of the metadata:

• Source Tab

General Tab

Use the General tab to maintain information generally describing the adapter and the connection to it.

Text description of the illustration md_ad1.gif

The General tab has the following fields:

Adapter definition name - The name of the adapter definition.

Description - An identifying description of the adapter.

Version - The adapter version.

Vendor - The vendor which the adapter came from.

Authentication mechanism - The authentication to access the adapter. The available mechanisms are:

• kerbv5

• none

• basic-password

Max request size - The maximum size in bytes for an XML request or reply. Larger messages are rejected with an error.

Max active connections - The maximum number of simultaneous connections for an adapter (per process).

Max idle timeout - The maximum time, in seconds, that an active connection can stay idle. After that time, the connection is closed.

Adapter Specifications - Adapter-specific properties.

Interaction Tab

Use the Interaction tab to define the general details of the interaction in addition to its input and output definitions.

Text description of the illustration md_ad2.gif

The Interaction tab has the following fields:

Interaction name - The name of the interaction.

Description - A descriptive identifier for the interaction.

Mode - The interaction mode:

• sync-send-receive - The outbound interaction sends a request and expects to receive a response.

• sync-send - The outbound interaction sends a request and does not expect to receive a response.

• sync-receive - The outbound interaction expects to receive a response.

• async-send - The inbound interaction sends a request and does not expect to receive a response.

Input record - Identifies an input record.

Output record - Identifies an output record for the results of an outbound interaction.

Interaction Specific Parameters - Defines the property and value of parameters specific to the interaction. For each interaction you must specify the following property:

transaction - The name of the transaction that is executed for the interaction.

Schema General Tab

Use the Schema General tab to define the general details of the input and output record structures for the interaction.

Text description of the illustration md_ad3.gif

The Schema General tab has the following fields:

Schema name - The name of the adapter.

Version - The schema version.

Header - A C header, file to map between the data structure and the adapter.

Schema Record Tab

Use the Schema Record tab to define the input and output record structures for the interaction.

Text description of the illustration md_ad4.gif

The Schema Record tab has the following fields:

The Fields List defines single data items within a record.

Name - The name of the field.

Type - The datatype of the field. The following are valid datatypes:

Binary

Boolean

Byte

Date

Double

Enum

Float

Int

Long

Numeric[(p[,s])]

Short

String

Time

Timestamp

See Also: Appendix B, "Datatype Support" for details about the mapping from COBOL datatypes to Oracle Connect for IMS/TM datatypes

Length - The size of the field including a null terminator, when the datatype supports null termination (such as the cstring datatype).

Use the Specifications box to specify field properties.

Source Tab

The Source tab displays the XML representation of the adapter metadata.