Oracle® E-Business Suite Diagnostics: User's Guide Release 12.1
Oracle® E-Business Suite Diagnostics: User's Guide Release 12.1
Oracle® E-Business Suite Diagnostics: User's Guide Release 12.1
User's Guide
Release 12.1
Part No. E12895-02
April 2009
Oracle E-Business Suite Diagnostics User's Guide, Release 12.1
Copyright © 2002, 2009, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks
of their respective owners.
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,
transmit, distribute, exhibit, perform, publish or display any part, in any form, or by any means. Reverse
engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf
of the U.S. Government, the following notice is applicable:
This software is developed for general use in a variety of information management applications. It is not
developed or intended for use in any inherently dangerous applications, including applications which may
create a risk of personal injury. If you use this software in dangerous applications, then you shall be
responsible to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of
this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this
software in dangerous applications.
This software and documentation may provide access to or information on content, products and services
from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all
warranties of any kind with respect to third party content, products and services. Oracle Corporation and its
affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third
party content, products or services.
Contents
Preface
iii
View Test Results................................................................................................................. 2-8
View Report......................................................................................................................... 2-9
Scheduled Tests................................................................................................................... 2-9
Configuring Oracle E-Business Suite Diagnostics Tests....................................................... 2-10
View Registered Applications............................................................................................ 2-10
Register Application.......................................................................................................... 2-11
View Groups...................................................................................................................... 2-11
Edit Group......................................................................................................................... 2-11
Create Group..................................................................................................................... 2-12
Reorder Group................................................................................................................... 2-12
View Tests.......................................................................................................................... 2-12
View Test Details............................................................................................................... 2-13
Edit Test............................................................................................................................. 2-14
View Test Inputs................................................................................................................ 2-14
Create Test......................................................................................................................... 2-14
Reorder Tests..................................................................................................................... 2-15
Profile Options........................................................................................................................ 2-15
A Known Limitations
Known Limitations................................................................................................................... A-1
iv
Send Us Your Comments
Oracle welcomes customers' comments and suggestions on the quality and usefulness of this document.
Your feedback is important, and helps us to best meet your needs as a user of our products. For example:
• Are the implementation steps correct and complete?
• Did you understand the context of the procedures?
• Did you find any errors in the information?
• Does the structure of the information help you with your tasks?
• Do you need different information or graphics? If so, where, and in what format?
• Are the examples correct? Do you need more examples?
If you find any errors or have any other suggestions for improvement, then please tell us your name, the
name of the company who has licensed our products, the title and part number of the documentation and
the chapter, section, and page number (if available).
Note: Before sending us your comments, you might like to check that you have the latest version of the
document and if any concerns are already addressed. To do this, access the new Applications Release
Online Documentation CD available on My Oracle Support and www.oracle.com. It contains the most
current Documentation Library plus all documents revised or released recently.
Send your comments to us using the electronic mail address: appsdoc_us@oracle.com
Please give your name, address, electronic mail address, and telephone number (optional).
If you need assistance with Oracle software, then please contact your support representative or Oracle
Support Services.
If you require training or instruction in using Oracle software, then please contact your Oracle local office
and inquire about our Oracle University offerings. A list of Oracle offices is available on our Web site at
www.oracle.com.
v
Preface
Intended Audience
Welcome to Release 12.1 of the Oracle E-Business Suite Diagnostics User's Guide.
This guide assumes you have a working knowledge of the following:
• The principles and customary practices of your business area.
If you have never used Oracle Applications, we suggest you attend one or more of the
Oracle Applications training classes available through Oracle University.
See Related Information Sources on page viii for more Oracle Applications product
information.
Documentation Accessibility
Our goal is to make Oracle products, services, and supporting documentation accessible
to all users, including users that are disabled. To that end, our documentation includes
features that make information available to users of assistive technology. This
documentation is available in HTML format, and contains markup to facilitate access by
the disabled community. Accessibility standards will continue to evolve over time, and
vii
Oracle is actively engaged with other market-leading technology vendors to address
technical obstacles so that our documentation can be accessible to all of our customers.
For more information, visit the Oracle Accessibility Program Web site at
http://www.oracle.com/accessibility/.
Structure
1 Oracle E-Business Suite Diagnostics Overview
2 Using Oracle E-Business Suite Diagnostics
A Known Limitations
viii
updated frequently.
Related Guides
You should have the following related books on hand. Depending on the requirements
of your particular installation, you may also need additional manuals or guides.
Oracle Applications User's Guide
This guide explains how to navigate, enter data, query, and run reports using the user
interface (UI) of Oracle Applications. This guide also includes information on setting
user profiles, as well as running and reviewing concurrent requests.
Oracle Applications Concepts
This book is intended for all those planning to deploy Oracle E-Business Suite Release
12, or contemplating significant changes to a configuration. After describing the Oracle
Applications architecture and technology stack, it focuses on strategic topics, giving a
broad outline of the actions needed to achieve a particular goal, plus the installation and
configuration choices that may be available.
Oracle Applications Developer's Guide
This guide contains the coding standards followed by the Oracle Applications
development staff. It describes the Oracle Application Object Library components
needed to implement the Oracle Applications user interface described in the Oracle
Applications User Interface Standards for Forms-Based Products. It provides information to
help you build your custom Oracle Forms Developer forms so that they integrate with
Oracle Applications. In addition, this guide has information for customizations in
features such as concurrent programs, flexfields, messages, and logging.
Oracle Applications System Administrator's Guide Documentation Set
This documentation set provides planning and reference information for the Oracle
Applications System Administrator. Oracle Applications System Administrator's Guide -
Configuration contains information on system configuration steps, including defining
concurrent programs and managers, enabling Oracle Applications Manager features,
and setting up printers and online help. Oracle Applications System Administrator's Guide
- Maintenance provides information for frequent tasks such as monitoring your system
with Oracle Applications Manager, administering Oracle E-Business Suite Secure
Enterprise Search, managing concurrent managers and reports, using diagnostic
utilities including logging, managing profile options, and using alerts. Oracle
Applications System Administrator's Guide - Security describes User Management, data
ix
security, function security, auditing, and security configurations.
Integration Repository
The Oracle Integration Repository is a compilation of information about the service
endpoints exposed by the Oracle E-Business Suite of applications. It provides a
complete catalog of Oracle E-Business Suite's business service interfaces. The tool lets
users easily discover and deploy the appropriate business service interface for
integration with any system, application, or business partner.
The Oracle Integration Repository is shipped as part of the E-Business Suite. As your
instance is patched, the repository is automatically updated with content appropriate
for the precise revisions of interfaces in your environment.
x
1
Oracle E-Business Suite Diagnostics
Overview
Introduction
Oracle E-Business Suite Diagnostics provides application specific troubleshooting tools
that can help shorten problem-resolution time.
Oracle E-Business Diagnostics has two major components. They are:
• Oracle Diagnostics Framework
Target Audience
The target audience for this manual includes the following:
System Administrators
As a system administrator, running diagnostic tests allows you to check the health of
your system. You can use diagnostic tests to identify and resolve problems related to:
• Environment
• Post-installation setup
If you cannot successfully resolve the problem on your own, you can send the report
generated by the tests to Oracle Support.
Implementation Engineers
When performing implementations, you are advised to run diagnostics after every
installation or patching process to confirm that the environment is set up correctly and
there are no outstanding issues to be resolved.
Features
Features include:
• Easy and user-friendly UI to diagnose issues by executing tests
• Support for a set of applications that can be valid for a given test
• Preference profile options for setting default applications and a default report
format
• Performance profile options for setting collection thresholds, SQL block size, and
worker thread count
Benefits
Benefits include:
• Identify problems at customer's site
• Generate a detailed report which Oracle support and development teams can
analyze for further troubleshooting
Terminology
Here is a list of terms used in this manual.
Application
Application refers to any application that is bundled in Oracle E-Business Suite.
Group
An ordered set of one or more related tests based on functionality. Every application
has one or more groups.
Test
The actual program that is run to diagnose the problem.
Test Set
A logical grouping of tests across applications and groups that can be used to diagnose
a particular business transaction.
Architecture
The architecture for the Oracle Diagnostics Framework constitutes of the following
components:
• A user interface for configuration, execution, and viewing the detailed report
results
• PL/SQL
• Declarative - In this case the diagnostic logic can be configured using UI. So no
coding is required to diagnose an issue.
Diagnosing an Issue
This section describes methods on how to use Oracle E-Business Suite Diagnostics to
troubleshoot an issue.
By Executing a Test
Click on the Application Diagnostics responsibility from the Oracle E-Business Suite
• Report Format - Available only for tests written using the new 12.1 reporting APIs.
The Report Format dropdown list is shown only if you have selected the check box
for downloadable report. The available formats are HTML, PDF, EXCEL and RTF.
For legacy tests the report format remains HTML.
Enter the needed values and click the Submit button. The results page will be
displayed, showing the progress. Click on the Refresh button if the execution is still in
progress. Once the test execution is complete, you can view the report online or
download it.
Test Set
Selecting multiple tests every time to diagnose an issue can be cumbersome, so Oracle
Diagnostics provides the facility to save the selection for reuse. It is saved as an XML
file in the database and includes the input values entered. Confidential inputs (like
passwords) are stored in encrypted form.
After selecting the tests and configuring the input values, click on Save Test Set, give
the test set a unique name, and save it.
Test Set pages can be directly accessed through the subtab by the same name under the
Diagnose tab. You can search for test sets using the name; wild card searches are
supported.
You can execute the test set, edit it to add/remove tests or change the input values of
any existing tests, duplicate it to create a new one with any changes needed, or delete it.
Another useful feature is to download the test set as an XML file to a local hard drive.
Once downloaded the selection can be ported to another instance and can be uploaded
using the Upload Test Set button.
Synchronous Execution
Execution of diagnostic tests always occurs in a separate thread. The main thread is
used to update users with progress in the user interface. However, there are some tests
that cannot be executed in a separate thread due to technical reasons associated with the
diagnostic logic (like a dependency on an HTTP request or response). Such tests cannot
be executed as part of a test set nor can the be scheduled. These tests can be executed as
single tests. These tests should be marked according to development guidelines so that
Scheduling a Test
Scheduling of tests is done via the Concurrent Processing infrastructure. The concurrent
request cannot be submitted separately, it must be run only from the Oracle Diagnostics
Framework UI.
Click on the Application Diagnostics responsibility from the Oracle E-Business Suite
home page. From the three menus, select the menu Diagnose. Select the test and click
on the Schedule button. Provide the request name and specify whether a downloadable
report is needed or not. Inputs for scheduled tests cannot be given "on the fly" because
the execution might happen at a future time. Therefore the engine uses pre-configured
input values that are stored in the database. Clicking on the Submit button takes you to
the Concurrent Processing pages where more details related to scheduling can be
entered before submitting the request. Once the request is submitted, you will be
redirected to the Scheduling subtab under the View Reports tab. You can monitor the
progress using this page (see the section Reporting for more details). If you schedule
the test to be repeated, then the system appends the Concurrent Processing request ID
to the request name, making each request unique.
Customization Support
Oracle E-Business Diagnostic Framework now makes it possible for users with custom
responsibilities to run diagnostic tests. For example, applications that have been cloned
from a seeded Oracle application can include these custom responsibilities. Also,
customers running localizations can create a custom role and a custom grant that map
to an Oracle seeded application. Once these tasks are done, the system will recognize
the mapping between custom/localized applications and seeded applications. The
responsibility LOV provided by the framework will show the responsibilities of the
user associated with custom applications.
Setting up for the execution of tests using custom responsibility with a seeded
application includes these tasks:
• Create a new role one per seeded application that needs to be customized.
• The Role Code uses ODF_CUSTOM_<Seeded Application Short Name>_Role
format.
Note that Oracle User Management updated the role name by prepending
'UMX|' to the role code entered.
• Set 'ODF_EXECUTION_PS'
Once this setup is done, the system will recognize mapping between custom/localized
applications and seeded applications. The responsibility LOV provided by the
framework will start showing the responsibilities of the user associated with custom
applications.
Reporting
Click on the Application Diagnostics responsibility from the Oracle E-Business Suite
Scheduling
You can specifically search for scheduled tests using the Scheduling subtab under
View Reports. A search can be conducted based on the dates or the concurrent request
ID, as well as the request name using wildcard support. The results are shown in a
table. A refresh icon is available to refresh the data. In the table are columns with
diagnostics request name and the concurrent request ID. Both of these are links that can
be used to drill down for details. The diagnostics request name gives you the details of
the diagnostic execution and the concurrent request ID will give details on the
concurrent request. In the diagnostic request name column, the link will not be enabled
until the request is picked up by the diagnostic execution engine.
Purging
Use the concurrent program Delete Diagnostic Logs to purge the old logs. You can
specify values for the two parameters:
• Days Expire - Logs older than this will be deleted.
• Application short names - Logs of the applications listed will be purged. Specify a
comma-separated list of values.
Security
Overview
Security in diagnostics is implemented at two levels, UI and data. The UI is secured
using function security and the content as well as actions available within each page is
controlled using data security
Data Security
Data security is achieved using Role Based Access Control (RBAC). The actions that a
user can perform are grouped into different categories. Roles are created and Grants
are given to each role to perform different categories of actions. The section below
describes the implementation data security. We assume that the user has some basic
understanding of RBAC. Please see the RBAC documentation in Oracle Applications
System Administrator's Guide - Security to learn more.
Sensitivity
Sensitivity is an attribute of the test that indicates the kind of data it is dealing with.
There are three levels - High, Medium and Low.
Permission
A permission is, as the name suggests, the permission to do an action. There are four
permissions in diagnostics.
• Execute a test
• Configure diagnostics
Permission sets
This is a logical grouping of permissions. Grants are given using permission sets. There
are three permission sets in diagnostics
• Execution permission set
• Execute a test
• Pre-Configure inputs
The execution permission set has the permission to execute a diagnostic test and
pre-configure input values for the test.
The reporting permission set has the permission to view the detailed report of an
execution. The reporting permission set is a child of execution permission set so that
any user who has the latter will also get the former. It is possible to change this
configuration (see the section Customizing Security).
The configuration permission set has the permission to configure diagnostics.
Roles
Diagnostics comes with three roles. A user must have any one of these roles to do
diagnosis. All three roles have the Application Diagnostics responsibility attached to it
so that UI access is available by default. Following are the three roles:
• Diagnostics Super User - Has unrestricted execution and configuration access
• Application Super User - Is able to execute any high or medium sensitivity test, if he
or she has a valid responsibility either in the application under which the test is
registered or in any of the application, which is configured as valid for test.
• Application End User - is able to execute any medium sensitivity test, if he or she
has a valid responsibility either in the application under which the test is registered
or in any of the application, which is configured as valid for test.
• Users with any diagnostic role can access low sensitivity tests registered under any
application.
Security Matrix
Select, Execute Tests, Yes All tests valid for All tests validate for
View Execution Application that are Application that are
Results high, medium, or low medium, or low
sensitivity and the sensitivity and the
user has a valid user has a valid
responsibility responsibility
Grants
Grants are used to give access to different roles. The JTF_DIAGNOSTIC_TEST table is
used to give execution/reporting grants while the JTF_DIAGNOSTIC_APP table is used
to give configuration grants. Diagnostics ships four grants:
• Diagnostic Super User Execution Grant - Gives Execution Permission Set to all
instances of JTF_DIAGNOSTIC_TEST table.
Customizing Security
Customer can customize the security model if they do not want to use the roles shipped
out of the box. To do this, they must
• Create a new role.
• Give a grant to this role using the Diagnostic Execution instance set.
HTML Platform
This application is a non-secure application and all users have full access to all tests
under it. This application is used to diagnose the issues related to security if security is
not working properly.
Configuration
This section briefly describes the tasks involved in configuring Oracle Diagnostics
Framework. For more information on these tasks, see the next chapter.
Register Application
Tests are owned by applications. Each application must be registered. Use the Register
Application page to register applications.
Create/Edit/Delete/Re-Order Group
Tests in an application can be organized into groups. Use these pages to manage your
groups.
Pre-Configured Inputs
Pre-configured inputs are input values for a test entered during configuration, prior to
running the test.
Introduction
Oracle E-Business Suite Diagnostics pages are available through the Applications
Diagnostics responsibility. From this responsibility, you can access three types of
functions:
• Diagnose, page 2-1
In addition, profile options used by Oracle E-Business Suite are described at the end of
this chapter.
Diagnostic Tests
Oracle E-Business Suite Diagnostics provides several methods for running diagnostic
tests: executing a single test, executing a test set, or scheduling a test through Standard
Request Submission. Tasks include:
• Select Test, page 2-2
Select Test
You can execute diagnostic tests using this page.
Note: Only tests which you have permissions to execute will be listed
in the HGrid table.
Click on the Select Application button to populate the HGrid table with registered
applications. To find an application, enter an application name or partial application
name with wildcard(s) and click the Go button. Alternatively you can search on
"Application Short Name". Multiple application names or short names are allowed, but
must be separated by commas.
Each registered test will show a Select check box to be used when selecting a test to
execute.
Click on Focus to drill down on an application or group.
Additional details are shown:
• The Tests column shows the application name, group name, and related tests that
are available to execute.
• The Last Status column indicates whether the tests completed successfully or with
errors. A check mark represents that the test completed successfully, while a
box/square indicates that the test is pending, and an X mark indicates that the test
completed with warnings and possible errors.
• Last Execution Time shows the date and time when the test was last executed.
• Last Failure Time shows the date and time of the last failed execution.
Click on the Execute button to execute one or more tests. If multiple tests are selected
and the Execute button is clicked, the action is treated as clicking the Add to batch
button
Click on the Add to batch button to execute one or more tests or to create a test set.
To run the test with pre-configured inputs, select the test and click Add to batch. Click
on the Test Inputs link and select the pre-configured inputs.
Click on the Schedule button to schedule the execution of a test using concurrent
Execute Test
Execute a test using this page.
You can choose to accept the defaulted request name or enter another request name.
You can check the Generate downloadable report box if the user wants a downloadable
report. This check box does not appear for legacy tests where HTML is the only
supported format.
If the Generate downloadable report box is checked, select the download format from
the list. If the test requires Inputs this page prompts you to enter the input parameters.
Click the Cancel button to cancel the execution of a test.
Click the Submit button to execute the test.
• Generate Downloadable Report - When this box is checked, the report becomes
available for download and you can select the format of the downloaded report.
• Add more tests button - Add additional tests to the test set execution.
• Test Input - This option appears for tests that require input. Click on the Input icon
to enter your input parameters.
• Inputs Available - This option appears for tests that require input. Two possible
icons are shown; an icon of an X indicates that input parameters are required and
an icon of a check mark indicates that the test input parameters have been entered.
Click Cancel to cancel your changes and return to the Select Test page.
Click Save Test Set to save the test set in the resulting page. You will be prompted for
the name and description of the test and to save the test set to your local file system.
Click Submit to execute the test set.
The Pre-Configured Inputs region shows all input parameters with the exception of
Confidential Inputs.
The Custom Inputs region shows all input parameters that can be entered; mandatory
input parameters are prefixed with an asterisk.
You can click on the Add another row button to add input parameters.
You can click on the Remove button to delete configured inputs.
Use the Cancel button to return to the Execute Test Set page.
Use the Apply button to save the inputs you entered.
View Reports
You can search for reports using this page.
Search on the request name to show the report details. Note that the request name is
case-sensitive and searching with wildcard characters is not supported.
Click the Go button to retrieve the report for the request name entered.
Click the Advanced Search button to increase your search options to find a report.
Search options include:
• Application: search for all the tests that have been executed for a specific
application.
• Group: search for all the tests that have been executed for a specific group.
• Test Executable Name: search for all the tests that have been executed for a specific
test execution name.
You can search on the Test Execution Status in combination with an Application,
Group, Test Execution Name, From Date, and To Date. You can also search for only
those executions in the current session to retrieve tests with statuses of Success, Failure,
• To Date
• You can click on the check box to view only the test executions within a current
session.
Click the Go button to retrieve the report(s) for the advanced search option used.
Within the Results region, you can:
• Click on Expand All to view the reports as a result of the search entered.
• Click on All Applications to remove the focus and view all applications as a result
of the search criteria Tests shows the application name, group name, and related
tests as a result of the search criteria. Applications and Groups can be collapse or
expanded.
• Total Executions shows the number of times a test has been executed as a result of
the search criteria. If the count is greater than zero then you can drill down to view
the individual reports.
• Success shows the number of times a test has completed without warnings or
failures. If the count is greater than zero then you can drill down to view the
individual reports.
• Warnings shows the number of times a test has completed with warnings. If the
count is greater than zero then you can drill down to view the individual reports.
• Failures shows the number of times a test has completed with failures. If the count
is greater than zero then you can drill down to view the individual reports.
• In Queue shows the number of tests that are in the queue and scheduled to execute.
• Last Refreshed On - the date and time when the page was refreshed for the last
time.
• View Report - shows a check mark if the report is available to view, shows a clock if
the test is still executing, or shows an 'X' meaning the test completed with warnings
and/or errors. Once the report is available to view, you can click on the check or 'X'
icon to get details.
The Execution Details region includes test inputs with the exception of confidential
inputs.
The Return to Select Test button - takes you back to the tests selection page
The Refresh button is used to refresh the page with the latest status of the execution
View Report
You can view the report of a specific execution of a test using this page.
The Execution Details region includes:
• Application - the application name associated with the test.
• Group - the name of the group with which the test is associated.
• Result - the result of the diagnostic test, that is, success or failure.
• Time Taken - the total elapsed time for the test execution.
The Inputs region lists all of the input parameters used to execute the test.
The Report region shows all details of the report.
The Return to Execution Results link returns you back to the View Reports page.
Use the Download Report button to download the report to your local PC. If the report
generation is still in progress, a Refresh button appears instead. Refresh the page to
check the report generation status.
Use the Upload to Support button to upload the report to Oracle Support. You will be
prompted to enter a My Oracle Support Service Request Number and to upload the
downloaded report from your PC.
Scheduled Tests
You can view the Scheduled Tests using this page.
You can search for a test using the Request Name (with wildcard support with "%"), the
Request ID, or the date submitted.
The Diagnostics Concurrent Request region includes the following information.
The Request Name shows all requests that have been executed, running, or scheduled.
Information shown includes the request name, the requestor, test name, date & time,
and request ID. Clicking on the request name takes you to the View Report screen.
The Request ID is the concurrent request ID assigned to the scheduled test. Clicking on
• Requestor shows the user ID of the person who scheduled the test.
• Phase shows the concurrent manager phase (pending, running, and so on).
• Status shows the concurrent manager status (scheduled, normal, and so on).
Register Application
You can register a new application in this page. The list of unregistered applications
will be displayed in the list of values.
Click the Apply button to register a new application.
You can click the Cancel button to cancel registering application.
View Groups
You can view all the groups registered under an application using this page.
If you have come to this page from the View Registered Applications page, then the
selected application will be shown in the LOV field.
Alternatively, you can come directly to this page through the Groups subtab.
A search can be conducted using the application name and group name. If the group
name is left blank all the groups under the application will be displayed.
Details shown include the number of registered test under each group.
Click on the Update icon to update the details of the group. This action is restricted to
only those users who have configuration privileges.
Click on the Delete icon to delete the group. This action is restricted to only those users
who have configuration privileges
Click on the Reorder button to change the order in which the groups are organized
under the parent application. This action is restricted to only those users who have
configuration privileges.
Click on the Create Group button to create a new group. This action is restricted to only
those users who have configuration privileges.
Click on the View Tests button to view all the tests registered under this group.
Edit Group
You can change the name of a group.
You can change the placement of a given group in the group order of its parent
application.
Reorder Group
You can reorder groups using this page.
Select the group to change the order in which the groups are organized under the
parent application.
Select a group and click on the "Move to the top" icon to move the selected group to the
top of the list.
Select a group and click on the Up icon to move the selected group up one in the list.
Select a group and click on the Down icon to move selected group down one in the list.
Select a group and click on the "Move to the bottom" icon to move the selected group to
the bottom of the list.
Click Cancel to cancel the reordering of the groups.
Click Apply to commit the reordering of the groups.
View Tests
You can view all the tests registered under a group.
If you have navigated to this page from the View Groups page, then the selected
application and group will be shown in the LOV field.
You can directly navigate to this page through the Tests subtab.
A search can be conducted using the Application name and Group name. If the
program name field is left blank, then all the program names under the group will be
displayed.
Click on the View Input values button to view current input values and to add
additional rows. This button will be enabled only if the user has permission to execute
the test.
Click on the Create Test button to create a new test. This action is restricted to only
those users who have configuration privileges.
The following are actions that are restricted to only those users with configuration
privileges.
• Click on the eyeglasses icon to view test details.
Edit Test
Edit a test using this page.
The following fields are shown:
• The name of the application for which the test is registered.
Click on Order in the action list to change the order of the test within the group.
Click on Sensitivity in the action list to change the security sensitivity of the test.
Create Test
Create diagnostic tests using this page.
You can select the Application Name using the LOV.
Reorder Tests
You can reorder tests using this page.
Select the test and change the order in which the tests are organized under a group.
Only user-defined groups can be changed.
Select a test and click on the Up icon to move selected items to the top of the list.
Select a test and click on the Up icon to move selected items up one in the list.
Select a test and click on the Down icon to move selected items down one in the list.
Select a test and click on the Down icon to move selected items to the bottom of the list.
Click on the Cancel button to cancel your changes.
Click on the Apply button to commit your changes.
Profile Options
You can configure your system with the following profile options. After changing the
values, you must sign out and clear the cache. All these profiles are at the site level.
User-level profiles are not supported currently.
Favorite Application
The Favorite Application profile option allows users to set a default application; once
set the default application will show on the Diagnose page. Only one favorite
Note that the values for Default Reporting Format are case-sensitive and the profile
expects lowercase.
The internal name is OAM_DIAG_DEFAULT_REPORT_FORMAT.
Collection Threshold
The Collection Threshold profile option allows users to set the number of reports nodes
that must be kept in memory before being saved to the database. This threshold helps
support huge volume diagnostic reports. If the number of components in the report
exceeds this threshold, then the report is moved to the database to free up memory.
Set this profile to the threshold number of components before saving to the database.
The internal name is OAM_DIAG_COLLECTION_THRESHOLD.
Known Limitations
Known limitations of the Oracle Diagnostics Framework are:
File Types
Currently the only acceptable file types are Java and PL/SQL.