Jump Command

The Jump command is used to branch to another page within the current script. The branching commands feature options to make branching conditional. Lightwing branches only if all of the defined conditions are true, otherwise execution continues with the next consecutive page in the current script.

Count Option

Defines a count condition of how many times this branch will be taken. When the count is exhausted, it is reset and the branch is not taken, which ends the loop.

       Example of a Page Loop that Loops 10 Times
  
        page: LoopPage    time 1, 5

        page: AnotherPage
              jump: LoopPage    count: 10

Day Option

Defines a specific day and/or time condition on which a branch will be taken.  This can be a time which reoccurs every day, or a day that reoccurs every week, or a month that reoccurs every year, or a specific calendar date and/or time event that only occurs once. The maximum number of conditions is 8 per page.

Time Condition Examples

        Examples                                              Occurrences

        12:00PM                                                  Every day at Noon.
        Monday                                                    Every Monday at Midnight.
        Tuesday 12:00PM                                   Every Tuesday at Noon.
        Wednesday January 12:00PM              Every Wednesday in January at Noon.
        1/1/2015                                                  First day of 2015 at Midnight
Example of a Page that Branches only on Weekends

page: FirstPage
     jump: WeekendPage    day: Saturday    day: Sunday

Before Option

Defines a specific day and/or time condition before which a branch will be taken. This can be a time which reoccurs every day, or a day that reoccurs every week, or a month that reoccurs every year, or a specific calendar date and/or time event that only occurs once. The date and time syntax is the same as shown for the day option above.

After Option

Defines a specific day and/or time condition after which a branch will be taken. This can be a time which reoccurs every day, or a day that reoccurs every week, or a month that reoccurs every year, or a specific calendar date and/or time event that only occurs once. The date and time syntax is the same as shown for the day option above.

Index Option

Defines a variable to select the branch target page for the Jump command. A list of page names must be provided followed by the index variable name. The value of the specified variable will select a page from the list where the first page is indexed by zero.  The maximum number of page names that can be listed is 24. If the value of the variable is greater than the number of page names listed, none of the branch pages are taken. Also, if any other condition options are combined with this option that are false, none of the branch pages are taken.

Branch Index Variables

        Names         Ranges
  
        Hour               0 to 23
        Day                    0 to 6
        Month             0 to 11
        Count              0 to 23
        Example of using the Day Variable to Branch on the Day of the Week

        page: FirstPage
                jump: MondaysPage, TuesdaysPage, WednesdaysPage, ThursdaysPage, FridaysPage, SaturdaysPage, SundaysPage    index: Day

Portrait Option

Defines a display orientation condition that must be met for the branch to be taken. This parameter must be either on or off.  The default is off, which means the display must have a landscape orientation for the branch to be taken. Otherwise, on means the display must have a portrait orientation for the branch to be taken.

 

 

<   Global Command                                             Introduction                                            Link Command   >