About WLST Performance Analysis Tools

24-16 Publishing Reports to the Web with Oracle Reports Services maxFileSize The value of the maxFileSize attribute for an ODL handler. The value is a string representing a numeric value, possibly followed by a suffix indicating a size unit k for kilobytes, m for megabytes, g for gigabytes. maxLogSize The value of the maxLogSize attribute for an ODL handler. The value is a string representing a numeric value, possibly followed by a suffix indicating a size unit k for kilobytes, m for megabytes, g for gigabytes. rotationFrequency The value of the rotationFrequncy for an ODL handler. The value is a string representing a numeric value, possibly followed by a suffix indicating a time unit m for minutes, h for hours, d for days. The default unit is minutes. The following special values are also accepted and are converted to a numeric value in minutes: HOUR, HOURLY, DAY, DAYLY, WEEK, WEEKLY, MONTH, MONTHLY. baseRotationTime the base rotation time, to be used with the rotation frequency parameter. The value must be a string representing a datetime values. It can be a full datetime in ISO 8601 datetime format, or a short form including only hours and minutes. The default baseRotationTime is 00:00. retentionPeriod The retention period in minutes. The value must be string representing a numeric value, possibly followed by a suffix indicating a time unit m for minutes, h for hours, d for days. The default unit is minutes. The following special values are also accepted and are converted to a numeric value in minutes: HOUR, HOURLY, DAY, DAYLY, WEEK, WEEKLY, MONTH, MONTHLY. format The format for the ODL handler. The value must be the string ODL-Text or ODL-XML. The default format is ODL-Text encoding the character encoding for the log file. path the log file path. handlerType the name of the Java class that provides the handler implementation. It must be an instance of java.util.logging.Handler or oracle.core.ojdl.logging.HandlerFactory. propertyName the name of a handler property to be added or update. The property value is specified with the propertyValue parameter. propertyValue the new value for the handler property defined by the propertyName parameter. addProperty a Jython boolean value. Used in conjunction with the propertyName and propertyValue parameters to define that a new property is to be added to the handler. removeProperty a list of one or more handler properties to be removed. addHandler the name of a handler to be added. removeHandler the name of a handler to be removed. Table 24–11 Cont. Parameters for configure LogHandler Parameter Description Diagnosing and Tuning Oracle Reports 24-17

24.3.4.6 listLogs

You can use the listLogs command to view the list of one or more components. Table 24–12 describes the parameters supported by listLoggers command. Return Value A PyArray with one element for each log. The elements of the array are javax.management.openmbean.CompositeData objects describing each log. Examples Following are the examples for listLoggers command:

1. listLogs

2. listLogstarget=server1

3. listLogstarget=opmn:instance1ohs1

4. listLogsoracleInstance=middlewareuser_

projectsdomainsbase_domain, target=server1 addToLogger a list of logger names. The handler is added to the given logger names. removeFromLogger a list of logger names. The handler is removed from the given loggers. Note: The listLogHandlers command is not supported for system components, such as Reports Server and Reports Bridge. For more information about WLST commands, see Oracle Fusion Middleware WebLogic Scripting Tool Command Reference guide. Table 24–12 Parameters of listLogs Parameter Description target The name of the WebLogic Server, or a system component. In connected mode, the default target is the WebLogic domain, and in disconnected mode there is no default. oracleInstance in disconnected mode, oracleInstance defines the path to the ORACLE_INSTANCE, either a WebLogic domain home, or a non-Java EE instance home. This parameter is ignored in connected mode, required in disconnected mode. unit defines the unit to use for reporting file size.Valid values are B bytes, K kilobytes, M megabytes, G gigabytes, or H display size in a human-readable form, similar to Unixs ls -h option The default value is H. fulltime a Jython Boolean value. The default value is false Table 24–11 Cont. Parameters for configure LogHandler Parameter Description 24-18 Publishing Reports to the Web with Oracle Reports Services

24.3.4.7 displayLogs

You can use the displayLogs command to view the contents of diagnostic logs. Table 24–13 describes the parameters supported by listLoggers command. Return Value The command returns a value only when the returnData parameter is set to true. By default it will not return any data. The return value depends on the option used. Examples Following are the examples for displayLogs command:

1. displayLogstail=100

2. displayLogstarget=opmn:instance1ohs1, last=60

3. displayLogsgroupBy=[COMPONENT_ID, MSG_TYPE]

4. displayLogsquery=MSG_TYPE equals ERROR or MSG_TEXT contains

Exception

5. displayLogsquery=APP equals myApp, last=60

6. displayLogsquery=ECID equals

0000Hl9TwKUCslT6uBi8UH18lkWX000002 Note: ■ The listLogs command is supported for both Java EE and system components. ■ For more information about WLST commands, see Fusion Middleware WLST Command Reference Guide. Table 24–13 Parameters of displayLogs Parameter Description target The name of the WebLogic Server, or a system component. In connected mode, the default target is the WebLogic domain, and in disconnected mode there is no default. oracleInstance in disconnected mode, oracleInstance defines the path to the ORACLE_INSTANCE, either a Weblogic domain home, or a non-Java EE instance home. This parameter is ignored in connected mode, required in disconnected mode. query a string that specify an expression used to filter the contents of log files. A simple expression has the form field-name operator value, where field-name is a log record field name and operator is an appropriate operator for the field type. Note: ■ The listLogs command is supported for both Java EE and system components. ■ For more information about WLST commands, see Fusion Middleware WLST Command Reference Guide.