Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documentation
• Conventions

1 Overview of Oracle Application Server Containers for J2EE

• 1.1 Job Scheduler Concepts and Terminology
• 1.1.1 Notifications and Triggers
• 1.1.2 Schedules
• 1.1.3 Blackout Windows
• 1.2 Basic Job Scheduler Implementation Example

2 Adding and Removing Jobs

• 2.1 Adding Jobs
• 2.1.1 Implementing a Job with the Executable Interface
• 2.1.2 Submitting a Job
• 2.1.3 Examples of Adding Jobs
• 2.2 Accessing Job Scheduler Using JNDI Lookup
• 2.3 Removing Jobs
• 2.4 Best Practices for Adding and Removing Jobs
• 2.5 Frequently Asked Questions About Adding and Removing Jobs

3 Oracle Application Server Containers for J2EE Scheduling Options

• 3.1 Schedule-Based Jobs
• 3.1.1 Single-Action Schedules
• 3.1.2 Repeating Schedules
• 3.1.2.1 Fixed-Interval Schedules
• 3.1.2.2 Fixed-Delay Schedules
• 3.1.2.3 iCalendar Recurrence Schedules
• 3.2 Retry Period and Execution Threshold
• 3.2.1 Retry Period
• 3.2.2 Execution Threshold
• 3.2.3 Submitting a Job with a Retry Period and Execution Threshold
• 3.3 Frequently Asked Questions About iCalendar and Execution Threshold

4 Oracle Application Server Containers for J2EE Blackout Windows

• 4.1 Adding and Removing Blackout Windows
• 4.2 Jobs Scheduled in Blackout Windows
• 4.3 Frequently Asked Questions About Blackout Windows

5 Pausing Jobs

• 5.1 What Does It Mean to Pause a Job?
• 5.2 How to Pause a Job
• 5.3 Frequently Asked Questions About Pausing Jobs

6 Canceling Jobs

• 6.1 What Does it Mean to Cancel a Job?
• 6.2 Canceling a Job
• 6.3 Frequently Asked Questions

7 Oracle Application Server Containers for J2EE Events and Listeners

• 7.1 Events and Event Listeners
• 7.2 Implementing and Binding a Event Listener
• 7.3 Best Practices for Implementing and Binding Event Listeners
• 7.4 Frequently Asked Questions About Job Listeners

8 Oracle Application Server Containers for J2EE Triggers and Notifications

• 8.1 Trigger-Driven Jobs
• 8.1.1 Triggers and Notifications
• 8.1.2 Cautions For Using the NOT Operator
• 8.2 How Do I Submit a Job with a Trigger?
• 8.3 How Do I Send Notifications to a Job?
• 8.4 Frequently Asked Questions About Triggers and Notifications

9 Deploying Job Scheduler-Enabled Applications

• 9.1 Bundling Job Scheduler with a J2EE Application
• 9.1.1 Generating the scheduler-ejb.jar File
• 9.1.2 Bundling scheduler-ejb.jar in an Enterprise Archive (EAR) File
• 9.2 Configuring Persistence for Job Scheduler
• 9.2.1 Configuring JDBC Persistence
• 9.2.2 Configuring JMS Persistence
• 9.3 Configuring Security for Job Scheduler
• 9.4 Configuring Logging for Job Scheduler
• 9.5 Configuring DMS for Job Scheduler
• 9.6 Configuring JMX for Job Scheduler
• 9.7 Configuring Execution Interval Threshold Recovery for Job Scheduler

10 Managing the Oracle Application Server Containers for J2EE

• 10.1 Job Management Bean
• 10.2 Job Scheduler Management Bean
• 10.3 Job Scheduler Aggregation Management Bean

A RFC 2445 Excerpt: Recurrence

• A.1 RFC 2445, Section 4.3.10. Recurrence Rule
• A.2 Job Scheduler Implementation of the Recurrence Rule
• A.3 RFC 2445, Section 4.8.5.4. Recurrence Rule Examples

B Oracle Application Server Containers for J2EE Semantics

• B.1 Semantics
• B.2 Job Precedence

C JSP Tag Library Reference

• C.1 Configuring an Application with the JSP Tag Library
• C.2 JSP Tag Library Summary
• C.3 JSP Tag Library Reference
• C.3.1 scheduler
• C.3.2 addJob
• C.3.2.1 className
• C.3.2.2 description
• C.3.2.3 schedule
• C.3.2.4 trigger
• C.3.2.5 retry
• C.3.2.6 logLevel
• C.3.3 removeJob
• C.3.4 pauseJob
• C.3.5 resumeJob
• C.3.6 cancelJob
• C.3.7 addBlackoutWindow
• C.3.8 removeBlackoutWindow
• C.4 JSP Tag Library Examples

D JMX MBean Reference

• D.1 Job Management Bean Attributes
• D.2 Job Scheduler Management Bean Attributes
• D.3 Job Scheduler Aggregation Management Bean Attributes
• D.4 Frequently Asked Questions About JMX MBeans

E Troubleshooting Oracle Application Server Containers for J2EE

• E.1 Oracle Diagnostic Logging (ODL)
• E.1.1 Types of Logging
• E.1.1.1 Implicit Job Logging
• E.1.1.2 Explicit Job Logging
• E.1.2 Configuring the Global Log Levels
• E.1.3 Logging Example
• E.2 DMS Metrics
• E.3 Frequently Asked Questions About Job Scheduler Monitoring
• E.4 Frequently Asked Questions About Job Scheduler Logging

Index