cronutil is a collection of routines for determining whether a student, or a student in a course, should be considered for a process related to Enrollment, Attendance, Grade Reporting, etc....
cronutil hides the details of how the above information is stored and retrieved from the application code. Therefore, application programs should be using cronutil services as much as possible to limit the specifics of manipulating that data within the boundaries of this utility.
The following is a catalog of the availble services with a brief discussion of what the service provides and the parameters available to it. Some things you should know about when reading the service specifications are:
DEFINE [NEW]
This must be present in any module which will be using any if the utility
services. The instantiating procedure must use the NEW keyword. Any
child procedures should omit the NEW keyword or they will start another
instance of the utillity.
CLEAN_UP
This must be invoked by the procedure that created the current instance of
the utility. It releases all allocated resources and terminates
the instance associated with the current procedure. Generally, the module
that used DEFINE NEW is the same one that should have a CLEAN_UP call.
You must make sure that all exit paths in your program properly invoke the CLEAN_UP service. If not, your program will consume an unnecessarily large amount of memory which can only be freed by exiting the Progress session completely!
________________________________________________ Student Based Services
GET STUDENT-INFO stu-year-buff info-name date info-flag
This service allows you to know a specific piece of information from a
given student record, for the date you are interested in.
Info-name must be an expression, that should evaluate to one of the
following tokens.
The date passed generally to this service for PROGRESS should be the last day of a particular progress period. For either GRADES, GPA_CALCS, RANKING, or HONOR_ROLL, the date should be the last day of a particular grading period.
Info will be returned as `?' if you fail to pass a loaded stu-year-buff, pass an unsupported info-name, or pass an unknown date.
GET SCHEDULE-INFO stu-schd-buff info-name date info-flag
This service allows you to know a specific piece of information from a
given student record, for the date you are interested in. Info-name
must be an expression, that should evaluate to one of the following
tokens.
The date passed generally to this service for PROGRESS should be the last day of a particular progress period. For either GRADES, GPA_CALCS, RANKING, or HONOR_ROLL, the date should be the last day of a particular grading period.
Info will be returned as `?' if you fail to pass a loaded stu-schd-buff, pass an unsupported info-name, or pass an unknown date.
GET STUDENT-HISTORY-ENTRY stu-year-buff date stu-history-buffer
This service will return the history entry that best describes the student
as of the date passed. If ypu pass a date that is before the first day
of the students enrollment in the system, the returned buffer is empty
and unavailable.
_______________________________________________________ Other Services
GET SECTION-INFO master-schd-buff info-name date info
This service allows you to know a specific piece of information from a
given course section, for the date you are interested in.
Info-name must be an expression, that should evaluate to one of the
following tokens.
Info will be returned as `?' if you fail to pass a loaded master-schd-buff, pass an unsupported info-name, or pass an unknown date.
October 21, 1997
March 7, 1996:
February 29, 1996:
February 26, 1996:
February 23, 1996:
February 19, 1996: