The T_CLASSATT class represents characteristics of administrative attributes on a class/attribute basis.
TA_CLASSNAME : string
TA_ATTRIBUTE: long
tpadm.h.
TA_STATE :
GET: VALid
GET operation will retrieve information for the selected T_CLASSATT object(s). The following states indicate the meaning of a TA_STATE returned in response to a GET request. States not listed will not be returned.
|
|
|
{NEW|INValid}
SET operation will update configuration information for the selected T_CLASSATT object. The following states indicate the meaning of a TA_STATE set in a SET request. States not listed may not be set.
TA_PERM : 0000 = num = 0777
TA_TYPE attribute of the T_MACHINE class is documented with permissions rw-r--r-- and has maximum permissions of rw-rw-rw-.
TA_FACTPERM : 0000 = num = 0777
SET operation changing the TA_STATE of an object to INValid.
TA_MAXPERM : 0000 = num = 0777
TA_ATTFLAGS : long
MIBATT_KEYFIELD
MIBATT_LOCAL
MIBATT_REGEXKEY
MIBATT_REQUIRED
NEW object in this class.
MIBATT_SETKEY
SET key for this class.
MIBATT_NEWONLY
NEW object by changing the TA_STATE from INValid to NEW.
TA_DEFAULT : string
NEW object in this class. Note that for classes where NEW objects may not be created through the Admin API, this attribute will always be returned as a 0 length string. Attributes that may not be SET when creating a NEW object are also returned as 0 length strings. Attributes which have long values will have defaults returned as the string representing the long value. Some attributes have special characteristics indicated by the special values indicated below that may be returned here.
# Inherited:Classname[:Attribute]
# Required
NEW object.
# Special
TA_VALIDATION : string
SET. This string will take one of the following formats:
CHOICES=string1|string2|...
RANGE=min\(emmax
SIZE=min\(emmax
READONLY=Y
SPECIAL=Y
UNKNOWN=Y
None identified.
There are two general types of errors that may be returned to the user when interfacing with component MIBs. First, any of the three ATMI verbs (tpcall(3), tpgetrply(3) and tpdequeue(3)) used to retrieve responses to administrative requests may return any error defined on their respective reference pages.
Second, if 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, then failure may be returned in the form of an application level service failure. In these cases, tpcall(3) or tpgetrply(3) returns an error with tperrno set to TPESVCFAIL and returns a reply message containing the original request along with TA_ERROR, TA_STATUS or TA_BADFLD fields further qualifying the error as described below. When a service failure occurs for a request forwarded to the system through the TMQFORWARD(5) server, the failure reply message will be enqueued to the failure queue identified on the original request (assuming the -d option was specified for TMQFORWARD).
When a service failure occurs during processing of an administrative request, the FML32 field TA_STATUS is set to a textual description of the failure, the FML32 field TA_ERROR is set to indicate the cause of the failure as indicated below. TA_BADFLD is set as indicated in the description of the individual errors below. All error codes specified below are guaranteed to be negative.
TAEAPP]
TAECONFIG]
TAEINVAL]
TA_BADFLD is set to indicate the invalid field identifier.
TAEOS]
TA_STATUS is updated with the translation of the system error code errno.
TAEPERM]
SET an attribute for which the user does not have write permissions or the user attempted a GET on a class for which the user does not have read permissions. TA_BADFLD is set to indicate the field identifier that failed permissions checking.
TAEPREIMAGE]
SET operation failed due to a mismatch between the specified pre-image and the current object. TA_BADFLD is set to indicate the field identifier that failed the pre-image checking.
TAEPROTO]
TA_STATUS is populated with additional information.
TAEREQUIRED]
TA_BADFLD is set to indicate the missing field identifier.
TAESUPPORT]
TAESYSTEM]
TA_STATUS is updated with more information on the error condition.
TAEUNIQ]
SET operation did not specify class keys identifying a unique object to be updated.
The following diagnostic codes are returned in TA_ERROR to indicate successful completion of an administrative request. These codes are guaranteed to be non-negative.
TAOK]
TAUPDATED]
TAPARTIAL]
Access to the FML32 interfaces, and therefore to the component MIBs available for administration of a BEA TUXEDO system application, are available on BEA TUXEDO Release 4.2.2 and later. The header files and field tables defining generic MIB attributes are available on TUXEDO Release 5.0 and later. Interoperability concerns specific to a particular component MIB are discussed in the reference page for that component MIB.
The existing FML32 and ATMI functions necessary to support administrative interaction with BEA 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.
See the "USAGE" section earlier for some brief example uses of existing APIs in interfacing with generic MIB processing. More detailed examples are provided with each component MIB reference page that make use of real component MIB classes and attributes.
${TUXDIR}/include/tpadm.h,${TUXDIR}/udataobj/tpadm
Fintro(3), Fadd32(3), Fchg32(3), Ffind32(3) tpalloc(3), tprealloc(3), tpcall(3), tpacall(3), tpgetrply(3), tpenqueue(3), tpdequeue(3), AUTHSVR(5), TM_MIB(5), TMQFORWARD(5), Administering the BEA TUXEDO System, TUXEDO Programmer's Guide