Purpose

To create and maintain a schedule for a standing request by specifying the frequency with which the request should run in a nominated period

Subsystem

Job Control and Scheduling

Structure

Three Blocks

Standing Request Period

Standing Request Frequency

Standing Request Frequency (Calendar Type/Date Alias)

Image

Standing Request Period

Explanation

NOTE: There are two methods of specifying when a job should run. This form is used to set up a schedule for standing requests. Use the form Maintain Request Schedule (JBSF5212) for all other requests.

As part of defining a standing request, it is necessary to set up a schedule detailing the frequency with which the request should run. The system organises for the job(s) comprising the request to run at the intervals specified in this form. Security restrictions may limit the use of standing requests to specific system users.

The form is accessed via the Standing Request Frequency navigation button on the central request form, Maintain Request Details (JBSF5210). This button is displayed whenever the Standing Request indicator is set and saved. The indicator label is greyed out if a user is not permitted to create or alter a standing request, though the form can still be accessed for information.

A diagram illustrates the steps to set up a request as a standing request

Much of this block is for information only. It displays request context details carried from the central request form, including access to a pop-up window to see the intervals (set of times) assigned to the request's run window. The date fields in the block are used to enter the period (which can be open-ended) during which the standing request is current.

Example

The standing request period is set from 16^th February 98 to 31^st October 98.

To view the intervals for the request's run window, using the Maintain Standing Request Frequency form:

1. Using the icon alongside the Run Window field, access the pop-up window, Inquire On Run Windows (JBSF4411).

To enter the period during which the given standing request is current, using the Maintain Standing Request Frequency form:

In Insert mode:

1. Supply a start date for the standing request period in either the Start Date field (Method 1) or the Start Alias Instance field (Method 2).

• Method 1
  Enter a date by keying directly in the field, or by using the calendar icon and selecting a date using the electronic calendar.
• Method 2
  Select a date using the date alias icon to access the Inquire On Date Alias Instance form (CALF7510). Follow instructions given for that form. On return to this block, the system inserts the selected date in the Alias Instance field.

1. Optionally, supply an end date for the standing request period in either the End Date field (Method 1, above) or the End Alias Instance field (Method 2, above).

• A date can be keyed using a variety of formats, including: 03/03/1998, 3-3-98, 3.3.98.
• A standing request period can be open-ended.

To modify the period during which the given standing request is current, using the Maintain Standing Request Frequency form:

1. Modify the start and end dates of the period as required.
2. Save.

To remove the dates signifying the standing request period, using the Maintain Standing Request Frequency form:

1. Ensure that all frequency records are deleted.
2. Delete values from the start and end date fields.
3. Save.

• This deletion should only be necessary if the request is to cease being a standing request - for example, where standing request details are to be removed in a new request achieved using the duplication method.

Standing Request Frequency

Explanation

Records in this block specify the frequency with which a standing request will run during the standing request period. This can be entered as a day or days (for example, each Wednesday and Friday in February, April and June) or a day of the month (for example, the 18^th of each month). Records here and in the next block (frequency using a date alias) can be set up in combination.

Example

The statistics for study units produced by the job in request 67 (detailed in the block above) are required every Friday morning during teaching weeks, so a staff member sets up the request to run each Thursday evening. This is achieved by selecting THU in the Day/s or Day of Month field of this block, and the months FEB, MAR, APR, MAY, AUG, SEP, OCT in the Months field. The Year is entered as 1998, and the time as 20:00. To add an extra two Thursdays required in July, two further record are created, one for 23 July, and one for 30 July.

From 16th February, which is the start of the standing request period, the request will run each Thursday evening until 31 October, except for Thursdays occurring in June and in the first three weeks of July.

To create a record specifying the frequency of a given standing request, using the Maintain Standing Request Frequency form:

1. Enter Insert mode.
2. Select the day(s) or day of month on which the request is to run from the list of values (or key a valid value) in the Day/s or Day of Month field of a blank record.
3. Select the month(s) when the request is to run from the list of values (or key a valid value or partial value) in the Month/s field.
4. Select a year from the list of values (or key a valid value) in the Year field.
5. Enter a time in 24-hour format in the Time field.
6. Save.

• If a value is entered in any field, then values must be entered in all fields of the record.
• A time must be keyed in 24-hour format. Examples of accepted formats for 8 p.m. are 20:00, 20.0, 20-0.
• Note that 20:3 is interpreted by the system as 20:03.
• Note that EVERY DAY, EVERY MONTH and EVERY YEAR are possible values.
• When a standing request is open-ended, the system checks that the request is valid to run at least once.
• Keying a partial value (and tab or enter) brings up a subset of the list of values in the Month field. For example, key 'JAN, S' to see all the month combinations starting 'JAN, SEP ..'.
• HINT: One way to enter months is to select the full twelve months (scroll to end of list of values) and edit the field to delete unwanted months. Take care to retain consistent commas and spaces.

To modify a frequency record using the Maintain Standing Request Frequency form:

1. Find the record to be modified, scrolling if necessary.
2. Modify the record as required.
3. Save.

To delete a frequency record using the Maintain Standing Request Frequency form:

1. Find the record to be deleted, scrolling if necessary.
2. Locate the cursor in the record to be deleted.
3. Delete record.
4. Save.

Standing Request Frequency (Calendar Type/Date Alias)

Explanation

Either as an alternative, or in combination with the Standing Request Frequency block, this block allows the entry of date aliases to determine the frequency with which standing requests will run during the standing request period.

Standing request schedules which rely on date aliases must be considered in conjunction with setting up date alias instances for the same calendar type. Since the system attempts to re-schedule a standing request immediately after each scheduled date and time of running, a further date alias instance must exist at that time, or the request will be deemed to have completed.

If, after a request has been submitted or re-scheduled to run (request status WAIT), a date alias instance is amended or added so as to fall before the request is due to run, this instance will be ignored. This is because the next run date is determined at the time the request status is set to WAIT. For an overview of processes corresponding to request statuses, see the section Checking on the Progress of a Request in the subsystem introduction.

Example

Building on the example used in the previous blocks, assume that statistics for study units are also required on government census dates. This requirement is built into the standing request by specifying CENSUS as the date alias in this block. The job will run on each census date within the standing request period, as well as at times scheduled in the previous block.

Using a date alias to specify the frequency of a given standing request, using the Maintain Standing Request Frequency form:

In Insert mode:

1. Select the calendar type of the required date alias for the request frequency record from the list of values (or key a valid value) in the Calendar Type field of a blank record.
2. Select the required date alias indicating when the request should run from the list of values (or key a valid value) in the Date Alias field.
3. Enter a time in 24-hour format.
4. Save.

• A time must be keyed in 24-hour format. Examples of accepted formats for 2 p.m. are 14:00, 14.0, 14-0.
• Note that 14:3 is interpreted by the system as 14:03.
• There must be at least one instance of the date alias which is valid for the period and run window of the request.
• HINT: Use the date alias icon in the top block to access the Inquire On Date Alias Instance form (CALF7510) and check on valid date alias/calendar type combinations. Use the Cancel button to return to this form without altering values in the top block.

To modify a date alias frequency record using the Maintain Standing Request Frequency form:

1. Find the record to be modified, scrolling if necessary.
2. Modify the record as required.
3. Save.

To delete a date alias frequency record using the Maintain Standing Request Frequency form:

1. Find the record to be deleted, scrolling if necessary.
2. Locate the cursor in the record to be deleted.
3. Delete record.
4. Save.

Changes within this form will have the following notable effects:

• Caution is necessary in setting up this form with an open-ended standing request period, since specified days (and/or date aliases) may not necessarily coincide with allowed run windows in all cases, and jobs will not then run until their run window next becomes active.