Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary
Tuxedo Doc Home   |   TOP END Domain Gateway   |   Topic List   |   Previous   |   Next   |   Contents

   Using the BEA Tuxedo TOP END Domain Gateway

This section describes the environment required for a particular domain gateway group. Here a logical application name, LDOM, is assigned to the subset of local services that can be accessed by remote domains. Multiple entries in this section are used to define multiple gateway groups within a single BEA Tuxedo application. Each entry specifies the parameters required for the Domains gateway running in that group.

Entries in this section have the form:

LDOM required_parameters [optional_parameters]

where LDOM is an identifier value used to name the local domain. For the TEDG, each LDOM defines a gateway process that is part of a single BEA TOP END system. The LDOM communicates with remote domains of type TOPEND that are part of the same BEA TOP END system. (The BEA TOP END system name is defined in the DM_TOPEND section of DMCONFIG).

For a description of the syntax required for parameters specified in this section, see DMCONFIG for GWTOPEND(5) in the BEA Tuxedo File Formats and Data Descriptions Reference.

The parameters required in this section are listed in the following table.

Required Parameters in DM_LOCAL_DOMAINS

Required Parameter	Definition
GWGRP	Specifies the name of the gateway server group (as defined in the UBBCONFIG file) representing this local domain. There is a one-to-one relationship between a DOMAINID and the name of the gateway server group.
TYPE	Used for grouping local domains into classes. Valid entries are TDOMAIN, SNAX, OSITP, and TOPEND. For the TEDG, set this value to TOPEND.
DOMAINID	Used to identify the local domain. The TEDG uses the local domain DOMAINID as the BEA TOP END user ID for requests made to the BEA TOP END system. Define the associated password using the dmadmin subcommand topendpasswd. Refer to Using the dmadmin Command Interpreter for information on using the dmadmin command. The DOMAINID must be unique across both local and remote domains.

Defining the Optional Parameters

Optional parameters describe the resources and limits used in the operation of domain gateways. These parameters, which are defined in detail in the DMCONFIG for GWTOPEND(5) reference page, are listed in the following table.

Optional Parameters in DM_LOCAL_DOMAINS

This Parameter. . .	Specifies . . .
AUDITLOG	The name of the audit log for this local domain.
BLOCKTIME	The maximum wait time allowed for blocking a call.
CONNECTION_POLICY	The conditions under which a local domain gateway tries to establish a connection to a remote domain. Details on this parameter are provided in Establishing Connections Between BEA Tuxedo and BEA TOP END Systems.
DMTLOGDEV	The BEA Tuxedo file system that contains the Domains transaction log (DMTLOG) for this machine.
DMTLOGNAME	The name of the Domains transaction log for this domain.
DMTLOGSIZE	The numeric size, in pages, of the Domains transaction log for this machine.
MAXRDTRAN	The maximum number of domains that can be involved in a transaction.
MAXRETRY	The maximum number of times that a domain gateway tries to establish a connection to a remote domain before quitting.
MAXTRAN	The maximum number of simultaneous global transactions allowed on this local domain.
RETRY_INTERVAL	The number of seconds between automatic attempts (all network addresses tried) to establish a connection to a remote domain.
SECURITY	The type of security to be used by the TEDG. Details on this parameter are provided in Defining Security in the DMCONFIG File.

See Also

• Sample Configuration File for a TOP END Domain Gateway

• DMCONFIG for GWTOPEND(5) in BEA Tuxedo File Formats and Data Descriptions Reference