Section 5 - File Formats, Data Descriptions, MIBs, and System Processes Reference

e-docs > Tuxedo > File Formats, Data Descriptions, MIBs, and System Processes Reference > Section 5 - File Formats, Data Descriptions, MIBs, and System Processes Reference

File Formats, Data Descriptions, MIBs, and System Processes Reference

DM_LOCAL Section

This section, also known as the DM_LOCAL_DOMAINS section, defines one or more local domain access point identifiers and their associated gateway groups. The section must have a local domain access point entry for each active gateway group defined in the UBBCONFIG file. Each entry specifies the parameters required for the domain gateway process running in that group.

The entry defines a GWTOPEND domain gateway instance (with its associated GWADM) that is associated with a single, remote BEA TOP END system. The local BEA Tuxedo application 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.

Entries within the DM_LOCAL section have the following form:

LocalAccessPoint required_parameters [optional_parameters]

where LocalAccessPoint is the local domain access point identifier (logical name) that you choose to represent a particular gateway group defined in the UBBCONFIG file. LocalAccessPoint must be unique across the local and remote domains involved in a Domains configuration. As you will see in the description of the DM_EXPORT section, you use the local domain access point to associate local resources (services, queues) with the gateway group. The local resources available through the local domain access point will be available to clients in one or more remote domains.

Required TEDG parameters for the DM_LOCAL section

GWGRP = identifier

Specifies the name of the domain gateway group (the name provided in the GROUPS section of the TUXCONFIG file) representing this local domain access point. There is a one-to-one relationship between a local domain access point and a domain gateway group.

TYPE = identifier

Specifies the type of domain gateway associated with this local domain access point. TYPE can be set to one of the following values: TOPEND, TDOMAIN, SNAX, OSITP, or OSITPX.

The TOPEND value indicates that this local domain access point is associated with a a GWTOPEND domain gateway instance and therefore can communicate with a BEA TOP END system.

The TDOMAIN value indicates that this local domain access point is associated with a GWTDOMAIN gateway instance and therefore can communicate with another BEA Tuxedo application.

The SNAX value indicates that this local domain access point is associated with a GWSNAX gateway instance and therefore can communicate with another TP domain via the SNA protocol.

The OSITP or OSITPX value indicates that this local domain access point is associated with a GWOSITP gateway instance and therefore can communicate with another TP domain via the OSI TP protocol. The OSITP value indicates the use of the OSI TP 1.3 protocol, and the OSITPX value indicates the use of the OSI TP 4.0 or later protocol. The OSITPX value is supported only by BEA Tuxedo 8.0 or later software.

Domain types must be defined in the DMTYPE file: %TUXDIR%\udataobj\DMTYPE for Windows or $TUXDIR/udataobj/DMTYPE for UNIX.

ACCESSPOINTID (also known as DOMAINID) = string[1..30]

Used to identify the domain gateway group associated with this local domain access point for purposes of security when setting up connections to remote domains. For a domain gateway of type TOPEND, this value is also used by the TEDG (local instance of the GWTOPEND process) as the BEA TOP END user ID for requests made to a BEA TOP END system.

ACCESSPOINTID must be 30 bytes or fewer in length. The BEA TOP END user ID is 1-12 characters excluding any trailing NULL. ASCII characters ranging from " "(32) through "~" (126), excluding "/" (47) are valid for this string. The password associated with the ACCESSPOINTID value can be entered using the dmadmin(1) subcommand topendpasswd.

Optional TEDG parameters for the DM_LOCAL section

AUDITLOG = string[1..256] (up to 78 bytes for BEA Tuxedo 8.0 or earlier)

Specifies the name of the audit log file for this local domain access point. The audit log feature is activated from the dmadmin(1) command and records all the operations for this local domain access point. If the audit log feature is active and this parameter is not specified, the file DMmmddyy.LOG (where mm=month, dd=day, and yy=year) is created in the directory specified by the $APPDIR environment variable or the APPDIR parameter of the MACHINES section of the TUXCONFIG file.

BLOCKTIME = numeric