OASIS Previous/Next Term Utility

Many programs need to fetch more than one term. The SI0900E utility may only be invoked once in a program. This utility expands on the functionality by determining a previous or next term, if such needs to be determined.

In addition, the utility is semester aware, so no program changes will need to be made to accommodate Auburn's change to the semester system.

Usage

There is a copy member called LIB0900H which contains the parameter format. The utility requires an 11 byte parameter field, constructed as follows:

Base Term (5 bytes) - This is the term from which the next or previous term is to be determined. Format is CCYYT.
Returned Term (5 bytes) - This is the calculated term based on the base term and the program option. Format is CCYYT.
Program option/return code.
For input to the SI0900H routine, the following are valid:
- Blank - Determine Previous Term
- N - Determine Next Term
- P - Determine Previous Term
When examined for output after the routine has been called, the following values are used:
- 0 = Routine Successful
- 1 = Bad Base Year Specified
- 2 = Bad Base Term Specified
- 3 = Bad Program Option Specified

Invoke the routine as follows:

SI0900H yyyy

where yyyy is the passed parameter variable.

SI0900H Example

A sample program might look as follows:


MACRO
FILE FILE01
   ...
   ...
   ...
  %LIB0900H

JOB INPUT NULL
  HPARM1 = '2001S'
  HPARM3 = 'P'
  %SI0900H HPARM
  DISPLAY HPARM
  STOP

This is a very simplistic example of use of the SI0900H routine. It will determine the previous term to be 2000F.

No JCL changes are required to use this utility.

OIT--Applications Support

Last Modified: Tuesday, 28-Nov-2000 10:35:58 CST