|
|
|
|
|
DM_MIB(5)
Name
DM_MIB - Management Information Base for Domains
Synopsis
#include <fml32.h>
#include <tpadm.h> /* MIB Header, includes DOMAINS */
Domains Terminology Improvements
The Domains MIB uses improved class and attribute terminology to describe the interaction between domains. This improved terminology has also been applied to DMCONFIG file syntax.
These terminology improvements eliminate multiple uses of the term "domain" and introduce terms that more clearly describe the actions that occur. For example, the term access point defines an object through which you gain access to another object. Therefore, you access a remote domain through a remote domain access point, and remote domains gain access to a local domain through a local domain access point. The following table reflects the DMCONFIG section name changes that result from eliminating multiple uses of the term "domain."
|
This DMCONFIG section name. . . |
Has changed to. . . |
|---|---|
|
DM_LOCAL_DOMAINS |
DM_LOCAL |
|
DM_REMOTE_DOMAINS |
DM_REMOTE |
Within these sections, the following parameter names have changed.
|
This parameter name. . . |
Has changed to. . . |
|---|---|
|
DOMAINID |
ACCESSPOINTID |
|
MAXRDOM |
MAXACCESSPOINT |
|
MAXRDTRAN |
MAXRAPTRAN |
The equivalent DM_MIB classes for these DMCONFIG sections are T_DM_LOCAL and T_DM_REMOTE, respectively.
In certain configurations, both available services and resources, such as queue spaces and queue names, need to be imported and exported. As such, the DMCONFIG section names DM_LOCAL_SERVICES and DM_REMOTE_SERVICES no longer accurately describe the necessary activity. Replacing these section names with DM_EXPORT and DM_IMPORT, respectively, clearly describes the actions that occur; that is, from the perspective of a single BEA Tuxedo domain, resources are exported from the domain through local access points and imported into the domain through remote access points. These DMCONFIG section name changes are shown in the following table.
|
This DMCONFIG section name. . . |
Has changed to. . . |
|---|---|
|
DM_LOCAL_SERVICES |
DM_EXPORT |
|
DM_REMOTE_SERVICES |
DM_IMPORT |
Within these sections, the following parameter names have changed.
|
This parameter name. . . |
Has changed to. . . |
|---|---|
|
LDOM |
LACCESSPOINT |
|
RDOM |
RACCESSPOINT |
The equivalent DM_MIB classes for these DMCONFIG sections are T_DM_EXPORT and T_DM_IMPORT, respectively.
Backwards Compatibility
While the improved domains terminology is more accurate than previous terminology, the scope of changes to domains-related documentation and error messages is limited in this release. The improved terminology has been applied to the DM_MIB classes, reference page, and error messages, the DMCONFIG file syntax, and various DMCONFIG error messages.
For backwards compatibility, aliases are provided between the DMCONFIG terminology used prior to this release and the improved Domains MIB terminology. In this release, dmloadcf accepts both versions of the DMCONFIG terminology. dmunloadcf, however, generates a DMCONFIG file that uses the improved domains terminology by default. Use the -c option of dmunloadcf to generate a DMCONFIG file that uses the previous domains terminology.
Description
The Domains MIB defines the set of classes through which a domain may import or export services using domain gateways and domain gateway administrative servers. This reference page assumes the reader is familiar with the BEA Tuxedo System Domains feature.
Use DM_MIB(5) in combination with the generic MIB reference page MIB(5) to format administrative requests and interpret administrative replies.
Requests formatted as described in MIB(5) using classes and attributes described in DM_MIB may be used to request an administrative service using existing ATMI interfaces in an active application.
DM_MIB(5) consists of the following classes:
Each class description consists of four sections:
The attribute table is a reference guide to the attributes within a class and how they may used by administrators, operators, and general users to interface with an application.
There are five components to each attribute description in an attribute table: name, type, permissions, values, and default. Each of these components is discussed in MIB(5).
TA_FLAGS Values
MIB(5) defines the generic TA_FLAGS attribute which is a long-valued field containing both generic and component MIB-specific flag values. At this time, there are no DM_MIB-specific flag values defined.
FML32 Field Tables
The field tables for the attributes described in this reference page are found in the file udataobj/tpadm relative to the root directory of the BEA Tuxedo System software installed on the system. The directory ${TUXDIR}/udataobj should be included by the application in the colon-separated list specified by the FLDTBLDIR environment variable. The field table name tpadm should be included in the comma-separated list specified by the FIELDTBLS environment variable.
Interoperability
Access to the header files and field tables for this MIB is provided only on BEA Tuxedo Release 7.1 sites and later, both native and Workstation. If a Release 5.0 or earlier site is active in the application, then global information updates ("SET" operations) are not allowed to gateway groups on those sites.
Local information access for Release 5.0 and earlier sites is not available. If the class accessed also has global information, then only the global information is returned. Otherwise, an error is returned.
Portability
The existing FML32 and ATMI functions necessary to support administrative interaction with BEA Tuxedo System MIBs, as well as the header file and field tables defined in this reference page, are available on all supported native and Workstation platforms.
T_DM_ACL Class Definition
Overview
The T_DM_ACL class represents access control information for domains.
Attribute Table
|
"VALid" |
The object is defined and inactive. This is the only valid state for this class. ACL groups are never active. |
Limitations
None.
T_DM_CONNECTION Class Definition
Overview
The T_DM_CONNECTION class represents the status of connections between domain access points.
Attribute Table
Note 1The link-level encryption value of 40 bits is provided for backward compatibility.
Attribute Semantics
Attributes available when TA_DMTYPE=TDOMAIN
Note: The link-level encryption value of 40 bits is provided for backward compatibility.
Limitations
The Domain gateway administration (GWADM) server and the domain gateway supporting the local domain access point specified in the TA_DMLACCESSPOINT attribute must be active in order to perform GET or SET operations on connections to that access point.
T_DM_EXPORT Class Definition
Overview
The T_DM_EXPORT class represents local resources that are exported to one or more remote domains through a local access point.
Attribute Table
|
"VALid" |
The object exists. |
Attributes available from remote access points of TA_DMTYPE=SNAX|OSITP|TOPEND
Attributes available from remote access points of TA_DMTYPE=TOPEND
Limitations
On SET operations that add or update an instance of this class, and where a specific local domain access point is specified in the TA_DMLACCESSPOINT attribute, the access point must exist in the T_DM_LOCAL class. If it does not, a "not defined" error is returned for the TA_DMLACCESSPOINT attribute and the operation fails.
T_DM_IMPORT Class Definition
Overview
The T_DM_IMPORT class represents remote resources that are imported through one or more remote domain access points and made available to the local domain through one or more local domain access points.
Attribute Table
|
"VALid" |
The object exists. |
Attributes available from remote access points of TA_DMTYPE=SNAX|OSITP|TOPEND
Attributes available from remote access points of TA_DMTYPE=TOPEND
Limitations
None.
T_DM_LOCAL Class Definition
Overview
The T_DM_LOCAL class defines a local domain access point. A local domain access point is used to control access to local services exported to remote domains and to control access to remote services imported from remote domains.
Attribute Table
|
Attribute |
Type |
Permissions |
Values |
Default |
|---|---|---|---|---|
|
TA_DMACCESSPOINT(r)(k)(*) |
string |
rw-r--r-- |
string[1..30] |
N/A |
|
string |
rw-r--r-- |
string[1..30] |
N/A |
|