Class CIM_PolicyTimePeriodCondition
extends CIM_PolicyCondition

This class provides a means of representing the time periods during which a PolicyRule is valid, i.e., active. At all times that fall outside these time periods, the PolicyRule has no effect. A Rule is treated as valid at ALL times, if it does not specify a PolicyTimePeriodCondition. In some cases a Policy Consumer may need to perform certain setup / cleanup actions when a PolicyRule becomes active / inactive. For example, sessions that were established while a Rule was active might need to be taken down when the Rule becomes inactive. In other cases, however, such sessions might be left up. In this case, the effect of deactivating the PolicyRule would just be to prevent the establishment of new sessions. Setup / cleanup behaviors on validity period transitions are not currently addressed by the Policy Model, and must be specified in 'guideline' documents or via subclasses of CIM_PolicyRule, CIM_PolicyTimePeriodCondition or other concrete subclasses of CIM_Policy. If such behaviors need to be under the control of the policy administrator, then a mechanism to allow this control must also be specified in the subclasses. PolicyTimePeriodCondition is defined as a subclass of PolicyCondition. This is to allow the inclusion of time-based criteria in the AND/OR condition definitions for a PolicyRule. Instances of this class may have up to five properties identifying time periods at different levels. The values of all the properties present in an instance are ANDed together to determine the validity period(s) for the instance. For example, an instance with an overall validity range of January 1, 2000 through December 31, 2000; a month mask that selects March and April; a day-of-the-week mask that selects Fridays; and a time of day range of 0800 through 1600 would be represented using the following time periods: Friday, March 5, 2000, from 0800 through 1600; Friday, March 12, 2000, from 0800 through 1600; Friday, March 19, 2000, from 0800 through 1600; Friday, March 26, 2000, from 0800 through 1600; Friday, April 2, 2000, from 0800 through 1600; Friday, April 9, 2000, from 0800 through 1600; Friday, April 16, 2000, from 0800 through 1600; Friday, April 23, 2000, from 0800 through 1600; Friday, April 30, 2000, from 0800 through 1600. Properties not present in an instance of PolicyTimePeriodCondition are implicitly treated as having their value 'always enabled'. Thus, in the example above, the day-of-the-month mask is not present, and so the validity period for the instance implicitly includes a day-of-the-month mask that selects all days of the month. If this 'missing property' rule is applied to its fullest, we see that there is a second way to indicate that a PolicyRule is always enabled: associate with it an instance of PolicyTimePeriodCondition whose only properties with specific values are its key properties.

Class Hierarchy

CIM_ManagedElement
   |
   +--CIM_Policy
   |
   +--CIM_PolicyCondition
   |
   +--CIM_PolicyTimePeriodCondition

Direct Known Subclasses

None.

Class Qualifiers

NameData TypeValueScopeFlavors
Descriptionstring This class provides a means of representing the time periods during which a PolicyRule is valid, i.e., active. At all times that fall outside these time periods, the PolicyRule has no effect. A Rule is treated as valid at ALL times, if it does not specify a PolicyTimePeriodCondition. In some cases a Policy Consumer may need to perform certain setup / cleanup actions when a PolicyRule becomes active / inactive. For example, sessions that were established while a Rule was active might need to be taken down when the Rule becomes inactive. In other cases, however, such sessions might be left up. In this case, the effect of deactivating the PolicyRule would just be to prevent the establishment of new sessions. Setup / cleanup behaviors on validity period transitions are not currently addressed by the Policy Model, and must be specified in 'guideline' documents or via subclasses of CIM_PolicyRule, CIM_PolicyTimePeriodCondition or other concrete subclasses of CIM_Policy. If such behaviors need to be under the control of the policy administrator, then a mechanism to allow this control must also be specified in the subclasses. PolicyTimePeriodCondition is defined as a subclass of PolicyCondition. This is to allow the inclusion of time-based criteria in the AND/OR condition definitions for a PolicyRule. Instances of this class may have up to five properties identifying time periods at different levels. The values of all the properties present in an instance are ANDed together to determine the validity period(s) for the instance. For example, an instance with an overall validity range of January 1, 2000 through December 31, 2000; a month mask that selects March and April; a day-of-the-week mask that selects Fridays; and a time of day range of 0800 through 1600 would be represented using the following time periods: Friday, March 5, 2000, from 0800 through 1600; Friday, March 12, 2000, from 0800 through 1600; Friday, March 19, 2000, from 0800 through 1600; Friday, March 26, 2000, from 0800 through 1600; Friday, April 2, 2000, from 0800 through 1600; Friday, April 9, 2000, from 0800 through 1600; Friday, April 16, 2000, from 0800 through 1600; Friday, April 23, 2000, from 0800 through 1600; Friday, April 30, 2000, from 0800 through 1600. Properties not present in an instance of PolicyTimePeriodCondition are implicitly treated as having their value 'always enabled'. Thus, in the example above, the day-of-the-month mask is not present, and so the validity period for the instance implicitly includes a day-of-the-month mask that selects all days of the month. If this 'missing property' rule is applied to its fullest, we see that there is a second way to indicate that a PolicyRule is always enabled: associate with it an instance of PolicyTimePeriodCondition whose only properties with specific values are its key properties.None TRANSLATABLE= true

Local Class Properties

NameData TypeQualifiers
NameData TypeValueScopeFlavors
LocalOrUtcTimeuint16
Descriptionstring This property indicates whether the times represented in the TimePeriod property and in the various Mask properties represent local times or UTC times. There is no provision for mixing of local times and UTC times: the value of this property applies to all of the other time-related properties.None TRANSLATABLE= true
ModelCorrespondencestringCIM_PolicyTimePeriodCondition.TimePeriod, CIM_PolicyTimePeriodCondition.MonthOfYearMask, CIM_PolicyTimePeriodCondition.DayOfMonthMask, CIM_PolicyTimePeriodCondition.DayOfWeekMask, CIM_PolicyTimePeriodCondition.TimeOfDayMaskNone None
ValueMapstring1, 2None None
ValuesstringlocalTime, utcTimeNone TRANSLATABLE= true
TimeOfDayMaskstring
Descriptionstring The purpose of this property is to refine the valid time period that is defined by the TimePeriod property, by explicitly specifying a range of times in a day during which the PolicyRule is valid. These properties work together, with the TimePeriod used to specify the overall time period in which the PolicyRule is valid, and the TimeOfDayMask used to pick out the range of time periods in a given day of during which the Rule is valid. This property is formatted in the style of RFC 2445: a time string beginning with the character 'T', followed by the solidus character '/', followed by a second time string. The first time indicates the beginning of the range, while the second time indicates the end. Times are expressed as substrings of the form 'Thhmmss'. The second substring always identifies a later time than the first substring. To allow for ranges that span midnight, however, the value of the second string may be smaller than the value of the first substring. Thus, 'T080000/T210000' identifies the range from 0800 until 2100, while 'T210000/T080000' identifies the range from 2100 until 0800 of the following day. When a range spans midnight, it by definition includes parts of two successive days. When one of these days is also selected by either the MonthOfYearMask, DayOfMonthMask, and/or DayOfWeekMask, but the other day is not, then the policy is active only during the portion of the range that falls on the selected day. For example, if the range extends from 2100 until 0800, and the day of week mask selects Monday and Tuesday, then the policy is active during the following three intervals: From midnight Sunday until 0800 Monday; From 2100 Monday until 0800 Tuesday; From 2100 Tuesday until 23:59:59 Tuesday. If a value for this property is not provided, then the PolicyRule is treated as valid for all hours of the day, and only restricted by its TimePeriod property value and the other Mask properties.None TRANSLATABLE= true
ModelCorrespondencestringCIM_PolicyTimePeriodCondition.TimePeriod, CIM_PolicyTimePeriodCondition.LocalOrUtcTimeNone None
TimePeriodstring
Descriptionstring This property identifies an overall range of calendar dates and times over which a PolicyRule is valid. It is formatted as a string representing a start date and time, in which the character 'T' indicates the beginning of the time portion, followed by the solidus character '/', followed by a similar string representing an end date and time. The first date indicates the beginning of the range, while the second date indicates the end. Thus, the second date and time must be later than the first. Date/times are expressed as substrings of the form yyyymmddThhmmss. For example: 20000101T080000/20000131T120000 defines January 1, 2000, 0800 through January 31, 2000, noon There are also two special cases in which one of the date/time strings is replaced with a special string defined in RFC 2445. o If the first date/time is replaced with the string 'THISANDPRIOR', then the property indicates that a PolicyRule is valid [from now] until the date/time that appears after the '/'. o If the second date/time is replaced with the string 'THISANDFUTURE', then the property indicates that a PolicyRule becomes valid on the date/time that appears before the '/', and remains valid from that point on. None TRANSLATABLE= true
ModelCorrespondencestringCIM_PolicyTimePeriodCondition.MonthOfYearMask, CIM_PolicyTimePeriodCondition.DayOfMonthMask, CIM_PolicyTimePeriodCondition.DayOfWeekMask, CIM_PolicyTimePeriodCondition.TimeOfDayMask, CIM_PolicyTimePeriodCondition.LocalOrUtcTimeNone None

Inherited Properties

NameData TypeClass Origin
CaptionstringCIM_ManagedElement
CommonNamestringCIM_Policy
CreationClassNamestringCIM_PolicyCondition
DescriptionstringCIM_ManagedElement
PolicyConditionNamestringCIM_PolicyCondition
PolicyRuleCreationClassNamestringCIM_PolicyCondition
PolicyRuleNamestringCIM_PolicyCondition
SystemCreationClassNamestringCIM_PolicyCondition
SystemNamestringCIM_PolicyCondition