public void trace(int level, int msgType, String message);
public void trace(int level, int msgNum, int msgType); public void trace(int level, int msgNum, int msgType, msgParameters); public void trace(int level, int msgNum, int msgType, Vector paramArray);
public void trace(int level, int msgType, BusObjDef boDef);
public void trace(int level, int msgType, AgentProperty[] properties, String foreword);
ODKConstant.TRACELEVEL0 ODKConstant.TRACELEVEL1 ODKConstant.TRACELEVEL2 ODKConstant.TRACELEVEL3 ODKConstant.TRACELEVEL4 ODKConstant.TRACELEVEL5
ODKConstant.XRD_FATAL ODKConstant.XRD_ERROR ODKConstant.XRD_URGENTWARNING ODKConstant.XRD_WARNING ODKConstant.XRD_INFO ODKConstant.XRD_TRACE
None.
The trace() method sends the specified information to the trace file when the trace level is less than or equal to the system trace level. The system trace level is set through the TraceLevel configuration property, which Business Object Wizard automatically includes in the ODA configuration properties. A trace level of zero (0) activates error logging; that is, trace() sends an error message to the trace file. The non-zero trace levels, shown in Table 111, activate tracing; that is, trace() sends a trace message to the trace file.
The user establishes the name of the ODA's trace destination through the TraceFileName configuration property, which the ODK automatically includes in the ODA startup properties. Therefore, tracing cannot begin until after the init() method (which receives initialized startup properties) starts.
The trace() method provides the following forms:
For information on ODA message files, see Message files. For information on message parameters, see Using parameter values.
[BusinessObjectDefinition] Name=busObjName AppSpecificInfo=business-object-level application-specific information [Attribute] Name=attribute1 Type=attribute type Cardinality=n or 1 AppSpecificInfo=attribute-level application-specific information other attribute properties [End] ...