Creating and Configuring Tuxedo CORBA Resources

The Oracle Tuxedo system core administrative resources consists of both ATMI and CORBA domains and their associated resources. The CORBA interface queues and CORBA factories are used in Oracle Tuxedo client and server applications. The Oracle Administration Console enables the system administrator to manage the Oracle Tuxedo CORBA resources for configuration and run-time administration.

Note:

For detailed instructions on creating and configuring core Oracle Tuxedo ATMI administrative resources, refer to Chapter 4, “Creating and Configuring Core Administrative Resources.”

The following sections define the fields for the Create New Object window and Configuration Tool tab pages when creating or configuring Oracle Tuxedo CORBA resources:

•	CORBA Interfaces (T_INTERFACE)

•	Creating a New CORBA Interface

•	Configuring a CORBA Interface (T_INTERFACE)

•	CORBA Interface Queues (T_IFQUEUE)

Viewing a CORBA Interface Queue Configuration (IF_QUEUE)

•	CORBA Factories (T_FACTORY)

Viewing a CORBA Factory Configuration

 

CORBA Interfaces (T_INTERFACE)

A CORBA Interface represents a contract with a client. Interfaces are advertised by Oracle Tuxedo server applications at startup. The Oracle Tuxedo T_INTERFACE MIB represents configuration and run-time attributes of CORBA interfaces at both the domain and server group levels. Using the Oracle Tuxedo Administration Console applet, you can perform the administrative tasks required to create and manage Oracle Tuxedo CORBA interfaces including defining default attributes for interfaces at the domain and server group levels.

<a name="newcorbainterface"></a>

<a name="T_INTERFACE"></a>

<a name="C_INTERFACE"></a>

<a name="N_INTERFACE"></a>

Creating a New CORBA Interface

Select the CORBA Interfaces folder and select Quick Menu—>New to open the Create New Object window. The Create New Object Window contains the following fields:

•	Interface Name

•	Group Name

To create a new interface, enter the required information for the new CORBA interface and click the Create button.

Note:

For information about using the Quick Menu, see Quick Menu Options. For information about the Create New Object window, see Adding New Administrative Objects.

The following sections describe the information you need to enter in the Create New Object window for each interface field.The format of the fields you enter may be dependent upon the IDL that generates the interface implementation, For more information about the IDL format, see the CORBA 2.1 Specification Section 7.6.

<a name="ncif_interfacename"></a>

<a name="ac_ifcno_inf1"></a>

Interface Name

Description

This name represents the interface repository ID for the interface. The format of the name is dependent on the options specified in the IDL that generates the interface implementation.

Valid Values

A fully qualified interface name, where name is a text string from 1 to a maximum of 128 characters. You cannot leave this field blank.

Example

IDL:Simp:1.0

<a name="ac_ifcno_grp1"></a><a name="ncif_groupname"></a>

Group Name

Description

This name represents the name of the server group associated with this interface.

Valid Values

A group name, where the name is a text string from 0 to a maximum of 30 characters. Server group names cannot contain an asterisk, comma, or colon. You cannot leave this field blank.

Example

GRP9BANKERS

<a name="concorbainterface"></a>

Configuring a CORBA Interface (T_INTERFACE)

The Oracle Tuxedo Administration Console Interface (T_INTERFACE) configuration attributes are displayed on the following tab pages:

•	General Tab

•	System Parameters Tab

•	Policies Tab

•	Statistics Tab

To view or edit the configuration attributes for an Interface, highlight an interface icon in the main window tree. The Configuration Tool pane displays the tabs containing the configuration attributes for your selection. For more information about the Configuration Tool, see Configuring Administrative Objects.

The following sections describe each interface configuration attribute field.The format of the editable field may be dependent upon the IDL that generates the interface implementation. For more information about the IDL format, see the CORBA 2.1 Specification Section 7.6.

<a name="ccif_generaltab"></a>

General Tab

The following describes the fields provided on the General tab and the values you need to enter for those fields.

<a name="16301"></a>

<a name="ac_ifgen_inf2"></a>

Interface Name

Description

The Interface Name field displays the fully qualified interface name that was specified in the Create New Objects Interface Name field. For more information, see Creating a New CORBA Interface.

<a name="16302"></a>

<a name="ac_ifgen_grp2"></a>

Group Name

Description

The Group Name field displays the name of the server group associated with this interface that was specified in the Create New Objects Group Name field. For more information, see Creating a New CORBA Interface.

<a name="16303"></a>

<a name="ac_ifgen_obs2"></a>

Object State

Description

The Object State field displays the state attributes for Interface Queue objects.

Valid Values

This read-only field displays one of the following values:

ACT Active state. The Interface Queue object is an available interface in the running system.

SUS Suspend state. The Interface Queue object represents a currently suspended interface in the running system.

PAR Partitioned state. The Interface Queue object represents a currently partitioned interface in the running system.

The Object States for an Interface Queue are set by selecting an Interface Queue icon and using the Quick Menu to suspend or resume the object. If the Interface Queue object is suspended, you can activate the object. To restore a suspended Interface Queue object to an active state, select Resume from the Quick Menu. If the Interface Queue object is active, you can suspend the object. To suspend an Interface Queue object, highlight the object and select Suspend from the Quick Menu.

Note:

The Oracle Tuxedo Administration Console does not support dynamic advertisement of interfaces (i.e., state change from INActive or INValid to ACTive) or unadvertisement of interfaces (i.e., state change from ACTive to INActive).

Note: <a name="16310"></a>

Note: <a name="ac_ifgen_lmn2"></a>

Logical Machine Name

Description

The Logical Machine Name field displays the name of the current logical machine on which the queue offering this interface is loaded.

<a name="ccif_sysparmtab"></a>

System Parameters Tab

The following sections describes the fields provided on the System Parameters tab and the values you need to enter for those fields.

<a name="16305"></a>

<a name="ac_ifsyp_ifl2"></a>

Interface Load

Description

The Interface Load field displays a value representing the load on the system imposed by the T_INTERFACE object. Interface loads are used for load balancing purposes. Queues with higher enqueued workloads are less likely to be chosen for a new request.

Valid Values

Any integer from 1 to a maximum of 32K.

Example

50

<a name="16306"></a>

<a name="ac_ifsyp_pri2"></a>

Priority

Description

The Priority field displays the dequeueing priority. If multiple interface requests are waiting on a queue for servicing, the higher priority requests are handled first.

Valid Values

A number from 1 a maximum of 101.

Example

101

<a name="16307"></a>

<a name="ac_ifsyp_ift2"></a>

Interface Timeout

Description

The Interface Timeout field displays the time limit (in seconds) for processing individual method invocations for the selected interface queue. Servers processing method invocations for this interface are abortively terminated if they exceed the specified time limit in processing the request.

Valid Values

A number greater than or equal to zero.A value of zero for this attribute indicates that the server should not be abortively terminated.

Example

30

<a name="16308"></a>

<a name="ac_ifsyp_trt2"></a>

Transaction Timeout

Description

The Transaction Timeout field displays the timeout value in seconds for transactions automatically started for this interface queue. Transactions are started automatically when a request not in transaction mode is received and the Interface AUTOTRAN attribute value is set to Y. For more information about the Interface AUTOTRAN attribute, see the Interface Auto Transaction Mode field.

Valid Values

A number greater than or equal to zero, representing a timeout interval in seconds.

Example

60

<a name="16309"></a>

<a name="ac_ifsyp_rtn2"></a>

Routing Table Name

Description

The Routing Table Name field displays the factory-based routing criteria associated with this interface.

Valid Values

A string from 1 a maximum of 15 characters.

Example

RTBLSOPAC

<a name="ccif_policies"></a>

Policies Tab

The following topics describe the Policies tab fields provided for configuring CORBA Interfaces.

<a name="16304"></a>

<a name="ac_ifpol_atm2"></a>

Auto Transaction Mode

Description

The Auto Transaction Mode field indicates whether a transaction is automatically started for invocations made outside a transaction context. The transaction policy setting can override the AUTOTRAN attribute. See Transaction Policy for more information.

Valid Values

Select Yes or No from the drop-down list box in this field. Select Yes to automatically start a transaction. Select No to prevent transactions from automatically starting.

<a name="16311"></a>

 

<a name="ac_ifpol_dep2"></a>

Deactivation Policy

Description

The Deactivation Policy field displays the TP Framework deactivation policy. This reflects the policy registered with the framework at server startup. The first server to register the interface sets the value in T_INTERFACE. You can not change this value.

The values for the deactivation policy are: method, transaction, process.

<a name="16312"></a>

<a name="ac_ifpol_trp2"></a>

Transaction Policy

Description

The Transaction Policy field displays the policy attribute for the interface. The Transaction Policy is a read-only field. The developer sets the value for this attribute when the server application is built and registered at server startup.

The transaction policy setting can override the AUTOTRAN attribute. For more information about how these settings affect the AUTOTRAN attribute, see the Interface Auto Transaction Mode field.

The values displayed for the Transaction Policy are listed in Table 8‑1 and include a description of how these settings override the AUTOTRAN attribute.

 

Table 8‑1 Transaction Policy and Description

Valid Values	AUTOTRAN Setting	Description
always	No or Yes	No change occurs at run time. The behavior is the same as if AUTOTRAN was set to Y.
never	Y	No change occurs. The interface will never be involved in a transaction.
ignore	Y	Overrides the AUTOTRAN setting. The interface will never be involved in a transaction.
optional	Y or N	Has no effect on AUTOTRAN setting.

<a name="ccif_statstab"></a>

Statistics Tab

The following topics describe the fields provided on the Configuration Statistics tab and the values you need to enter for those fields.

<a name="16313"></a>

<a name="ac_ifstat_rec2"></a>

Requests Completed

Description

The Requests Completed field contains the number of interface method invocations completed with respect to the corresponding T_IFQUEUE objects since they were initially offered. Local queries on domain level objects will return one object per machine with the statistics for the indicated interface on that machine.

Valid Values

A number greater than or equal to zero.

<a name="16314"></a>

<a name="ac_ifstat_req2"></a>

Requests Queued

Description

The Requests Queued field displays the number of requests currently enqueued for this interface. The displayed number is a long integer greater than or equal to zero. This is a read-only field.

CORBA Interface Queues (T_IFQUEUE)

The T_IFQUEUE MIB represents run-time attributes of an interface as it pertains to a particular server queue (T_QUEUE). This is primarily a read-only class providing access to the inherited configuration attributes of an interface as well as statistics relating to the interface on the queue. Additionally, this class gives administrators finer granularity in suspending and activating interfaces. This class provides the link between an interface name and the server processes capable of processing method invocations on the interface (i.e., TA_RQADDR can be used as a key search field on the T_SERVER class).

<a name="newinterfaceq"></a>

<a name="T_IFQUEUE"></a>

<a name="C_IFQUEUE"></a>

<a name="N_IFQUEUE"></a>

Viewing a CORBA Interface Queue Configuration (IF_QUEUE)

The Oracle Tuxedo Administration Console Interface Queue (IF_QUEUE) configuration attributes are displayed on the following tab pages:

•	General Tab

•	Policies Tab

•	System Parameters Tab

To view the configuration attributes for an Interface Queue, highlight an interface queue icon. The Configuration Tool pane displays the General tab containing the configuration attributes for your selection.

For more information about the Configuration Tool, see Configuring Administrative Objects. For more information about the IDL format for interface queue attributes, see the CORBA 2.1 Specification Section 7.6.

The following sections describe each interface queue configuration attribute. The Interface Queue configuration attributes are read-only. You cannot edit them.

<a name="nifq_generaltab"></a>

General Tab

The following sections describe the fields provided on the General tab.These Interface Queue fields are read-only attributes.

<a name="15200"></a>

<a name="ac_ifqgen_ifn4"></a>

Interface Name

Description

The Interface Name field displays the fully qualified interface name. This is the repository ID for the interface. The interface name is a string from 0 to a maximum of 128 characters. The format of the name is dependent on the options specified in the IDL that generates the interface implementation.

<a name="15201"></a>

<a name="ac_ifqgen_grp4"></a>

Group Name

Description

The Group Name field displays the name of the server group associated with this interface. The name is a string from 0 to a maximum of 30 characters. Server group names cannot contain an asterisk, comma, or colon.

Logical Machine Name

Description

The Logical Machine Name field displays the name of the current logical machine on which the queue offering this interface is loaded.

<a name="15202"></a>

<a name="ac_ifqgen_qad4"></a>

Queue Address

Description

The Queue Address field displays the symbolic address of the request queue for an active server offering this interface.The address is a string from 1 to a maximum of 30 characters.

<a name="15203"></a>

<a name="ac_ifqgen_obs4"></a>

Object State

Description

The Object State field displays the state attributes for Interface Queue objects. This read-only value displays the following values:

ACT Active state. The Interface Queue object is an available interface in the running system.

SUS Suspend state. The Interface Queue object represents a currently suspended interface in the running system.

PAR Partitioned state. The Interface Queue object represents a currently partitioned interface in the running system.

The Object States for an Interface Queue are set by selecting an Interface Queue icon and using the Quick Menu to suspend or resume the object. If the Interface Queue object is suspended, you can activate the object. To restore a suspended Interface Queue object to an active state, select Resume from the Quick Menu. If the Interfaces Queue object is active, you can suspend the object. To suspend an Interface Queue object, highlight the object and select Suspend from the Quick Menu.

Note:

The Oracle Tuxedo Administration Console does not support dynamic advertisement of interfaces (i.e., state change from INActive or INValid to ACTive) or unadvertisement of interfaces (i.e., state change from ACTive to INActive).

Note: <a name="nifq_policytab"></a>

Policies Tab

The following sections describes the fields provided on the Policies tab.The Interface Queue policies are read-only attributes.

<a name="15204"></a>

<a name="ac_ifqpol_atm4"></a>

Auto Transaction Mode

Description

The Auto Transaction Mode field displays the value of Y or N indicating whether a transaction is automatically started for invocations made outside a transaction context. The transaction policy setting can override the AUTOTRAN attribute. For more information about how these settings affect the AUTOTRAN attribute, see the Interface Auto Transaction Mode field.

<a name="15211"></a>

<a name="ac_ifqpol_dep4"></a>

Deactivation Policy

Description

The Deactivation Policy field displays the TP Framework deactivation policy. This reflects the policy registered with the framework at server startup. The first server to register the interface sets the value in T_INTERFACE. You cannot change this value.

The values for the deactivation policy are: method, transaction, process.

Transaction Policy

Description

The Transaction Policy field displays the policy attribute for the interface. The Transaction Policy is a read-only field. The developer sets the value for this attribute when the server is built and registered at server startup.

The transaction policy setting can override the AUTOTRAN attribute. For more information about the values for this field and how these values affect the AUTOTRAN attribute, see the Interface Transaction Policy field.

<a name="nifq_sysparmtab"></a>

System Parameters Tab

The following sections describes the fields provided on the System Parameters tab.The Interface Queue system parameters are read-only attributes.

<a name="15205"></a>

<a name="ac_ifqsyp_ifl4"></a>

Interface Load

Description

The Interface Load field displays a value representing the load on the system imposed by the T_INTERFACE object. Interface loads are used for load balancing purposes. Queues with higher enqueued workloads are less likely to be chosen for a new request.

The displayed value is a number from 1 to a maximum of 32K.

<a name="15206"></a>

<a name="ac_ifqsyp_pri4"></a>

Priority

Description

The Priority field displays the dequeueing priority. If multiple interface requests are waiting on a queue for servicing, the higher priority requests are handled first.

The displayed value is a number from 1 a maximum of 101.

<a name="15207"></a>

<a name="ac_ifqsyp_ift4"></a>

Interface Timeout

Description

The Interface Timeout field displays the time limit (in seconds) for processing individual method invocations for the selected interface queue. Servers processing method invocations for this interface are abortively terminated if they exceed the specified time limit in processing the request.

The displayed value is a number greater than or equal to zero. A value of zero for this attribute indicates that the server should not be abortively terminated.

<a name="15208"></a>

<a name="ac_ifqsyp_trt4"></a>

Transaction Timeout

Description

The Transaction Timeout field displays the timeout value in seconds for transactions automatically started for this interface queue. Transactions are started automatically when a request not in transaction mode is received and the Interface AUTOTRAN attribute value is set to Y. For more information about the Interface AUTOTRAN attribute, see the Interface Auto Transaction Mode field.

The displayed value is a number greater than or equal to 0 representing a timeout interval in seconds.

<a name="15209"></a>

<a name="ac_ifqsyp_rtn4"></a>

Routing Table Name

Description

The Routing Table Name field displays the factory-based routing criteria associated with this interface.

The displayed value is a string from 1 to a maximum of 15 characters.

<a name="15217"></a>

<a name="ac_ifqsyp_nsi4"></a>

Number of Servers with Interface

Description

The Number of Servers with Interface field displays the number of corresponding servers offering this interface on this queue.

The displayed value is a number greater than or equal to zero.

<a name="nifq_statstab"></a>

Statistics Tab

The following sections describe the fields provided on the Statistics tab.The Interface Queue statistics are read-only attributes.

<a name="15213"></a>

<a name="ac_ifqstat_rec4"></a>

Requests Completed

Description

The Requests Completed field displays the number of interface method invocations completed since the interface was initially offered.

The displayed value is a number greater than or equal to zero.

<a name="15214"></a>

<a name="ac_ifqstat_req4"></a>

Requests Queued

Description

The Requests Queued field displays the number of requests currently enqueued for this interface.

The displayed value is a number greater than or equal to zero.

<a name="15215"></a>

<a name="ac_ifqstat_cuo4"></a>

Current Number of Objects

Description

The Current Number of Objects field displays the number of active objects for this interface for associated queues. This number represents the number of entries in the active object table for its queue on the associated machine. This included objects that are not in memory but that were invoked within an active transaction.

The displayed value is a number greater than or equal to zero.

<a name="15216"></a>

<a name="ac_ifqstat_cnt4"></a>

Current Number of Transactions

Description

The Current Number of Transactions field displays the number of active global transactions associated with this interface for its associated queue.

The displayed value is a number greater than or equal to zero.

<a name="T_FACTORY"></a>

<a name="C_FACTORY"></a>

CORBA Factories (T_FACTORY)

A CORBA Factory is an interface used by a client to obtain an object reference to a CORBA object. Object references to factories are obtained by the client using an object reference to a FactoryFinder interface. The FactoryFinder interface is advertised by the Oracle Tuxedo server application and is made available to the client as part of client bootstrap processing.

The T_FACTORY MIB represents the occurrences of factories registered with the Oracle Tuxedo FactoryFinder. The available factories for a domain are displayed in the Oracle Tuxedo Administration Console. The Oracle Tuxedo Administration Console only allows you to view a Factory configuration and run-time information using the configuration tool.

<a name="concorbafactory"></a>

Viewing a CORBA Factory Configuration

The Oracle Tuxedo Administration Console Factory configuration attributes are provided on the General tab page. To view the configuration attributes for a factory, highlight a factory icon. The Configuration Tool pane displays the General tab containing the configuration attributes for your selected factory.

For more information about the Configuration Tool, see Configuring Administrative Objects. For more information about the IDL format for factory interface names, see the CORBA 2.1 Specification Section 7.6 for details.

The following sections describe each factory configuration attribute.

<a name="cfac_generaltab"></a>

General Tab

The following sections describes the read-only fields provided on the General tab.

<a name="15220"></a>

<a name="ac_facgen_inf6"></a>

Interface Name

Description

The Interface Name field displays the interface repository ID for the factory. The format of this name is dependent on the options specified in the IDL that generates the interface implementation.

<a name="15221"></a>

<a name="ac_facgen_fid6"></a>

Factory ID

Description

The Factory ID field displays the registered ID for the factory. The Factory ID is a string value from one to 256 alphanumeric characters. The format of the ID depends upon the options specified in the IDL for the generated interface implementation.

<a name="15222"></a>

<a name="ac_facgen_obs6"></a>

Object State

Description

The Object State field displays the current state of the selected Factory. The format of the Object State is a string. The value of this field is ACT (ACTive) indicating that the Object State is active. The ACT object state indicates that the factory is registered with the FactoryFinder.