Purpose

This function enables the submission of batch requests to HEIMS for CHESSN Allocation or retrieval from the HEIMS database.

This job enables the submission of batch requests to HEIMS for Student CHESSN Details from the HEIMS database. The function:

• Checks the Batch Limit

  The maximum number of requests per day (HEIMS time) is defined in the configuration form ORGF0123.

• Creates a Request Record

  In the context of processing the request, the request statuses and their meanings are:

• Identifies Students for Inclusion in the Request

  The maximum number of students that can be included in the request is defined in the configurations form ORGF0123

  The set of students being transmitted can be new students, continuing students or a mix of both. This function will assume all students are ‘New’ until a data issue is identified. The process will then determine if the person’s continuing vs. new to identify if the data problem can be avoided. For example, the person is continuing and the data is optional for a continuing student.

  If the data required for Year 12 Details or HEP details is not known and the Attended Year 12 or Attended Previous HEP is ‘Attended Year 12’ or ‘Attended Previous HEP’, the Attended Year 12 or Attended Previous HEP value should change to ‘Unknown’.

• Validates Transaction Data

  Data is collected for those students requiring a CHESSN and validations are performed to ensure the required data is present. This also includes Sex Code and Citizenship Code are valid.

• Creates Transaction Records

  A HEIMS transaction record is created for each student included in the batch.

  The transaction statuses applicable during the request process are:

• Performs Authentication with HEIMS

  HEP confirms with HEIMS that it has a valid request. When approved, the next process continues.

• Transmits the Request

  The Request Control Data and Request Transaction data are sent to HEIMS for processing.

• Handles HEIMS Validation and Error Responses

  Acknowledges HEIMS validation and any error messages

• Receives HEIMS Acknowledgement

  HEIMS returns a status report including any invalid records, such as DUPLICATE, ARCHIVE or FAILURE.

• Performs Error Handling

For further information see Maintain Person CHESSN (ADMF32W0); Person CHESSN Detail History (AUDF3192), Batch CHESSN Allocation Results (ADMJ3910), or CHESSN Allocation Report (ADMR3910).

This job is accessed from the main menu. Message 6636 is displayed - 'No parameter exists for this job. Do you wish to schedule the job to run as soon as possible.' N/Y. view the job in progress in JBSF5300, or check the job log in JBSF5301.

Before undertaking any processing, the batch CHESSN allocation limit must be assessed. If the limit has been reached for the current 24-hour period, the request cannot proceed.

The transaction limit is based on a 24-hour from Midnight period from the perspective of the HEIMS server. The HEIMS sever is based in Canberra on Australian Eastern Standard Time (AEST).

HEIMS will be online 24 hours seven days a week with 3 schedules service outages. Clients will need to schedule the Request and Results processes outside the defined outage periods. If the processes are run during outage periods timeouts will occur and the process will fail. If the HEIMS server is down, or the HEIMS site is down, the message returned from HEIMS will indicate HTTP/1.1 404 Not Found or HTTP/1.1 500 Internal Server Error.

Rules/Notes:

Validations include:

• For any Exception Update, the status of the current HEIMS request to FAILED before logging parameters.
• Only one instance of this job can be run at any given time.
• The Person ID is used as the Transaction ID.
• The Sex Code value submitted via the CHESSN interface is either 'M' or 'F'; 'U' is not a valid value.
• The Citizenship Code submitted via the CHESSN interface must map to a Government Citizenship Code that is one of (1, 2, 3, 4, 5 or 8); 9 is not a valid code
• If the Country Code is 1100, then the Postcode must not be null, but in the range of 0001 to 9999
• Postal address must be present.