Home >	Contents >	Index >
Template Tag TOC  |   Alpha TOC  |   Tag Family TOC  |   Purpose TOC  |   Annotated TOC  |   Index

APPEVENT

Creates an event that executes an application logic at a specified time.

Syntax

<APPEVENT NAME="APP EVENT NAME" 
          GUID="GUID" 
          TIMES="hh:mm:ss W/DD/MM">
   <ARGUMENT NAME="ARG_NAME" VALUE="ARG_VALUE"/>
</APPEVENT>

Parameters

NAME (required)

Name of the event to create.

GUID (required)

Name of the servlet to be called when the event is triggered.

TIMES (required)

The time at which the event is triggered. Use the following format:

   hh:mm:ss W/DD/MM
   

where:

• hh: (hours) 0 -23
• mm: (minutes) 0 - 59
• ss: (seconds) 0 - 59
• W (day of the week): 0-6 with 0 = Sunday.
• DD (day of the month): 1 - 31
• MM (month): 1 - 12

For each of these fields, you can use an asterisk (all legal values) or a list of elements separated by commas. A value can be one or more numbers separated by a minus sign to indicate an inclusive range. For example, 2, 5 - 7:0:0 5/*/* means the event is triggered at 2 a.m., 5 a.m., 6 a.m., and 7 a.m. every Friday.

Specify days by two fields: day of the month (DD) and day of the week (W). If you specify both, both take effect. For example, 1:0:0 1/15/* means the event is triggered at 1 a.m. every Monday, as well as on the fifteenth of each month. To specify days by only one field, set the other field to an asterisk (*).

Description

The APPEVENT tag creates an event that executes an application logic at a specified time. Values can be passed to the application logic when it is called by using the ARGUMENT tag.

errno

The possible values of errno include:

Value	Description
-200	Failed to register event.
-201	Exception in event. (May appear as -200.)

Example

The following example registers an event that is triggered every day at 1:10 in the afternoon. At that time, Content Server invokes the pagename API/Main:

<SETVAR NAME="errno" VALUE="0" />
<APPEVENT NAME="AppEvent" 
          GUID="ContentServer"  
          TIMES="13:10:00 */*/*">
      <ARGUMENT NAME="pagename" VALUE="API/Main"/>
</APPEVENT>
<IF COND="IsError.Variables.errno=true">
	 	 <THEN>
	 	 <!--Handle error-->
	 	 </THEN>
</IF>

See Also

ARGUMENT

		Home >	Contents >	Index >
	FatWire XML Tag Reference Copyright 2005 by FatWire Software All rights reserved.