File Formats, Data Descriptions, MIBs, and System Processes Reference
Overview of this document |
Management Information Base for ACLs |
Management Information Base for /Q |
Server providing per-user authentication |
Monitors Tuxedo client validity |
Instructions for compilation of Oracle Tuxedo system application components |
Domains administrative server |
Text version of a Domains configuration file |
Management Information Base for Domains |
List of system-generated events |
Management Information Base for EventBroker |
FactoryFinder Domains configuration file |
FML mapping files for field names |
General LDAP-based authentication server |
Domains gateway administrative server |
Enables access to Oracle Tuxedo objects by remote Oracle Tuxedo clients using IIOP. |
Kerberos-based Tuxedo authorization server |
Language information constants |
WebLogic Server embedded LDAP-based authentication server |
Tuxedo service metadata repository buffer format |
Management Information Base |
Native language data types |
Run-time options for server processes |
Management Information Base for core Oracle Tuxedo system |
Server that runs the FactoryFinder and NameManager services |
The Interface Repository server |
Tuxedo service metadata repository server |
Message Forwarding Server |
System event reporting process |
Run-time tracing facility |
User event reporting process |
Oracle Tuxedo system error codes |
Oracle Tuxedo system global variable for an application-specified return code |
List of environment variables in the Oracle Tuxedo system |
Buffer type switch; descriptions of buffer types provided by the Oracle Tuxedo system |
Buffer type switch structure; parameters and routines needed for each buffer type |
Text version of an Oracle Tuxedo configuration file |
Source file for view descriptions |
Management Information Base for Workstation |
Workstation Listener server |
Introduction to Tables and Files
Description
This section describes the format of miscellaneous tables and files.
The page named summarizes information about header files, libraries, and environment variables needed when compiling application source code.
The section includes descriptions of Oracle Tuxedo system-supplied servers. Applications wishing to use the Oracle Tuxedo system-supplied servers should specify them in the configuration file for the application.
The page describes options that can be specified in the configuration file as the parameter of application servers.
The Oracle Tuxedo Management Information Base is documented in the reference page and in the following component MIB pages:
ACL_MIB(5)
Name
—Management Information Base for ACLs
Synopsis
Description
The Oracle Tuxedo MIB defines the set of classes through which access control lists (ACLs) may be managed. An Oracle Tuxedo configuration with set to , , or must be created before accessing or updating these classes. should be used in combination with the generic MIB reference page to format administrative requests and interpret administrative replies. Requests formatted as described in using classes and attributes described in this reference page may be used to request an administrative service using any one of a number of existing ATMI interfaces in an active application. For additional information pertaining to all class definitions, see ACL_MIB(5) Additional Information.
(5) consists of the following classes.
Each class description section has four subsections:
Overview
Attribute Table
Attribute Semantics
Limitations
Attribute Table Format
As described above, each class that is a part of this MIB is defined below in four parts. One of these parts is the attribute table. 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 the attribute tables: name, type, permissions, values and default. Each of these components is discussed in .
TA_FLAGS Values
defines the generic attribute which is a containing both generic and component MIB specific flag values. At this time, there are no (5) specific flag values defined.
FML32 Field Tables
The field tables for the attributes described in this reference page are found in the file relative to the root directory of the Oracle Tuxedo system software installed on the system. The directory should be included by the application in the colon-separated list specified by the environment variable and the field table name should be included in the comma-separated list specified by the environment variable.
Limitations
Access to the header files and field tables for this MIB is provided only at sites running Oracle Tuxedo release 6.0 and later, both native and Workstation.
T_ACLGROUP Class Definition
Overview
The class represents groups of Oracle Tuxedo application users and domains.
Attribute Table
: { | } | ||||
( k )— key field ( r )—required field for object creation () ( * )— key, one or more required for operations |
Attribute Semantics
: [1..30]
: 0 <= < 16,384
:
object is defined and inactive. Note that this is the only valid state for this class. ACL groups are never . |
Create object for application. State change allowed only when in the state. Successful return leaves the object in the state. |
Modify an existing object. This combination is not allowed in the state. Successful return leaves the object state unchanged. |
Delete object for application. State change allowed only when in the state. Successful return leaves the object in the state. |
Limitations
A user can be associated with exactly one ACL group. For someone to take on more than one role or be associated with more than one group, multiple user entries must be defined.
T_ACLPERM Class Definition
Overview
The class indicates what groups are allowed to access Oracle Tuxedo system entities. These entities are named via a string. The names currently represent service names, event names, and application queue names.
Attribute Table
| | | | ||||
“{ | } | ||||
( r )—required field for object creation () ( * )— key, one or more required for operations |
Attribute Semantics
:
: | | |
:
:
object is defined and inactive. Note that this is the only valid state for this class. ACL permissions are never . |
Create object for application. State change allowed only when in the state. Successful return leaves the object in the state. |
Modify an existing object. This combination is not allowed in the state. Successful return leaves the object state unchanged. |
Delete object for application. State change allowed only when in the state. Successful return leaves the object in the state. |
Limitations
Permissions are defined at the group level, not on individual user identifiers.
T_ACLPRINCIPAL Class Definition
Overview
The class represents users or domains that can access an Oracle Tuxedo application and the group with which they are associated. To join the application as a specific user, it is necessary to present a user-specific password.
Attribute Table
: { | } | ||||
( k )— key field ( r )—required field for object creation () ( * )— key, one or more required for operations |
Attribute Semantics
:
:
: 1 <= < 131,072
: 0 <= < 16,384
:
:
object is defined and inactive. Note that this is the only valid state for this class. ACL principals are never . |
Create object for application. State change allowed only when in the state. Successful return leaves the object in the state. |
Modify an existing object. This combination is not allowed in the state. Successful return leaves the object state unchanged. |
Delete object for application. State change allowed only when in the state. Successful return leaves the object in the state. |
Limitations
A user or domain can be associated with exactly one ACL group. For someone to take on more than one role or be associated with more than one group, multiple principal entries must be defined.
ACL_MIB(5) Additional Information
Diagnostics
There are two general types of errors that may be returned to the user when interfacing with . First, any of the three ATMI verbs (, and ) used to retrieve responses to administrative requests may return any error defined for them. These errors should be interpreted as described on the appropriate reference pages.
If, however, the request is successfully routed to a system service capable of satisfying the request and that service determines that there is a problem handling the request, failure may be returned in the form of an application level service failure. In these cases, and will return an error with set to and return a reply message containing the original request along with , and fields further qualifying the error as described below. When a service failure occurs for a request forwarded to the system through the server, the failure reply message will be enqueued to the failure queue identified on the original request (assuming the option was specified for ).
When a service failure occurs during processing of an administrative request, the FML32 field is set to a textual description of the failure, the FML32 field is set to indicate the cause of the failure as indicated below. All error codes specified below are guaranteed to be negative.
The following diagnostic codes are returned in to indicate successful completion of an administrative request. These codes are guaranteed to be non-negative.
[]
Interoperability
The header files and field tables defined in this reference page are available on Oracle Tuxedo release 6.0 and later. Fields defined in these headers and tables will not be changed from release to release. New fields may be added which are not defined on the older release site. Access to the AdminAPI is available from any site with the header files and field tables necessary to build a request. The , , and classes are new with Oracle Tuxedo release 6.0.
Portability
The existing FML32 and ATMI functions necessary to support administrative interaction with Oracle Tuxedo system MIBs, as well as the header file and field table defined in this reference page, are available on all supported native and Workstation platforms.
Example
Following is a sequence of code fragments that adds a user to a group and adds permissions for that group to a service name.
Field Tables
The field table must be available in the environment to have access to attribute field identifiers. This can be done at the shell level as follows:
$ FLDTBLDIR=${TUXDIR}/udataobj
$ export FIELDTBLS FLDTBLDIR
Header Files
The following header files are included.
#include <fml32.h>
#include <tpadm.h>
Add User
The following code fragment adds a user to the default group “other.”
obuf = tpalloc("FML32", NULL, 1000);
/* Set MIB(5) attributes defining request type *
Fchg32(ibuf, TA_OPERATION, 0, "SET", 0);
Fchg32(ibuf, TA_CLASS, 0, "T_ACLPRINCIPAL", 0);
/* Set ACL_MIB(5) attributes */
Fchg32(ibuf, TA_PRINNAME, 0, ta_prinname, 0);
Fchg32(ibuf, TA_PRINID, 0, (char *)ta_prinid, 0);
Fchg32(ibuf, TA_STATE, 0, (char *)"NEW", 0);
Fchg32(ibuf, TA_PRINPASSWD, 0, (char *)passwd, 0);
/* Make the request */
if (tpcall(".TMIB", (char *)ibuf, 0, (char **)obuf, olen, 0) 0) {
fprintf(stderr, "tpcall failed: %s\en", tpstrerror(tperrno));
if (tperrno == TPESVCFAIL) {
Fget32(obuf, TA_ERROR, 0,(char *)ta_error, NULL);
ta_status = Ffind32(obuf, TA_STATUS, 0, NULL);
fprintf(stderr, "Failure: %ld, %s\en",
ta_error, ta_status);
}
/* Additional error case processing */
}
Files
,,
See Also
tpacall(3c), tpalloc(3c), tpcall(3c), tpdequeue(3c), tpenqueue(3c), tpgetrply(3c), tprealloc(3c), Introduction to FML Functions, Fadd, Fadd32(3fml), Fchg, Fchg32(3fml), Ffind, Ffind32(3fml), ,
Setting Up an Oracle Tuxedo Application
Programming an Oracle Tuxedo ATMI Application Using C
Programming an Oracle Tuxedo ATMI Application Using FML
APPQ_MIB(5)
Name
—Management Information Base for /Q
Synopsis
Description
The /Q MIB defines classes through which application queues can be managed.
(5) should be used in combination with the generic MIB reference page to format administrative requests and interpret administrative replies. Requests formatted as described in using classes and attributes described on this reference page may be used to request an administrative service using any one of a number of existing ATMI interfaces in an active application. Application queues in an inactive application may also be administered using the function interface. For additional information pertaining to all class definitions, see APPQ_MIB(5) Additional Information.
(5) consists of the following classes.
Application queues within a queue space |
Messages within an application queue |
Transactions associated with application queues |
Note that this MIB refers to application-defined persistent (reliable disk-based) and non-persistent (in memory) queues (that is, /Q queues), and not server queues (the class of the component).
Each class description section has four subsections:
Overview
Attribute Table
Attribute Semantics
Limitations
Attribute Table Format
Each class that is a part of this MIB is documented in four parts. One part is the attribute table. 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 the attribute tables: name, type, permissions, values and default. Each of these components is discussed in .
TA_FLAGS Values
defines the generic attribute which is a containing both generic and component MIB-specific flag values. The following flag values are defined for the (5) component. These flag values should be OR’d with any generic MIB flags.
FML32 Field Table
The field table for the attributes described on this reference page is found in the file relative to the root directory of the Oracle Tuxedo software installed on the system. The directory should be included by the application in the path list (semicolon-separated list on Windows and colon-separated list otherwise) specified by the environment variable and the field table name should be included in the comma-separated list specified by the environment variable.
Limitations
This MIB is provided only on Oracle Tuxedo system 6.0 sites and later, both native and Workstation.
If a site running an Oracle Tuxedo release earlier than release 6.0 is active in the application, administrative access through this MIB is limited as follows.
- operations are not allowed.
- Local information access for sites earlier than release 6.0 is not available.
T_APPQ Class Definition
Overview
The class represents application queues. One or more application queues may exist in a single application queue space.
Limitations
It is not possible to retrieve all instances of this class by leaving all key fields unset. Instead, sufficient key fields must be supplied to explicitly target a single application queue space. These required key fields are , , and , except when the application is unconfigured (that is, when the environment variable is not set), in which case must be omitted. For example, if the , , and attributes are set in a request using , all objects within the specified queue space will be retrieved.
Attribute Table
(k)(r)(*) | ||||
: { | } | ||||
{ | | | | } | ||||
[0..127] e | ||||
[0..127] e | ||||
( k )— key field f ( r )—required field for object creation ( * )—required key field |
a All attributes of class are local attributes.
b must be specified as a key field except when the application is unconfigured (that is, the environment variable is not set).
c All operations on objects—both and —silently open the associated queue space (that is, implicitly set the state of the queue space to if it is not already or ). This may be a time-consuming operation if the queue space is large.
d cannot be modified after the application queue is created.
e Maximum string length for this attribute is 78 bytes for Oracle Tuxedo 8.0 or earlier.
f Sufficient key fields must be supplied in a operation to explicitly target a single application queue space.
Attribute Semantics
: [1..15]
: [1..15]
: [1..78]
: [1..30] (no comma)
:
The specified queue exists. This state is equivalent for purposes of permissions checking. |
Create a new queue in the specified queue space. The queue is left in state following successful creation. |
Delete the specified queue. The queue must be in state to be deleted. If the queue space has processes attached to it (that is, it is in the state), the queue will not be deleted unless the attribute includes the flag. In addition, if the queue has messages in it, it will not be deleted unless is specified. Successful return leaves the object in the state. |
Modify an application queue. Successful return leaves the state unchanged. |
0 thoughts to “Download WUD global connection logo”