SDX 6.4.x Services and Policies Guide > Scheduling Services > Creating an Entry for a Schedule

Creating an Entry for a Schedule

A number of schedule entries, or rules, comprise each service schedule.

To create an entry:

1. In the Service Schedule pane, click New.

The Schedule Event dialog box appears.

2. In the Schedule tab of the Schedule Event dialog box:

• Fill in the From date and time information.
• (Optional for services that have an authorization plug-in configured) Fill in the To date and time information.
• (Optional) Specify time exclusions as described in Setting the Time Schedule.

3. In the Action tab of the Schedule Event dialog box, fill in the fields as described in Setting the Action.
4. To add another action to the entry, in the Action tab click Add Action.
5. To remove an action from the entry, in the Action tab, click Remove Action.
6. After you complete entries in the Schedule Event dialog box, click OK to return to the Service Schedule pane.
7. To add the entry to the list of entries in the service schedule, click Add.
8. After you enter all schedules and actions, click OK in the Schedule Event dialog box.

The completed schedule appears in the Service Schedule pane.

Setting the Time Schedule

When you set up a time schedule, you specify:

• For event schedules—Time at which an action is to occur
• For schedules for services that have authorization configured—Beginning and end of the interval
• Times to be excluded from that schedule.

Sample Time Definitions

Table 8 provides descriptions of common schedule configurations.

 Table 8:  Sample Schedules  

 Type of Event to Schedule
 Sample Configuration Description

 One-time event

 Specify all time parameters except day of the week. Specify the time zone if it is different from the time zone for the SAE.


 Recurring time-of-day event, such as a service that is activated every morning at 8:00 AM

 Specify only the hour and minute parameters. All other parameters should have an *. Specify the time zone if it is different from the time zone for the SAE.


 Working-hours service

 Define two schedules: one to activate the service and one to deactivate the service. In each schedule, specify the hour and minute, and specify the day of week as mon-fri. All other parameters should have an *. Specify the time zone if it is different from the time zone for the SAE.
 NOTE: Subscribers must be logged in at the time that the service is activated.


 No service restrictions on holidays

 Define schedules for working-hour services as described above, and add exceptions for specified holidays, such as the first of January.



 

Configuring the Time Schedule

To configure the time schedule:

1. Use the guidelines and field descriptions in Guidelines for Entering Time Values and Time Values to enter information in the fields in the Schedule tab in the Schedule Event dialog box.
2. To specify an exclusion from the schedule, in the Schedule tab of the Schedule Event dialog box, click New under Exclusion Entries.

The Schedule Exclusion dialog box appears.

3. Using the guidelines and field descriptions in Guidelines for Entering Time Values and Time Values, enter information in the fields in the Schedule Exclusion dialog box; then click OK.

Guidelines for Entering Time Values

When you enter information in the Schedule Event and Schedule Exclusion dialog boxes, you can use the values in the following list. See Time Values for a description of the fields.

NOTE: Dates in the To section of the dialog box apply only to services that have an authorization plug-in configured. If an authorization plug-in is not configured for the service associated with the schedule, the entries in the To section are ignored.

• *—Asterisks are interpreted as follows:

• Minutes and hours:

• 0 if used in the From or To fields of a scheduled event
• First or last if used in the Time Spec field of a schedule exclusion

• Time zones—Local SAE time zone
• All other fields—First through last
• For fields in the To section of the dialog box, * for the end time is equivalent to "deny service activation after this start date."
• For dates in the From section of the dialog box, * is equivalent to "deny service activation before this end date."

• Range of numbers or letters separated by a hyphen. The range is inclusive; for example, 1-5 for the hour specifies hours 1, 2, 3, 4, and 5. A range of mon-wed specifies Monday, Tuesday, and Wednesday.
• List of numbers, letters, or ranges separated by commas. For example, 1,2,5,9 or 0-4,8-12 or mon-wed,fri-sat.
• Skip values in ranges:

• To skip a number's value through the range, follow a range with /<number>. For example, 0-23/2 used in the Hour field specifies that the event occurs every other hour.
• Skip values with *. If you want to specify every two hours, use */2.
  

  NOTE: If you set both a day of the month and a day of the week, the day of the month is used.

  
  

Time Values

Use the following field definitions when you complete entries in the Schedule Event and Schedule Exclusion dialog boxes. For information about general guidelines that apply to these fields, see Guidelines for Entering Time Values.

Exclusion Type

• Interval to exclude from the schedule specified in the Schedule Event dialog box.
• Value

• one-time—Exclusion for a single time; for example, for a holiday
• period—Exclusion for a time range; for example, a number of days

• Guidelines—This field applies only to the Schedule Exclusion dialog box. Effective periods do not apply to schedules for excluded times.
• Default—one-time

Hour

• Hour of the day in the indicated month in which to schedule the event or exclusion.
• Value—0-23
• Default—*

Minute

• Minutes past the indicated hour in which to schedule the event or exclusion.
• Value—0-59
• Default—*

Day of Month

• Day of the month in which to schedule the event or exclusion.
• Value—1-31
• Default—*

Day of Week

• Day of the week in which to schedule the event or exclusion.
• Value

• 0-6, with 0 representing Sunday and each subsequent number representing the next day of the week.
• First three letters of the name of the day

• Default—*
• Examples—For Saturday and Sunday, specify one of the following:

• sat, sun
• 6, 0

Month

• Month of the year in which to schedule the event or exclusion.
• Value

• 1-12
• First three letters of the name of the month

• Default—*
• Examples—For January, specify one of the following:

• jan
• 1

Year

• Year in which to schedule the event or exclusion.
• Value—Four integers that indicate the year
• Default—*

Effective Period

• Interval after the associated From or To time during which the scheduled action can be initiated by a subscriber who is logging in to a subscriber session.
• Value—Number of minutes in the range 0-153722867280912
• Guidelines—The effective period applies only to schedules configured for an object under o=Users.

Effective period does not apply to schedules for excluded times; the entry is not present in the Schedule Exclusion dialog box.

• Default—*

Time Zone

• Name of the time zone to use in the schedule.
• Value

• * —Local time zone of the SAE.
• An offset to GMT in the format:

GMT (+|-) (hh:mm | hh mm | hh)

hh—<hour>

mm—<minute>

• Default—Time zone for the SAE
• Examples

• Canada/Eastern or America/New York
• GMT +5—Sets the time zone to 5 hours ahead of GMT

Setting the Action

You can set the following values in the Action tab.

Action

• Type of action.
• Value

• activate—Service is activated at the time specified in the entry schedule.
• deactivate—Service is deactivated at the time specified in the entry schedule.
• deny—New activation requests for this service during the specified entry period are denied; current sessions are not affected.
• deny&deactivate—New activation requests for this service during the specified period are denied; in addition, current sessions are deactivated when the specified time occurs.

• Guidelines—The deny and the deny&deactivate values apply only to services that have an authorization plug-in configured.
• Default—No value

Service

• Name of the service.
• Value—Text

You can type the name of the service or click the folder icon to display the Select Service dialog box. Select the service in the dialog box, and click OK.

• Default—No value

Substitutions

• Substitutions to be used when the service is activated. Substitutions apply only to service activations.

For more information, see the activateService method of the SAE external interface in the SAE CORBA remote API, see the SAE CORBA remote API documentation in the SDX software distribution in the folder SDK/doc/idl or on the Juniper Networks Web site at

http://www.juniper.net/techpubs/software/management/sdx/api-index.html

For more information about substitutions and schedules, see Changing or Removing the Name of a Service Associated with a Schedule.

• Value—An entry in valid substitution format.

For information about the syntax for substitutions see Chapter 7, Defining and Acquiring Values for Parameters. For information about configuring substitutions, see Chapter 1, Managing Services.

• Default—No value

Attributes

• Defines attributes that are set before the service is activated.

Subscription attributes apply only to service activations.

For more information about subscription attributes, see the Subscription.html file in the SAE core portal API documentation in the SDK/doc/sae/net/juniper/smgt/sae/portal directory in the SDX software distribution or on the Juniper Networks Web site at

http://www.juniper.net/techpubs/software/management/sdx/api-index.html

• Value—Use the Up or Down arrow below the Attributes box to select an attribute, and then click Add to add the attribute to the action.

• sessionName—Name of the service session.
• sessionTag—Tag that can be used for accounting purposes.
• sessionTimeout—Session timeout to be used when the service is activated. The service session is deactivated when this timeout expires.
• downStreamBandwidth—Attribute used by Admission Control Plug-In (ACP) to specify the rate of traffic between the network and the subscriber.
• upStreamBandwidts—Attribute used by ACP to specify the rate of traffic between the subscriber and the network.