ENRJ0012 - Rerun Previous Bulk Enrolment Rule Check

Purpose

Retests student unit attempts in courses whose units were previously validated by ENRJ0010

SubSystem

Enrolments

Normally Run By Enrolment Specialist
Anticipated Frequency As required
Structure  Block Rerun Previous Bulk Enrolment Rule Check
Tab Parameters

  

This job validates Enrolment Rules for unit attempts that were previously tested by ENRJ0010. This validation checks Unit Enrolment Rules (from CRSF2700) and then Course Enrolment Rules (from CRSF1700). For each student course attempt for which rules are tested during a run of ENRJ0010 , an s_log record is created with s_log_type =‘BERC_RERUN’. This identifies students that will be tested by a rerun of this job.

The process performs two functions, for each Student Course Attempt, it:

  • 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 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, and File ENRR08C1, reports in predictive mode all the SUA changes, as if the Override Update Status parameter is set to 'Y'.

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. 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.This summary also 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'.

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 Rule Check - Students With 'To Do' Entries block contains:

  • Log Creation Date
    This parameter identifies which previous run of the Bulk Enrolment Rule Check job will be rerun.

Rules/Notes:

A Student Course Attempt will have enrolment rules checked if the previous run of ENRJ0010 specified in the parameter form, created an s_log record of type 'BERC_RERUN' for that course attempt.

ENRJ0012 produces a log file of exceptions recorded. When ENRR08C0 is run, it accesses the log file and reports the exceptions and when ENRR08C1 is run it generates an equivalent file.

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.

Enrolment rules for student course attempts with a status of INTERMIT, DISCONTIN or LAPSED are not tested.

BERC_RERUN records are not produced in s_log for ENRJ0012.

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.

 

Last Modified on: 17-Jul-2012 11:05 AM

History Information

Release Version Project Change to Document
11.0.0.0.0.0. 1355 - Rules Added Rule Waivers section
11.0.0.0.0.0. 1350 - Job Error Handling Added details relating to error handling and log entries
10.0.0.0.0.0 1232 - Revisions to Bulk Enrolment Rule Checks

New online help page