STAJ8050 - Create VET FEE-HELP Submission Snapshot - VET only

Purpose

To identify and extract student records for inclusion in the VET FEE-HELP Government Submission files for DIISRTE statistics reporting.

SubSystem

Statistics

Sector VET
Normally Run By Set to run as a standing request through the Job Scheduler, or may be requested by an Statistics specialist, as required.
Anticipated Frequency Must be run once for each Government Submission but is likely to be run a number of times for each submission in order to identify missing or errant data. May be run to reproduce previous exception reports.
Structure Block Create VET Government Statistics Snapshot
Tab Parameters
Buttons Create File

 

This job identifies and extracts student records for inclusion in the VET FEE-HELP Government Submission files for DIISRTE statistics reporting.

The eligibility rules to determine whether a student/unit is eligible for VET FEE-HELP and is therefore reported, are as follows:

  • Has citizenship of 1or 8.
  • Is studying a VET FEE-HELP approved course - that is, with a course category of 'GOVT-RPT' and a sector of VET. If there is no course categorisation defined or it is anything other than 'GOVT-RPT' then the course is not reportable.
  • The Unit Categorisation is either not configured or it is set to 'GOVT-RPT'.
  • The student has a FEE-HELP balance greater than zero (or no balance) recorded in the system on the date the job is run.
  • The unit must have some load - so EFTSL (from contact hours) should be greater than zero.
  • If the Enrolment Date is before the Census Date or the Discontinuation Date is after the Census Date (for the unit) then the unit attempt is reportable.
  • The Unit Version must have a Contact Hours that are greater than 0 (equivalent to enrolled credit points in HE).
  • The Unit Attempt should have a related student status - if there is a student status related to the unit, the job checks that it has a govt_reportable_ind of 'Y' (in the HECS_PAYMENT_OPTION table).
  • The ENRF3110 should keep it to an allowable student status for VET FEE-HELP (401-403, 501-503).

Note: If a student is not eligible then they may be ignored entirely by the reporting process and therefore not listed as an exception.

The job may be run for one of the following at any one time:

  • DIISRTE VET Submissions - VS-RPT (VET Reporting Snapshot).
    Or
  • DIISRTE VET Unit Completions - VS-CMP-UNT (VET Unit Completions Snapshot).
    Note: Must be run the year following the completion of the VS-RPT submission, (for example, a 2010 VS-CMP_CRS file is created in 2011).
    Or
  • DIISRTE VET Course Completions - VS-CMP-CRS (VET Course Completions Snapshot). - Note: Must be run the year following the completion of the VS-RPT submission, (for example, a 2010 VS-CMP_CRS file is created in 2011.)

For more information about the VET FEE-HELP Reporting process, see Understanding VET Statistics.

The snapshot consists of data collected from throughout Callista and is stored in the following three snapshot tables based on whether the data is at a student, course or unit level:

  • GOVT_SNAPSHOT_PE
  • GOVT_SNAPSHOT_SCA
    When run for VET Course completions, the function specifically looks for courses completed within the submission dates for the submission year and records these in the GOVT_SNAPSHOT_SCA table.
    Note: Past course completions, which are reportable but do not directly relate to the students’ current reportable enrolments, are also recorded in the GOVT_SNAPSHOT_SCA snapshot table. These are recorded as a separate entry (per combination of Person ID, Course Code and Reporting Year/Period) and are run with the Course Completions Submission Type.
  • GOVT_SNAPSHOT_SUA
    The job snapshots students enrolled in a unit of study whose Unit of Study Census Date falls between the start and end date of a submission.
    Unit completions are recorded in the GOVT_SNAPSHOT_SUA snapshot table. These are recorded as a separate entry (per combination of Person ID, Unit Code and Reporting Year/Period) and are run with the Unit Completions Submission Type.

Record Reporting Statuses:

Each snapshot record has one of the following Reporting Statuses. Statuses for each record are maintained in Maintain VET FEE-HELP Snapshot (STAF8050).

  • INCLUDE - the record is included in the file creation process.
    • Each new record created by the process has a Reporting Status of INCLUDE. If the function is run for an existing submission period, the system recognises existing records previously created for that submission period and updates them as necessary.
  • EXCLUDE - the record will not be included in the file creation process. These records will also be excluded from future snapshot processing in the same period.
    • If an existing record has a Reporting Status of EXCLUDE, the system will not update or re-create that record. If an existing record has a Reporting Status of INCLUDE it is updated (or deleted, or not changed) as necessary.
  • RE-PROCESS - the record requires the snapshot process to be run over it before the file creation process can create the files.
    • If an existing record has a Reporting Status of RE-PROCESS, it is updated (or deleted, or not changed) and the status is updated to INCLUDE, even if no other changes are required for the record.

For more information, see Record Reporting Statuses.

An administrator can record a comment against the system log for each run of the snapshot job.

EFTSL Calculation:

The process also calculates EFTSL (Equivalent Full Time Study Load) for VET FEE-HELP reporting using contact hours (instead of credit points which are used for HE reporting). For more information, see EFTSL - Equivalent Full-Time Student Load.

At an appropriate time after the Census Date, the snapshot is used to produce the VET FEE-HELP Government Submission File (STAJ8850).

The following jobs in the VET FEE-HELP statistics process are run after running STAJ8050:

  • STAJ8055 - Create VET FEE-HELP Revisions Submission Snapshot
  • STAJ8850 - Create VET FEE-HELP Government Submission Files
  • STAJ0120 - Copy Govt. Stats/Centrelink Files from Secure Area
  • GENJ1100 - Generate XML File from System Log

For more information on the statistics process and the various jobs and forms involved, see Understanding VET Statistics.

This form is accessed through Statistics/VET Statistics Reports and Jobs from the main menu.

 

The Create VET Enrolment Statistics Snapshot block contains:

Parameters Tab

Reproduce Log file

  • Previous Log Creation Date

Button

  • Create File

OR ...

Create New Submission

  • Submission Year (LOV)
  • Submission Type (LOV)
  • Submission Number (LOV)
  • Start Date
  • End Date
  • Run for RE-PROCESS Records check box
  • Run for Previously Excepted Students (check box)
  • Previous Log Creation Date (LOV)
  • Exception Log Comment

Rules/Notes:

Previous Log Creation Date: Used for re-processing previously Excepted students and re-generating the log file. Other parameters are not required when this parameter is used. This option enables the administrator to avoid re-running the entire snapshot and instead run it only for previously excepted students. If further exceptions are created, a new error log is created.

The Create File button is used to create an XML file of the selected log. The user is asked to save the file to their local file system.

Submission Year: Specifiies the submission year. This field is mandatory unless a value is specified in the Previous Log Creation Date.

If the function is run for an existing submission period, the system recognises existing records created previously for that submission period and updates them where necessary.

System Submission Type: (Mandatory.) Specifies the type of submission for the specified Submission Year, i.e:

  • VS-RPT - (VET Reporting snapshot)
  • VS-CMP-CRS - (VET Course Completions snapshot)
  • VS-CMP-UNT - (VET Unit Completions snapshot)

For VS-CMP_CRS and VS-CMP-UNT, the job must be run the year following the completion of the VS-RPT submission (for example, a 2010 VS-CMP_CRS file is created in 2011.)

The type of submission will be controlled by the Submission Types specified in Maintain Government Snapshot Control form (STAF1350), along with parameters provided for the job.

Submission Number: Specify a submission number to run the job for only those records with the specified submission number. This field is mandatory unless a value is specified in the Previous Log Creation Date.

Run for RE-PROCESS Records: Select this checkbox to run the job only for records that have a Reporting Status of RE-PROCESS. This field is mandatory unless a value is specified in the Previous Log Creation Date or the Run for Previously Excepted Students check box is selected.

Run for Previously Excepted Students: Used to run the snapshot only for students who created an error on a previous job run.

Previous Log Creation Date: Used for re-processing previously Excepted students and re-generating the XML file.
The Run for Previously Excepted Student check box must be selected first before entering a date in this parameter.
The comments recorded in the Exception Log Comment field (below) when creating a new submission, are viewable in the LOV for this field next to the relevant date.

Exception Log Comment: Used to record a comment against the snapshot for later reference. The comment is also included in the Exception Log key for display in the List of Values for the Previous Log Creation Date parameter.

The comments recorded in the Exception Log Comment field when creating a new submission, are viewable in the LOV for the Previous Log Creation Date field next to the relevant date.

Validations:

  • The system Submission Type can only be one of the following: VS-RPT, VS-CMP-CRS or VS-CMP-UNT.
  • The 'Run for RE-PROCESS Records' indicator or the 'Previously Excepted Students' indicator can be selected. (Not both.)
  • The Previous Log Creation Date must be specified first in order to run the Create File function.

A course can only be recorded in the snapshot if the course has a course category of GOVT-RPT.

Reportable Course and Unit Code

Where applicable, the snapshot captures the Course Code and Unit Codes (which can be up to 20 characters). DIISRTE requires that the Course Code and Unit Code lengths be 10 characters. When creating the snapshot, the job captures the full code in the Course or Unit Code fields. There is another field in the snapshot for capturing the Reportable Code that will be reported to DIISRTE.

A Reference Code Type for Course and Unit Versions allows institutions to define a Reportable Code against a Course Version or a Unit Version. When creating the snapshot, this function captures the Reference Code (if it exists) as the Reportable Code. If no Reference Code of that type is recorded against a Course Version or a Unit Version, then the snapshot captures the 10 right-most characters of the Course or Unit Code. (for example, if no Reference Code exists for Course Code ABCDE123456 then it is captured as ABCDE123456 in the Course Code field of the snapshot, but is captured as BCDE123456 in the Reportable Course Code Field.)

Exception Log:

The Exception Log records details of students who could not be included in a particular Government Submission Snapshot. Messages are produced to Callista’s log files where appropriate. There are two types of messages:

  • Error messages are produced when Callista is unable to determine data to be used in the government snapshot. Government snapshotsmust be re-run for these students. Details of each error is written to S_LOG_ENTRY. Any changes that may have occurred to the student’s snapshot are rolled back and the job continues processing the next student.
  • Warning messages are mainly produced where no information is found in the database and the system is able to insert a suitable DIISRTE value in the government snapshot to indicate this. Wherever possible, these records will be fixed in the database by inserting at least the DIISRTE default (e.g. 9 = unknown or no information) value. Warning messages are written to S_LOG_ENTRY.

When the snapshot process is run, an exception log is created in the tables, and a file is generated in the format specified by the log type. This file is able to be selected and created independently of the snapshot creation process.

Parameters allow the administrator to re-run the snapshot only for students who created an error on a previous job run. The administrator can select from any existing log records that have been created for VET Submission or VET Course Completions, using the comments created at the time of submission as a guide. When run in this mode, the current submission parameters are not required.

Rules/Notes:

This job produces an Exception Log.

When reprocessing for exceptions, the administrator is able to record a comment against the system log for each run of the snapshot job for later reference.

Exceptions produced by the job can also be reported via GENJ1100 - Generate XML file from System Log.

 

The snapshot data is stored in the following three snapshot tables based on whether the data is at a student, course or unit level:

GOVT_SNAPSHOT_PE Reason/Explanation: Related Govt Submission File:
SUBMISSION_YR The Submission Year, as four digits numeric. For example, 2005. Sourced from: Govt_snapshot_ctl.submission_yr  
SUBMISSION_NUMBER The Submission Number, up to three digits numeric. For example, 401 or simply 1. Sourced from: Govt_snapshot_ctl.submission_num  
S_SUBMISSION_TYPE The type of submission. Sourced from govt_snapshot_ctl.s_submission_type.  
PERSON_ID

The Person ID of the student's enrolment or Advanced Standing. Sourced from:
Person.person_id
. Element 313.

 

S_REPORTING_STATUS The reporting status of the Person record.  
REPORTING_YR The year for which the snapshot is being run and reported.  
BIRTH_DT The date of birth of the student. sourced from: Person.birth_dt 
Element 314.
VEN, VDU, VPO, VRD.
SEX Student's gender. Element 315. . VEN, VDU, VPO, VRD.
TITLE The student's title. Element 405. VDU, VRD.
SURNAME The student's surname. Element 402. VDU, VPO, VRD.
GIVEN_NAME The student's given name or first name. Element 403. VDU, VPO, VRD.
OTHER_NAMES The student's middle or other names. Element 404. VDU, VPO, VRD.
ABORIG_TORRES_CD The Aboriginal and Torres Strait Islander code that identifies the student as being of Aboriginial and/or Torres Strait Islander descent.  
GOVT_ABORIG_TORRES_CD Element 316. The government/DIISRTE Aboriginal and Torres Strait Islander code. VEN.

CITIZENSHIP_CD

The student's citizen/resident code.  
GOVT_CITIZENSHIP_CD The government citizen/resident code. Element 358. VLL,VRL.
HOME_LOCATION The location of the student's permanent home residence.  
GOVT_HOME_LOCATION The government/DIISRTE Location code of the student's permanent home residence. Element 320. VEN.
TERM_LOCATION The location of the student's home residence during the term or semester.  
GOVT_TERM_LOCATION The government/DIISRTE Location code of the student's home residence during the term or semester. Element 319.  
BIRTH_COUNTRY_CD The Country of Birth code for the student's country of birth.  
GOVT_BIRTH_COUNTRY_CD The government/DEWR Country of Birth code. Element 346. VEN.
YR_ARRIVAL The year the student arrived in Australia if the student was born overseas. Element 347. VEN.
HOME_LANGUAGE_CD The code for the language that the student speaks at home.  
GOVT_HOME_LANGUAGE_CD The government/DIISRTE Language Spoken at Home code. Element 348. VEN.
GOVT_DISABILITY The Government Disability code that relates to the student's disability if the student has a disability. Element 386. VEN.
COMMENCING LOCATION

Commencing location postcode of the student's permanent home residence. Element 476.

VEN.

COMMENCING_GEOGRAPHIC_LOCATION Element 486. The name of the commencing location of the student's permanent home residence. VEN.
HIGHEST_ATTAINMENT The student's highest qualification. Element 493. VEN.
POSTAL_ADDRESS_LINE_1 The first line of the student's postal address. Element 406. VDU, VRD.
POSTAL_ADDRESS_LINE_2 The second line of the student's postal address. Element 407. VDU, VRD.
POSTAL_ADDRESS_SUBURB The suburb of the student's postal address. Element 466. VDU, VRD.
POSTAL_ADDRESS_STATE The state of the student's postal address. Element 467. VDU, VRD.
POSTAL_ADDRESS_POSTCODE The postcode of the student's postal address. Element 409. VDU, VRD.
POSTAL_ADDRESS_COUNTRY The country of the student's postal address. Element 468. VDU, VRD.
RESIDENTIAL_ADDRESS_LINE_1 The first line of the student's residential address. Element E410. VDU, VRD.
RESIDENTIAL_ADDRESS_LINE_2 The second line of the student's residential address. Element E411. VDU, VRD.
RESIDENTIAL_ADDRESS_SUBURB The suburb in which the student lives. Element 469. VDU, VRD.
RESIDENTIAL_ADDRESS_STATE

The state in which the student lives. Element 470.

VDU, VRD.

RESIDENTIAL_ADDRESS_POSTCODE The postcode of the suburb in which the student lives. Element 413. VDU, VRD.
RESIDENTIAL_ADDRESS_COUNTRY The country in which the student lives. Element 471. VDU, VRD.
COMMENCING_STUDENT_IND The commencing Student indicator. (Note: This is used for internal purposes - it is not a DIISRTE element.)  
CHESSN The student's CHESSN number. Element 488. VEN, VDU, VLL, VRL, VRD, VSR.
UPDATE_WHO The name of the user who last updated the record.  
UPDATE_ON The date and time the record was last updated.  

Each record in the GOVT_SNAPSHOT_SCA snapshot must have a unique combination of values for:

GOVT_SNAPSHOT_SCA Reason/Explanation: Related Govt Submission File:
SUBMISSION_YR The Submission Year as four digits numeric. For example, 2005.
Source: Govt_snapshot_ctl.submission_yr
 
SUBMISSION_NUMBER The Submission Number up to three digits numeric. For example, 401 or simply 1. Source: Govt_snapshot_ctl.submission_num  
S_SUBMISSION_TYPE The type of submission. Sourced from govt_snapshot_ctl.s_submission_type. Source: Govt_snapshot_ctl.s_submission_type  
PERSON_ID

The Person ID of the student's enrolment or Advanced Standing. Source: Student_course_attempt.person_id
Element 313.

VEN, VCC, VDU, VPO, VRD

COURSE_CD Course code. Source: Student course attempt.  
CRV_VERSION_NUMBER The course version number. Source: Student_course_attempt.version number  
REPORTING_YR

The reporting year. Derived from the unit census date:
YEAR | submission. For example:
20101 – first 6 months of 2010
20102 – second half of 2010

(1 SCA record per unique reporting year – derived data as at the end date of the relevant submission.)
Element 415.

VEN, VCC

REPORTED_COURSE_CD The reportable course code for the reported course. Element 307.

VCC, VDU, VRD

ATTENDANCE_TYPE The student's type of attendance, for example, on-campus or distance education.  
GOVT_ATTENDANCE_TYPE The government/DIISRTE code for the student's type of attendance.Element 330.  
COMMENCEMENT_DT

The date the student commenced their course of study. (i.e. Course Commencement Date.)
Element 534.

VLL
COMMENCING_STUDENT_IND The commencing Student indicator. (Note: This is used for internal purposes - it is not a DIISRTE element.)  
BASIS_FOR_ADMISSION_TYPE The basis for the student's admission to the course.  
GOVT_BASIS_FOR_ADMISSION

The basis for the student's admission to their current course. Element 327.

 

PRIOR_STUDIES_EXEMPTION

The student's prior studies exemption status. Element 565. VEN
EXEMPTION_INSTITUTION_CD Exemption institution code. This is a numeric value.  
GOVT_EXEMPTION_INSTITUTION

Exemption/status higher education provider code. Element 566.

VEN
GOVT_CREDIT_USED Element 560. VEN
GOVT_CREDIT_BASIS Element 561. VEN
VTE_FIELD_OF_EDUCATION Element 562. VEN
VTE_LEVEL_DETAIL Element 563. VEN
GOVT_VTE_PROVIDER_TYPE The government provider type. Element 564. VEN
VARIATION_REASON_CD Element 446. VCC
STUDY_REASON_ID

The student course attempt study reason code. Element 575.
Defaults to 99 if the the study reason identifier is not available.

VEN
LABOUR_FORCE_STATUS_ID The person's VET statistics government employment category. Element 576. VEN
CHESSN The student's CHESSN number. Element 488. VCC
S_REPORTING_STATUS The Record Reporting Status (specified for the snapshot record in STAF8050).  
UPDATE_WHO The name of the user who last updated the record.  
UPDATE_ON The date and time the record was last updated.  

 

The GOVT_SNAPSHOT_SUA table contains details on any unit of study undertaken by an eligible student (as defined above). Each record in the GOVT_SNAPSHOT_SUA must have a unique combination of values for:

GOVT_SNAPSHOT_SUA Reason/Explanation Related Submission File:
SUBMISSION_YR Describes the Submission Year as four digits numeric. For example, 2005. Sourced from: Govt_snapshot_ctl.submission_yr  
SUBMISSION_NUMBER Describes the Submission Number up to three digits numeric. For example, 401 or simply 1. Sourced from: Govt_snapshot_ctl.submission_num  
S_SUBMISSION_TYPE Describes the type of submission. Sourced from govt_snapshot_ctl.s_submission_type.  
PERSON_ID

The Person ID of the student's enrolment or Advanced Standing. Sourced from: Student_unit_attempt.person_id
Element 313.

VCU, VLL, VRL, VSR

COURSE_CD Sourced from: Student_unit_attempt.course_cd  
CRV_VERSION_NUMBER Course Version Number. Sourced from: Student_course_attempt.version_number  
UNIT_CD Unit code. Sourced from: Student_unit_attempt.unit_cd  
UV_VERSION_NUMBER Unit Version Number. Sourced from Student_unit_attempt.version_number  
UNIT_CENSUS_DT The Unit Census date. Element 489. VCU, VLL, VRL, VSR
TR_ORG_UNIT_CD The Training Org. Unit code.  
TR_ORG_UNIT_START_DT The Training Org. Unit start date.  
GOVT_ORG_UNIT_CD Government Organisation Unit Code. Element 333.
The default value 'aou' is used for VET FEE-HELP reporting. (aou = academic organisational unit.)
VLL, VRL, VSR
CAL_TYPE Element 316.  

CI_SEQUENCE_NUMBER

   
REPORTED_COURSE_CD

Reported Course Code. Element 307.
If a Course Reference Code with a System Reference Code Type of RPT-CODE has been defined for the Course Version then that value is the Reported Course Code.
Otherwise, if a Course Reference Code with a System Reference Code Type of QUAL has been defined for the Course Version, and is 10 characters or less in length, then this is the Reported Course Code.
Otherwise, if the Course Version Course Code is 10 characters or less in length then this is the Reported Course Code.

VCU, VLL, VRL, VSR
REPORTED_UNIT_CD Reported Unit code. Element 354.
If a Unit Reference Code with a System Reference Code Type of RPT-CODE has been defined for the Unit Version, then this value is used as the Reported Unit Code.
Otherwise, if the Unit Version Unit Code is 10 characters or less in length, then this value is used as the Reported Unit Code.
Otherwise, the 10 right-most characters of the Unit Version Unit Code is used as the Reported Unit Code.
VCU, VLL, VRL, VSR
UNIT_OF_STUDEY_CMPLTN_STATUS Unit of Study Completion Status. Element 355. VCU
DISCIPLINE_GROUP_CD Discipline Group code for the unit. Sourced from: Unit_discipline.discipline_group_cd  
GOVT_DISCIPLINE_GROUP_CD Government Discipline Group code. Sourced from: Discipline.govt_discipline_group_cd
Element 464.
VLL, VRL
ATTENDANCE_MODE Attendance Mode.  
GOVT_ATTENDANCE_MODE Government Attendance mode. Element 329. VLL, VRL
TOTAL_EFTSL Derived from: enrk_prc_load_vet.enrp_clc_sua_ch_eftsl
Element 339.
VLL, VRL
STUDENT_STATUS Student Status. Derived NVL (student_unit_student_status_snapshot, student_unit_student_status, , student_course_hecs_option.hecs_payment_option,  hecs_payment_option)  
GOVT_STUDENT_STATUS Government Student status. Derived from: Hecs_payment_option.govt_hecs_payment_option of student status
Element 490.
VLL, VRL
VARIATION_REASON_CD Variation Reason Code. Determined in revisions processing. Element 446. VSR
NEW_RECORD_IND New record ID. Determined in revisions processing.  
AUTHORISING_OFFICER_PERSON_ID ID of the Authorising Officer. Only applicable to Revisions processing. Element 543. VSR
CAMPUS_LOCATION Campus location. Derived from Unit mode. Element 477. VLL, VRL
TOTAL_AMOUNT_CHARGED Total amount charged. Derived from:
STAP_GET_AMT_PD_CHRGD_LN_FEE
Element 384.
VLL, VRL
AMOUNT_PAID_UPFRONT Amount paid up-front. Derived from: STAP_GET_AMT_PD_CHRGD_LN_FEE
Element 381.
VLL, VRL
LOAN_FEE Loan fee. Derived see
STAP_GET_AMT_PD_CHRGD_LN_FEE
Element 529.
VLL, VRL
UNIT_OF_STUDY_HELP_DEBT Unit of Study Fee Help Debt amount. Element 558. VLL, VRL
CHESSN The student's CHESSN number. Element 488. VCU
S_REPORTING_STATUS The Record Reporting Status (specified for the snapshot record in STAF8050).  
UPDATE_WHO The name of the user who last updated the record.  
UPDATE_ON The date and time the record was last updated.  

 

Last Modified on 30-May-2012 9:31 AM

History Information

Release Information Project Change to Document
13.1 1323 - Online Help consolidation

Added VET label. Updated links.

12.1.0.3 1708 - Compliance 2011 Added note relating to STUDY_REASON_ID field.
12.0.0.3 1646 - Skills VIC Fee-Help Reporting New page