Timedef Configuration Mode Commands


Timedef Configuration Mode Commands
 
 
The Timedef Configuration Mode enables configuring the Time-of-Day Activation/Deactivation feature.
Important: This configuration mode is only available in StarOS 8.1 and StarOS 9.0 and later releases.
 
Important: The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).
 
end
This command returns the CLI prompt to the Exec mode.
Product
All
Privilege
Security Administrator, Administrator
Syntax
end
Usage
Use this command to change to the Exec mode.
 
exit
This command exits the current configuration mode and returns to the parent configuration mode.
Product
All
Privilege
Security Administrator, Administrator
Syntax
exit
Usage
Use this command to return to the parent configuration mode.
 
start
This command configures timeslots in the current timedef.
Important: This command is only available in StarOS 8.1 and StarOS 9.0 and later releases.
Important: A maximum of 24 timeslots can be specified within a timedef.
Product
All
Privilege
Security Administrator, Administrator
Syntax
[ no ] start day { friday | monday | saturday | sunday | thursday | tuesday | wednesday } time hh mm ss end day { friday | monday | saturday | sunday | thursday | tuesday | wednesday } time hh mm ss
[ no ] start time hh mm ss end time hh mm ss
no
Removes the specified timeslot.
start day { friday | monday | saturday | sunday | thursday | tuesday | wednesday } time hh mm ss end day { friday | monday | saturday | sunday | thursday | tuesday | wednesday } time hh mm ss
Specifies a timeslot with a start day and time, and an end day and time.
start day: Specifies the start day and start time.
end day: Specifies the end day and end time.
time hh mm ss: Specifies the start/end time:
hh: Specifies the start/end hour, and must be an integer from 0 through 23.
mm: Specifies the start/end minute, and must be an integer from 0 through 59.
ss: Specifies the start/end second, and must be an integer from 0 through 59.
start time hh mm ss end time hh mm ss
Specifies a timeslot with a start time and an end time to be applicable for all days of the week.
In specifying the start/end time:
hh: Specifies the start/end hour, and must be an integer from 0 through 23.
mm: Specifies the start/end minute, and must be an integer from 0 through 59.
ss: Specifies the start/end second, and must be an integer from 0 through 59.
Usage
Use this command to create timeslots in a timedef during which rules have to be active. Timedefs enable activation/deactivation of ruledefs/groups-of-ruledefs such that they are available for rule matching only when they are active.
When a packet is received, and a ruledef/group-of-ruledefs is eligible for rule matching, if a timedef is associated with the ruledef/group-of-ruledefs, before rule matching, the packet-arrival time is compared with the timeslots configured in the timedef. If the packet arrived in any of the timeslots configured in the associated timedef, rule matching is undertaken, else the next ruledef/group-of-ruledefs is considered.
Important: The time considered for timedef matching is the system’s local time.
This release does not support configuring a timeslot for a specific date.
If, in a timeslot, only the time is specified, that timeslot will be applicable for all days.
If for a timeslot, “start time” > “end time”, that rule will span the midnight. I.e. that rule is considered to be active from the current day till the next day.
If for a timeslot, “start day” > “end day”, that rule will span over the current week till the end day in the next week.
In the following cases a rule will be active all the time:
Example
The following example specifies a timeslot that starts on Tuesday at 09:00:00 and ends on Friday 21:30:00:
start day tuesday time 9 0 0 end day friday time 21 30 0
The following example specifies a timeslot that starts at 15:00:00 and ends at 17:00:00 on all days of the week:
start time 15 0 0 end time 17 0 0
The following example specifies a timeslot that starts on Friday at 22:00:00 and ends on Tuesday at 08:00:00. This timeslot spans the complete week until the end day, i.e. up to Tuesday.
start day friday time 22 0 0 end day tuesday time 8 0 0
The following example specifies a timeslot that starts at 16:00:00 and ends at 09:00:00 on all days of the week. Also, as start time > end time, this timeslot spans the midnight too. I.e., from 16:00:00 to 23:59:59 and from 00:00:00 to 09:00:00.
start time 16 0 0 end time 9 0 0
 
 

Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883