Skip Headers
Oracle® Application Server Adapter for IMS/TM User's Guide
10g Release 3 (10.1.3.1.0)

Part Number B31003-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

A Advanced Tuning of the Metadata

Oracle Studio enables you to define outbound adapter interactions. In addition, Oracle Studio defines input and output structures used for these interactions. The interactions and input and output structures are maintained as metadata in the Metadata tab of Oracle Studio.

Metadata for the Back-end Adapter

Using Oracle Studio, perform the following steps to maintain the metadata for OracleAS Adapter for IMS/TM.

  1. From the Start menu, select Programs, Oracle, and then select Studio.

  2. Expnad the node of the required computer in the Configuration Explorer.

  3. Expand the Bindings node.

  4. Expand the NAV binding node.

  5. Expand the Adapters node to display the adapters.

  6. Right-click the IMS/TM adapter in and select Edit Metadata to display the Metadata tab.

  7. Right-click the required interaction in the Metadata Explorer, and select Edit.

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

General Tab

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

The General tab is shown in the following figure:

Figure A-1 The General tab

The General tab.
Description of "Figure A-1 The General tab"

The General tab comprises fields, as listed in the following table:

Table A-1 General tab Components

Field Description

Adapter definition name

Specifies the name of the adapter definition.

Description

Specifies an identifying description of the adapter.

Authentication mechanism

Specifies the authentication method used to access the adapter. The available mechanisms are:

kerbv5

none

basic password

Max request size

Specifies the maximum size in bytes for an XML request or reply. Larger messages are rejected with an error.

Max active connections

Specifies the maximum number of simultaneous connections for an adapter (per process).

Max idle timeout

Specifies the maximum time, in seconds, that an active connection can stay idle. After that time, the connection is closed.

Adapter Specifications

Specifies the adapter-specific properties for an interaction. The IMS/TM back-end adapter does not have any 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.

The Interactions tab is shown in the following figure:

Figure A-2 The Interactions tab

The adapter metadata Interaction tab.
Description of "Figure A-2 The Interactions tab"

The Interaction tab comprises fields, as listed in the following table:

Table A-2 Interaction tab Components

Field Description

Interaction name

Specifies the name of the interaction.

Description

Provides a descriptive identifier for the interaction.

Mode

Determines the interaction mode. The following interaction modes are available:

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

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

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

  • async-send: Not applicable

Input record

Identifies an input record.

Output record

Identifies an output record for the results of an interaction.

Interaction Specific Parameters

Defines the properties and values of parameters specific to an interaction. The transaction property is available, which specifies the IMS/TM transaction that is called when the interaction is executed.


Schema General Tab

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

The Schema General tab is shown in the following figure:

Figure A-3 The Schema General tab

The image shows Schema General tab.
Description of "Figure A-3 The Schema General tab"

The Schema General tab comprises fields, as listed in the following table:

Table A-3 Schema General tab Components

Field Description

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.

The Schema Record tab is shown in the following figure:

Figure A-4 The Schema Record tab

The adapter metadata Schema Record tab.
Description of "Figure A-4 The Schema Record tab"

The Schema Record tab comprises fields, as listed in the following table:

Use the Fields List area to define single data items within a record.

Table A-4 Schema Record tab Components

Field Description

Name

Specifies the name of the field.

Type

The data type of the field. The following are valid data types:

  • Binary

  • Boolean

  • Date

  • Double

  • Float

  • Int

  • Long

  • Numeric

  • Short

  • String

  • Time

  • Timestamp

  • XML

See Also: Appendix B, "Back-end Adapter Data Type Support" for details about the mapping from COBOL data types to IMS/TM back-end adapter data types.

Length

The size of the field including a null terminator, when the data type supports null termination.


Note:

Use the Specifications box to specify field properties.

See Also:

Appendix B, "Back-end Adapter Data Type Support" for details about the mapping from COBOL data types to Oracle Connect data types.

Source Tab

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

A sample Source tab is displayed in the following figure:

Figure A-5 The Source tab

A sample XML as shown in the Source tab
Description of "Figure A-5 The Source tab"