Wait - Until Date/Time

Declaration

<AMWAIT ACTIVITY="date_time" TIME="text (time serial)" 
DAY="text (options)" DATE="text (date serial)" />

Description: Pauses execution at the current step until a specific date/time. Can specific day of the week,  specified.

Practical Usage

Similar to the Wait for duration activity, can be used to pause task execution until the exact date/time.

General Parameters

Property

Type

Required

Default

Markup

Description

Wait until

Text

Yes

(Empty)

TIME="%TimeSerial(15,08,34)%""

The specific time to wait until. This value corresponds directly with the value selected in the Day parameter.

Day

Text (options)

No

Any Day

  1. DAY="any"

  2. DAY="sameday"

  3. DAY="nextday"

  4. DAY="day"

  5. DAY="specdate"

The day or specific date to wait until in accordance with the time specified in the Wait until parameter. The available options are:

  • Any day (default) - Day preferences are omitted.Execution proceedsat the timeentered in the Wait until parameter.

  • On the day the action is executed - Execution proceeds on the same day at the time entered in the Wait until parameter.

  • On the day following the day the action is executed - Execution proceeds on the following day at the time specified in the Wait until parameter.

  • On a specific day of the week - Execution proceeds on the specified day of the week at the time specified in the Wait until parameter.

  • On a specific date - Execution proceeds on a specific date at the time specified in the Wait until parameter.

Day of the week

Text (options)

Yes if set to Onspecific day of the week

Sunday

  1. DAYOFWEEK="sunday"

  2. DAYOFWEEK="monday"

  3. DAYOFWEEK="tuesday"

  4. DAYOFWEEK="wednesday"

  5. DAYOFWEEK="thursday"

  6. DAYOFWEEK="friday"

  7. DAYOFWEEK="saturday"

The task will pause at this step and resume execution The day of the week that this step will wait until. This parameter is available only if the Day parameter is set to On a specific day of the week. The available options are:

  • Sunday (default) -  Execution proceeds the following Sunday at the time specified in the Wait until parameter.

  • Monday - Execution proceeds the following Monday at the time specified in the Wait until parameter.

  • Tuesday - Execution proceeds the following Tuesday at the time specified in the Wait until parameter.

  • Wednesday - Execution proceeds the following Wednesday at the time specified in the Wait until parameter.

  • Thursday - Execution proceeds the following Thursday at the time specified in the Wait until parameter.

  • Friday - Execution proceeds the following Friday at the time specified in the Wait until parameter.

  • Saturday - Execution proceeds the following Saturday at the time specified in the Wait until parameter.

Specific Date

Text

Yes if set to Onspecific date

(Empty)

DATE="%DateSerial(2010,07,15)%"

The specific date that this step will wait until. This parameter is available only if the Day parameter is set to On a specific date.

Description tab - A custom description can be provided on the Description tab to convey additional information or share special notes about a task step.

Error Causes tab - Specify how this step should behave upon the occurrence of an error. (Refer to Task Builder > Error Causes Tab for details.)

On Error tab - Specify what AWE should do if this step encounters an error as defined on the Error Causes tab. (Refer to Task Builder > On Error Tab for details.)

Examples

The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder.

Description: Pause task until "6:00:00 AM" on the day after the task executes.

<AMWAIT ACTIVITY="date_time" TIME="%TimeSerial(06,00,00)%" DAY="nextday" />