Skip Headers
Oracle® Application Server Adapter for Tuxedo User's Guide
10g Release 2 (10.1.2)
B15802-01
  Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
Next
Next
 

A Advanced Tuning of the Metadata

Oracle Studio enables you to define adapter interactions such as Outbound and Inbound 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.

This appendix contains the following section:

Metadata for the Back-end Adapter

Using Oracle Studio, perform the following steps to maintain the metadata for Oracle AS Adapter for Tuxedo:

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

  2. Select the computer defined in "Configuring OracleAS Adapter for Tuxedo in Oracle Studio".

  3. Expand the Bindings node.

  4. Expand the NAV node.

  5. Expand the Adapters node to display the adapters.

  6. Right-click the OracleAS Adapter for Tuxedo in the Configuration Explorer and select Edit Metadata to open 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 displayed in the following figure.

The adapter metadata General tab.
Description of the illustration md_ad1.gif

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

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 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.
maxFieldedBufferItems Sets a limit to the number of items that a fielded buffer may hold. The default value is 800.
maxFieldedBufferSize Limits the total size of a message buffer of type FML. The default is set to 2 Kbytes.
maxOutputXmlBufSize Controls the size of memory allocated for output message buffers of type XML. The default is set to 8 Kbytes.
transactionTimeout Controls the duration of a Tuxedo transaction (in seconds). If not set (or set to 0), the Tuxedo transaction will not be interrupted and will last until explicitly terminated. This is the default.

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 displayed in the following figure:

The adapter metadata Interaction tab.
Description of the illustration md_ad2.gif

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

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 following properties are available:

Input Buffer Type: The type of buffer used for the input.

Output Buffer Type: The type of the buffer to use for the results of an interaction.

No Transaction: Enables a service to be executed, regardless of transaction context.

No Reply Expected: For future use.

No Blocking Request: Avoids a FROM request submission if a blocking condition exists.

No Timeouts: Ignores blocking timeouts.


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:

The adapter metadata Schema General tab.
Description of the illustration md_ad3.gif

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

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:

The adapter metadata Schema Record tab.
Description of the illustration md_ad4.gif

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.

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

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


See Also:

Appendix B, "OracleAS Adapter for Tuxedo Message Buffer Support and Data Type Support" for details about the mapping from COBOL data types to Oracle Connect data types.


Note:

Use the Specifications box to specify field properties.

Source Tab

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

A sample Source tab is displayed in the following figure:

Description of xml_src.gif follows
Description of the illustration xml_src.gif