Purpose

Validates enrolled Student Unit/Course Attempts against Unit/Course Enrolment Rules

SubSystem

Enrolments

This job validates Enrolment Rules for any unit attempts specified by the parameters regardless of whether the related course attempt has a Unit-Rules todo recorded.

The process performs two functions for each Student Unit Attempt:

• Compares all ENROLLED Student Unit Attempts against Enrolment Rules to see if they now fail the Enrolment rules; and
• Compares all INVALID Student Unit Attempts to see if they now pass the Enrolment Rules.

The action taken by the process depends on the Status Update Override parameter and the dates for the 'Enrolled Rule Cut-off' Date Alias and the 'Invalid Rule Cut-Off' Date Alias, both of which are maintained in the Enrolment Calendar Configuration form (ENRF01F0).

Where the Status Update Override parameter is set to NULL and the process is run prior to the Instances of the two Date Aliases, then:

• Any ENROLLED Student Unit Attempts that fail a Unit Enrolment Rule validation will have the Student Unit Attempt Status set to INVALID and the change reported on the Exception Report.
• Any INVALID Student Unit Attempts that pass all the Unit Enrolment Rule validations will have the Student Unit Attempt Status set to ENROLLED and the change is reported on the Exception Report. Where the status cannot be updated due to Encumbrances against the Student Course Attempt, a message is reported on the Exception Report.

If the two Date Aliases have past, no changes are made to the Student Unit Attempt Status, as this would be at some point after the start of the Teaching Period.

Where the Status Update Override parameter is set to 'Y', then the Student Unit Attempt Statuses are updated even if the current Date is past the cut-off Date Aliases and all changes are reported in the exception report.

Where the Status Update Override is set to 'N', the Student Attempt Statuses are not updated. However, the Exception Report ENRR08C0 reports in predictive mode all the SUA changes, as if the Override Update Status parameter is set to 'Y'

ENRR08C0 reports on exceptions generated by this job and ENRR08C1 generates an equivalent output file.

Rule Waivers
The existence of Rule waivers for a student unit attempt will effect which rule(s) waived are not evaluated:

• If all unit rules are currently waived for a SUA (i.e. SUA Rule Waived Date and Rule Waived Person ID are not null) then no rules will be checked
• If an individual Unit Enrolment rule waiver exists (set in ENRF4180) that is not logically deleted , then that rule will not be evaluated.
• If an individual Course Enrolment rule waiver exists (set in ENRF4170) that is not logically deleted , then that rule will not be evaluated.
• If the Course Enrolment rule waiver is for specific academic calendar instance(s) - see ENRF4170, the rule will not be evaluated for the context academic calendar instance if it matches an academic calendar instance for which the rule is waived.

Job Error Handling
When errors/exceptions are generated for records in this job they will not cause the job to fail. Instead of failing, information is logged to the S_LOG_ENTRY and S_ERROR_LOG tables and the job continues onto the next record.

Run Log
A Summary of processing by this job, can be can be viewed in the run log - see JBSF5301. This summary includes the total number of records processed, with sub-totals of the number of records processed successfully and the number of records with errors. The summary also displays the number of system log entries for each system log type of 'UNIT-RULES', and 'CRS-RULES'. Along with this the log will display a message referring the user to the error log or to ENRR08C0 and ENRJ08C1 for details of errors and exceptions.

Important: Note that in order for this summary information to be included in the run log, the PASS_RJR_ID_IND value for this job, must be set to 'Y' in the S_JOB table.

This job is accessed from the main menu.

The Bulk Enrolment Rule Check (without todo) block contains:

• Person ID Group
  Allows restriction of the unit attempts checked to those for Student Course Attempts where the Person ID is a member of the specified Version ID Group (Includes Dynamic Person ID Groups).
• Person ID
  Allows restriction of the unit attempts checked to to those for the specified person.
• Unit Code
  Allows restriction of the unit attempts checked to to those for the specified unit code.
• Location
  Allows restriction of unit attempts checked to those undertaken at the specified location.
• Course Code
  Allows restriction of the unit attempts checked to to those taken in the specified Course Code. By default, ALL Course Codes are examined.
• Location
  Allows restriction of the unit attempts checked to those for Student Course Attempts undertaken at the specified location.
• Academic Calendar
  Allows restriction of the unit attempts checked to those undertaken in teaching periods in the specified year.
• Teaching Calendar
  The Teaching calendar of the Unit Attempt. If the Academic Calendar is set, then only its subordinate Teaching Calendar instances can be selected.
• Status Update Override
  (Y/N or NULL) - If Y then Student Unit Attempt Statuses will be updated regardless of the Cut-Off Date functionality. If N, statuses are not updated, as the job runs in PREDICTIVE mode. If NULL use current cut-off Date Alias functionality. (The job currently updates all statuses where appropriate, before the cut-off date.)
  Note: Setting the Status Update Override to 'N' allows the job to be re-run because Student To Do entries are not logically deleted.
• Exclude Completed Courses check box
• Exclude Completed Courses Without Enrolled Units check box

  Button

• Find Course
• Find Person

Rules/Notes:

Note that the parameters for this job are used to determine which student course attempts are to be processed. Once those student course attempts are identified, all enrolled and invalid units will have their rules evaluated.
This includes cases where the Unit Code parameter is specified. In that case any student course attempt where the specified unit is undertaken will have enrolment rules checked for all of its unit attempts which have a status of enrolled or invalid. This applies to other parameters such as unit location and academic period also.

This process produces a log file of exceptions recorded. When ENRR08C0 is run, it accesses the log file and reports the exceptions. Unit attempts that are invalidated and subsequently re-instated, or vice-versa, are not reported.

If checking ENROLLED to INVALID and the invalid cut off date alias (in ENRF01F0) is passed and Status Update Override is null, then an Error message will be generated.

If checking INVALID to ENROLLED and the enrolled cut off date alias (in ENRF01F0) is passed and Status Update Override is null, then an Error message will be generated.

At least one of the Person ID group, Person ID, Unit Code, Unit Location, Course Code, Course Location or Academic Calendar must be specified as a parameter for this is job.

If the Teaching Period parameter is set then only Student Unit Attempts with Statuses of ‘ENROLLED’ and ‘INVALID’ within the defined Teaching Period will be evaluated.

Only one of Exclude Completed Courses or Exclude Completed Courses without enrolled units can be set.

If the Exclude Completed Courses Without Enrolled Units checkbox is selected, and a student course attempt which satisfies all other parameters is completed but has unit attempts with a status of Invalid, then Enrolment rules will not be tested for this course.

19.0.0.3, 19.1.0.3
& 20.0.0.1

New online help page