0.003/13/99 ELVIN FAWLEY 1.0 PROGRAM NARRATIVE ----------------- THIS BATCH PROGRAM PRINTS A REPORT LISTING CLASSES FOR A SELECTED TERM SHOWING THE NUMBER OF STUDENTS REGISTERED, NUMBER OF STUDENTS WITH A GRADE, AND THE NUMBER OF STUDENTS NOT HAVING A GRADE. THE MESSAGE "COMPLETE" WILL BE PRINTED IF ALL STUDENTS IN THE CLASS HAVE GRADES. OTHERWISE, THE MESSAGE "INCOMPLETE" WILL BE PRINTED FOR THE CLASS. THE REPORT MAY BE PRODUCED BASED ON MID TERM GRADES OR END OF TERM GRADES, DEPENDING ON THE VALUE OF THE GRADE PARM OPTION. THE USER MAY REQUEST THAT THE REPORT CONTAIN ONLY A SELECTED CAMPUS OR ALL CAMPUSES. ALSO, THE REPORT MAY BE PRINTED IN ONE OF THREE SEQUENCIES. THE FOLLOWING GIVES A BREAKDOWN OF THE REPORT SEQUENCIES AVAILABLE: CAMPUS DIVISION SEQUENCE - CLASS WITHIN DIVISION WITHIN CAMPUS WITHIN SCHOOL CAMPUS SEQUENCE - CLASS WITHIN CAMPUS WITHIN SCHOOL SCHOOL SEQUENCE - CLASS WITHIN SCHOOL 2.0 SAMPLE JCL: ---------- 2.1 RUN JCL: ------- // JOB //GRP650 EXEC GRP650, // AGENCY=AAA, // COLLEGE=II, // FORM=A000, // QUEUE='*', // SRTSIZE=3,REGION=2048K //GRP650.PARMCARD DD * FALL 83A1 /* // THE USER SHOULD SUPPLY A VALID JOB CARD FOR THIS PROCEDURE CONFORMING TO SYSTEM STANDARDS. SYMBOLIC PARAMETERS ******************* REQUIRED - THE FOLLOWING SUBSTITUTIONS MUST BE PERFORMED ON THE ABOVE JCL'S SYMBOLIC PARAMETERS: AGENCY II - ENTER YOUR COLLEGE'S TWO CHARACTER NAME ABBREVIATION DEFAULT: NONE COLLEGE AAA - ENTER YOUR COLLEGE'S AGENCY CODE NUMBER DEFAULT: NONE OPTIONAL - THE FOLLOWING PARAMETERS WILL NOT NORMALLY BE CODED ON THE "RUN JCL" GIVEN ABOVE BUT ARE PROVIDED FOR USE IN SPECIAL CASES. FORM FORM NUMBER THE OUTPUT IS TO BE STORED UNDER QUEUE QUEUE CLASS THE OUTPUT IS TO BE SPOOLED UNDER SRTSIZE AMOUNT OF DISK STORAGE IN CYLINDERS USED FOR SORTWORK FILES NOTE: THE OPTIONAL PARAMETER DEFAULTS ARE CODED ON THE ON THE "RUN JCL" ABOVE. 2.2 INPUT PARAMETERS: THE USER SHOULD PREPARE A PARAMETER/HEADER CARD AND PLACE IT AFTER THE "//GRP650.PARMCARD DD" CARD USING THE FOLLOWING DIRECTIONS: CC CONTENTS -- -------- 01-06 NAME OF THE TERM YOU DESIRE THE REPORT PRINTED FOR (I.E. 'FALL '). 07-08 LAST TWO DIGITS OF THE YEAR ASSOCIATED WITH THE NAME OF TERM (I.E. '83') 09 CAMPUS CODE YOU DESIRE THE REPORT TO BE PRINTED FOR - (I.E. 'A'). IF CAMPUS IS LEFT BLANK, ALL CAMPUSES FOR THE COLLEGE WILL BE INCLUDED. 10 REPORT SEQUENCE - (I.E. '1') - VALID ENTRIES ARE: BLANK - CAMPUS DIVISION SEQUENCE 1 - CAMPUS SEQUENCE 2 - SCHOOL SEQUENCE 11 END DATE CHECK - (I.E. 'Y') - VALID ENTRIES ARE: BLANK - NO DATE CHECK DONE Y - CHECK END DATE ON CONTROL AGAINST MASTER 12 GRADE OPTION - (I.E. 'E') - VALID ENTRIES ARE: BLANK - PROCESS END OF TERM GRADES E - PROCESS END OF TERM GRADES M - PROCESS MID TERM GRADES 3.0 JOB SETUP INSTRUCTIONS: ---------------------- SPECIAL FORMS QUEUE: STANDARD FORMS BUFFER: STANDARD ALIGNMENT INSTRUCTIONS: STANDARD PRINTED OUTPUT: LIST OF CLASSES WITH MISSING GRADES FORMS TYPE: STOCK 14 7/8 X 11 SPECIAL INSTRUCTIONS: NONE 4.0 FILES ----- 4.1 DATA BASE SEGMENTS USED INSTRUCTOR DATA BASE 1. INSTRUCR (READ ONLY) CLASS DATA BASE 1. CLSMASTR (READ ONLY) 2. CLSDETAL (READ ONLY) 3. CLASSTUD (READ ONLY) CONTROL DATA BASE 1. CTLCAMPM (READ ONLY) 2. CTLQUART (READ ONLY) 3. CTLDIVM (READ ONLY) STUDENT DATA BASE 1. STUREGIS (READ ONLY) 4.2 ADDITIONAL FILES USED: 1. PRTFILE - PRINT FILE (CLASS WITH MISSING GRADES REPORT) 2. SYSOUT - PRINT FILE (RUN STATISTICS) (ABNORMAL PROCESSING MESSAGES) 3. SORTMSG - PRINT FILE (SORT PROGRAM MESSAGES & STATISTICS) 4. PARMCARD - CARD FILE (SUPPLIES USER INPUT PARAMETERS) 4.3 INPUT/OUTPUT RECORD LAYOUTS: N/A 5.0 SPECIAL FEATURES ---------------- 5.1 CALLING PROGRAMS: N/A 5.2 SUBPROGRAMS CALLED: UTL060S, UTL550S, UTL001S 5.3 MESSAGE SEGMENT CODES: N/A 5.4 SPECIAL OUTPUT MESSAGES: 1. ERROR - PARMCARD DD STATEMENT IS MISSING. PLEASE CHECK YOUR JCL DECK FOR ERRORS. RUN ABORTED. MEANING: YOUR JOB CONTROL STATMENTS ARE NOT CORRECT. YOU ARE MISSING THE INDICATED STATEMENT. ACTION : SUPPLY THE MISSING STATEMENT. RE-RUN JOB. 2. ERROR - NO PARAMETER RECORD WAS FOUND FOLLOWING THE PARMCARD DD STATEMENT. RUN ABORTED. MEANING: YOU LEFT OUT OR MISPLACED THE PARAMETER CARD IN THE DECK. ACTION : SUPPLY THE PARAMETER CARD IN THE CORRECT PLACE. RE-RUN JOB. 3. ERROR - NAME OF TERM IS INVALID - RUN ABORTED MEANING: NAME OF TERM SUPPLIED ON THE PARAMETER CARD IS NOT WINTER, SPRING, SUMMER, OR FALL. ACTION : SUPPLY THE CORRECT TERM NAME AND RE-RUN JOB. 4. ERROR - TERM YEAR IS INVALID - RUN ABORTED. MEANING: TERM YEAR SUPPLIED ON THE PARAMETER CARD IS NOT NUMERIC (00 THRU 99). ACTION : SUPPLY THE CORRECT TERM YEAR AND RE-RUN JOB. 5. THE TERM SPECIFIED CAN NOT BE LOCATED ON THE CONTROL DB - RUN ABORTED. MEANING: BEGINNING TERM YEAR SUPPLIED ON THE PARAMETER CARD DOES NOT EXIST ON THE CONTROL DATA BASE. ACTION : SUPPLY A TERM THAT EXISTS ON THE CONTROL DB. 6. ERROR - CAMPUS CODE SPECIFIED CAN NOT BE LOCATED ON THE CONTROL DB - RUN ABORTED. MEANING: THE CAMPUS CODE SUPPLIED ON THE PARAMETER CARD CAN NOT BE LOCATED ON THE CONTROL DATA BASE. ACTION : SUPPLY A VALID CAMPUS CODE FOR YOUR COLLEGE ON THE PARAMETER CARD. 7. ERROR - REPORT SEQUENCE CODE IS INVALID - RUN ABORTED. MEANING: REPORT SEQUENCE IS NOT A ' ', '1', OR '2'. ACTION : REFER TO THE INPUT PARAMETERS SECTION OF THIS DOCUMENT FOR VALID ENTRIES AND DESCRIPTIONS. 8. WARNING - CLASS DETAIL SEGMENT NOT FOUND. PROCESSING CONTINUES. CLASS INFORMATION FOLLOWS: MEANING: WHEN TRYING TO LOCATE THE INSTRUCTOR TEACHING THE CLASS NO ENTRY WAS FOUND. INSTRUCTOR NAME WILL DEFAULT TO 'UNKNOWN'. ACTION : CORRECT THE CLASS AND/OR INSTRUCTOR INVOLVED. 9. ERROR - NO CAMPUS SEGMENT FOUND ON THE CONTROL DATA BASE RUN CONTINUES. KEY FOLLOWS: MEANING: WHEN PRINTING A CAMPUS SEQUENCED REPORT A CAMPUS NAME COULD NOT BE LOCATED ON THE CONTROL DATA BASE. ACTION : CORRECT THE CAMPUS INVOLVED. 10. ERROR - NO DIVISION SEGMENT WAS FOUND ON THE CONTROL DATA BASE. RUN CONTINUES. KEY FOLLOWS: MEANING: WHEN PRINTING A CAMPUS DIVISION SEQUENCED REPORT A DIVISION NAME COULD NOT BE LOCATED ON THE CONTROL DATA BASE. ACTION : CORRECT THE DIVISION INVOLVED. 11. ERROR - UNEXPECTED STATUS CODE RETURNED FROM DLI CALL. RUN ABORTED. CALL INFORMATION FOLLOWS: MEANING: THERE IS SOMETHING WRONG WITH YOUR DATA BASES OR THE SYSTEM. ACTION : SAVE ALL INFORMATION AND NOTIFY YOUR SUPPORT CENTER IMMEDIATELY. 12. ERROR - NO INSTRUCTOR FOUND. PROCESSING CONTINUES. KEY INFORMATION FOLLOWS: MEANING: WHEN TRYING TO LOCATE THE INSTRUCTOR TEACHING THE CLASS NO ENTRY WAS FOUND. INSTRUCTOR NAME WILL DEFAULT TO 'UNKNOWN'. ACTION : CORRECT THE CLASS AND/OR INSTRUCTOR DATA BASE. 6.0 PROGRAM OPTIONS: N/A ---------------- 7.0 PROGRAM CHANGE HISTORY: ----------------------- 7.1 VERSION NO: V1.8 CHANGE DATE: 07/13/84 PROGRAMMER NAME: FAWLEY PROGRAM CHANGE REQUEST NO: N/A DESCRIPTION OF CHANGE: NEW RELEASE 7.2 VERSION NO: V2.8 CHANGE DATE: 04/13/86 PROGRAMMER NAME: CHARLIE FLEET PROGRAM CHANGE REQUEST NO: STC-VW-158 DESCRIPTION OF CHANGE: ADD PARAMETER TO EXCLUDE GRADES FOR CLASSES WHOSE END DATE IS AFTER TERM END DATE. 7.3 VERSION NO: V2.13 CHANGE DATE: 01/05/87 PROGRAMMER NAME: TONY SANTOS PROGRAM CHANGE REQUEST NO: STC-TC-074 DESCRIPTION OF CHANGE: ADDED LOGIC TO CALL 'UTL001S' TO CENTER COLLEGE REPORT HEADINGS. 7.4 VERSION NO: V2.17 CHANGE DATE: 01/05/87 PROGRAMMER NAME: ELVIN FAWLEY PROGRAM CHANGE REQUEST NO: SCP-SO-171 DESCRIPTION OF CHANGE: CHANGED "QUARTER" TO "TERM" IN PROGRAM MESSAGES. CHANGED ACCESS TO THE STUREGIS SEGMENT VIA CLSSTUL LOGICAL DBD TO IMPROVE PERFORMANCE. 7.5 VERSION NO: V4.12 CHANGE DATE: 04/12/90 PROGRAMMER NAME: BETH DUFF PROGRAM CHANGE REQUEST NO: 00004686 DESCRIPTION OF CHANGE: ADDED PARM OPTION TO ALLOW USER TO SPECIFY WHETHER THEY ARE PROCESSING END OF TERM GRADES OR MID TERM GRADES. 7.6 VERSION NO: V4.20 CHANGE DATE: 01/20/91 PROGRAMMER NAME: RH.CLARK PROGRAM CHANGE REQUEST NO: 00006693 DESCRIPTION OF CHANGE: - MODIFICATIONS WERE MADE TO THE CALLS TO ALL DATA BASES TO BRING THESE CALLS UP TO THE STANDARD USE OF AN IOAREA. SEE PAGE 29 OF THE 02/90 PROGRAMMING STANDARD, PROCEDURES AND GUIDELINES MANUAL. 7.7 VERSION NO: V5.08 CHANGE DATE: 01/15/94 PROGRAMMER NAME: BARBARA SHANKO PROGRAM CHANGE REQUEST NO: 00013649 DESCRIPTION OF CHANGE: - ADDED THE CLASS BEGIN AND END DATE TO THE REPORT. 7.8 VERSION NO: V7.02 CHANGE DATE: 01/99 PROGRAMMER NAME: KATHY HARCUM PROGRAM CHANGE REQUEST NO: 00018008 DESCRIPTION OF CHANGE: -MODIFIED TO ENSURE COMPLIANCE WITH YEAR 2000 PROCESSING AND NEW COBOL COMPILER. -ADDED CALL TO UTL060S FOR CENTURY PROCESSING.