User: schaefera
Date: 02/01/18 02:25:25
Modified: src/xdocs/howto howtotimer.2.xml
Log:
Update the Timer and Scheduler HowTo to reflect the latest changes.
Revision Changes Path
3.1 +31 -3 manual/src/xdocs/howto/howtotimer.2.xml
Index: howtotimer.2.xml
===================================================================
RCS file: /cvsroot/jboss/manual/src/xdocs/howto/howtotimer.2.xml,v
retrieving revision 3.0
retrieving revision 3.1
diff -u -r3.0 -r3.1
--- howtotimer.2.xml 2001/11/18 20:10:58 3.0
+++ howtotimer.2.xml 2002/01/18 10:25:25 3.1
@@ -353,7 +353,7 @@
"I call you with this timer ten times",
// No user object
null,
- // In one minute from now
+ // In one hour from now
lNext,
new Long( Timer.ONE_MINUTE ),
new Long( 10 )
@@ -569,8 +569,36 @@
<term>InitialStartDate</term>
<listitem>
<para>
- Date (in milliseconds since 1/1/1970) when the Timer sends the
first Time Notification.
- Any date in the past means it starts right now.
+ You have now 3 ways to set the Initial Start Date:
+ <itemizedlist>
+ <listitem>
+ NOW: Current date when the Scheduler is started
+ </listitem>
+ <listitem>
+ Milliseconds since 1/1/1970: Date (in milliseconds since
1/1/1970) when the
+ Timer sends the first Time Notification.
+ </listitem>
+ <listitem>
+ Date Pattern as String: Date as a String understood by
the
+ java.text.SimpleDateFormat (please check your
environment). For US this
+ looks like this: 2/5/02 11:15 am (Fith of February 2002,
eleven fifeteen
+ in the morning).
+ </listitem>
+ </itemizedlist>
+ Note that when a date is set in the past the Scheduler will
see if the Schedule
+ would have a hit in the future with the given period and
number of repetitions.
+ If the number of repetitions is endless the Scheduler will
start at the first
+ scheduled time in the future with respect to the start date
and period. Otherwise
+ if a hit is in the future the Schedule will schedule this one
but also reduce
+ the number of hits which were in the past. If no hit is in the
future the Schedule
+ will be inactive even thought it is started.
+ </para>
+ <para>
+ The reason to do so is to allow an administrator to restart
the JBoss application
+ server without adjusting the Scheduler every time. If for
example you started a
+ Scheduler on Monday to run every day at 12:00pm for a week (7
times) and you
+ restart JBoss on Thursday after 12:00pm the same week then the
Scheduler will
+ run for Friday, Saturday and Sunday at 12:00pm.
</para>
</listitem>
</varlistentry>
_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/jboss-development
