Top of STA | Index | Table of Contents | Feedback |
STAJ0130 - Create Commonwealth Learning Scholarship File
Purpose | Enables production of the Commonwealth Learning Scholarship file for submission to Government. | |
SubSystem | Statistics | |
Normally Run By | Statistics Specialist | |
Anticipated Frequency | As required | |
Structure | Block | Create Commonwealth Learning Scholarship File |
Tab | Parameters |
This job creates the Commonwealth Scholarship file ('CS' file). This file contains, for each half year, records of all students who had a Commonwealth Scholarship where the scholarship status is Active or Deferred , or where the scholarship has a Terminated Date within the reporting period as defined by the parameters. The process stores the records in the GOVT_SCHOLARSHIP_SNAPSHOT table and then writes them out to the Commonwealth Scholarship file. Any errors or warnings are reported in the System Log Entry table (s_log_entry) along with a message number which corresponds to the reason for the error. The job reports on students with a Person Scholarship (in SCHF1200 - . Student Scholarship (recorded in RESF3500 - are also reported but only where these are not reported as Person Scholarships. Note: Scholarship 'Versions' are recorded in SCHF1200 and Scholarship 'Types' are recorded in RESF3500. For the first submission each half year the process is fairly straightforward. Records are selected from Person Scholarships and their Management Period Activity (in SCHF1200) and, if not present there, the student Scholarships and their Status Activity (in RESF3500). Checks are made to ensure the student is reportable and extra details are gathered to create records in the govt_scholarship_snapshot table. All records that are created in the govt_scholarship_snapshot will have the government_reportable_ind set to 'Y'. When the file is being created the records will be selected from govt_scholarship_snapshot for the current submission where the government_reportable_ind = 'Y'. For the second and subsequent submissions the logic differs. The
record selection is the same. The same selection criteria as for the first
submission are used to find all the appropriate records and get the extra
details. The records are inserted into govt_scholarship_snapshot however
the government_reportable_ind will be set to 'N' for all records as a
default. The process then compares the content of this snapshot with the
content from the previous most recently completed snapshot. Inserts,
deletes and updates are found, the scholarship variation code is set
appropriately and the government_reportable_ind will be changed from 'N'
to 'Y' for these records. The process stores the records in the GOVT_SCHOLARSHIP_SNAPSHOT table and then writes them out to the Commonwealth Scholarship (CS) file. Any errors or warnings are reported in the System Log Entry table (s_log_entry) along with a message number which corresponds to the reason for the error. For insights into statistics see Understanding HE Statistics (STAINTR3). This job is accessed via the main menu. |
The Create Commonwealth Learning Scholarship File contains: Tab
|
Rules/Notes: Submission Year, Submission Type and Submission Number are mandatory. If the System Submission Type = SCHLSHP, scholarships with a Commonwealth Scholarship Type of 1, 2, 3, 4, 5, 6, 8, 9, A and B will be included in the file. If the System Submission Type = SCHCASIP then only scholarships with a Commonwealth Scholarship Type = 7 will be included in the file. The Submission Year and Submission Number must exist as a Government Submission Control record (see STAF1350) with a System Submission Type of SCHLSHP or SCHCASIP. If one or more completed snapshots exist for a System Submission Type of SCHLSHP or SCHCASIP, any subsequent snapshots with the same start date, end date and submission year will only include the revisions to the completed snapshot(s). The value of the Commonwealth Scholarship Status Code (Element 526) recorded for a student's scholarship will be validated against their enrolment details for the scholarship period. Any validation rules breached for this element will be written to the error log. Breaches of the validation rules for this element will not prevent records from being written to the Commonwealth Scholarships file. Validation errors will be handled as warnings and job processing will continue as normal. Validations include:
Government Scholarship Status is derived from the Person Scholarship Status and by checking this against current or previous management period statuses relevant to the submission. |
Creating a Commonwealth Scholarship file: The process will extract records from the GOVT_SCHOLARSHIP_SNAPSHOT table and other Callista tables to create the Commonwealth Scholarship file. The file is created to Government specifications - see below. Errors will be logged to the S_LOG_ENTRY table, enabling users to query the results. A System Log Type, 'CL_SCHLSHP' is used to record the detail. Once created, the file will be stored in the 'KEEP' directory as defined in the S_JOB_CONTROL table. File name: The file name is HHHHXXYYYY.NNNNN where:
For example, 1234SS2011.00001 Notes: The file must be
sorted in ascending order of CHESSN. |
Rules/Notes: Government Scholarship Type values applicable to the process are:
Government Scholarship Status values are:
Government CLS Termination Reason Code values are:
Scholarship Variation Code values are:
|
If scholarship details that have previously been submitted to the Government for a student in a submission period are modified, providing the modification does not result in a change to the scholarship record identifier, a new record will be submitted to Government with the updated details and a Scholarship Variation Code =1, which indicates that the original submission is to be modified.
If changes have been made to the scholarship record identifier for previously reported scholarship records or the scholarship record identifier no longer exists in the scholarships data, a new record will be submitted to Government for the deleted / modified scholarship record with a Scholarship Variation Code of '2' which indicates that the previously submitted data is to be deleted.
An exception to the above exists where a CAS - Indigenous Payment (CASIP) record is submitted with a Commonwealth Scholarship Status = 4. After the first unit of study census date within the scholarship period, the CASIP record must be re-submitted to Government with a Commonwealth Scholarship Status of 5 or 6 to indicate the student's enrolment status. The change to the status results in a change to the scholarship record which should trigger the old record to be deleted (reported with a Scholarship Variation Code = 2). However, in this case a deletion record must not be created and a new record will still be submitted for the CASIP with a Commonwealth Scholarship Status of 5 or 6.
The following data is contained in the Commonwealth Scholarship (CS) File.
Element | Element No | Width | Type |
Student Identification Code | 313 | 10 | Alphanumeric |
CHESSN Code | 488 | 10 | Alphanumeric |
Student Title | 405 | 15 | Character |
First Name | 403 | 15 | Character |
Student Surname | 402 | 30 | Character |
Postal Address line 1 | 406 | 38 | Character |
Postal Address line 2 | 407 | 38 | Character |
Postal Address - Scholarship Post code | 568 | 10 | Alphanumeric |
Postal Address - Town/Suburb | 466 | 27 | Character |
Postal Address - State code | 467 | 3 | Character |
Postal Address - Country name | 468 | 20 | Character |
Commonwealth Scholarship Type code | 545 | 1 | Alphanumeric |
Reporting Year/ Period | 415 | 5 | Numeric |
Commonwealth Scholarship Status code | 526 | 1 | Numeric |
Commonwealth Scholarship Termination Reason Code | 538 | 1 | Numeric |
Scholarship Variation Code | 567 | 1 | Numeric |
Filler (ASCII characters including spaces) | N/A | 149 | Alphanumeric |
Job Error Handling
When this job runs, any exceptions encountered are logged, but processing is allowed to continue rather than being terminated. Although no snapshot is generated when this occurs, the log records generated will allow the user to identify as many processing errors as possible in a single run.
Exceptions for this job are flagged in the S_LOG_ENTRY table by the entry 'EXCEPTION' as part of the key field.
Last Modified on 23-Feb-2018 2:43 PM
History Information
Release Version | Project | Change to Document |
14.0.0.3, 15.0.0.2 & 15.1 | 1408 - PC 136 | Included reference to Termination Date |
12.1.1.0 | 1708 - Compliance 2011 - Calipso 31933 | Updated DEEWR file naming convention. |
11.1.0.3 | 1600 - Calipso 28525 | Scholarship Types A and B added to list of types, to validation, and to note in Rules/Notes section. Also changed the Element type for the Govt Scholarship Type in the CS file from 'numeric' to 'alphanumeric'. |
11.1.0.2. | Calipso 26265 | Text for validations rewritten. |
11.0.0.0.0.0 | 1437 - Scholarships Part 2 | New Introduction, job error handling section and explanation of derivation of govt status values for person scholarships |
10.1 | 1340 DEEWR 2007 Pt 2 |
Major changes to this
process. |