0.002/15/91 PAT BUCHANAN 1.0 PROGRAM NARRATIVE ----------------- THIS PROGRAM IS DESIGNED TO SELECT A SPECIAL CATEGORY OF STUDENTS WHO ARE IN THE SPECIAL OPPORTUNITY COLLEGE PROGRAM. THE INFORMATION PERTAINING TO THESE STUDENTS RESIDES IN THE STUEXTEN SEGMENT OF THE STUDENT DATA BASE, AND REFLECTS DATA WHICH IS INPUT VIA REG090, A SPECIAL SCREEN DESIGNED FOR UPDAT- ING SOC STUDENTS. THE REPORT PROVIDES A SUMMARY OF HEADCOUNTS BY CURRICULUM AND BY NETWORK TYPE. PROCESSING IS DONE IN THE FOLLOWING MANNER. ALL STUDENTM SEGMENTS ARE READ AND THE STU- EXTEN SEGMENT CHECKED TO SEE IF THE STUDENTS ENTRY DATE IS IN THE RANGE PASSED TO THE PROGRAM VIA THE PARMCARD. IF THE STUEXTEN RECORD DOES MEET THIS CRITERIA, THE SOC CURRICULUM, NETWORK TYPE, ENTRY DATE, SOCIAL SECURITY NUMBER, AND STUDENT'S CURRICULUM ARE MOVED TO THE SORT FILE. THE RECORDS ARE SORTED IN NETWORK CATEGORY AND SOC CURRICULUM ORDER. AS EACH RECORD IS RE- TURNED FROM THE SORTFILE THE THE RESPECTIVE QUARTER FOR THE CURRICULUM IS PROCESSED BASED ON THE ENTRY DATE INTO THE PROGRAM. IF THE STUDENT'S CURRICULUM (LOCATED IN STUDENTM) IS THE SAME AS THE SOC CURRICULUM BEING PROCESSED THE HEADCOUNT COUNTER IS UPDATED, OTHERWISE ONLY THE PROGRAM COUNTER IS UPDATED. SHOULD THE STUDENT BE ENROLLED IN A CURRICULUM OTHER THAN THOSE FOUND IN THEIR SOC PROGRAM CURRICULUMS, THE STUDENTS SOCIAL SECURITY NUMBER AND CURRICULUM ARE DISPLAYED SEPARATELY AND THE STUDENT IS NOT INCLUDED IN THE HEADCOUNT. FINAL TOTALS ARE PRINTED FOR BOTH CATEGORIES ON THE REPORT. A PARMCARD IS AVAILABLE SO THAT AN ENTRY DATE RANGE CAN BE ENTERED FOR REPORT SELECTION. THE RANGE SHOULD CO-INCIDE WITH THE QUARTERS SELECTED, FOR EXAMPLE MONTH OF '04' THRU '12' IN ORDER TO GET THREE QUARTERS. '07' THRU '12' TO GET TWO QUART- ERS. SELECTION FROM '07' THRU TO '06' OF THE NEXT YEAR, FOR AN ACADEMIC YEAR IS POSSIBLE, HOWEVER THE REPORT WILL REFLECT THE CURRENT YEAR IN THE 3RD AND 4TH QUARTER COLUMNS, AND THE NEXT YEARS HEADCOUNT IN THE 1ST AND 2ND QUARTER COLUMNS. SEE THE INPUT CARD FOR VALID QUARTER SELECTIONS. * 2.0 SAMPLE JCL ---------- PROCEDURE REG995 EXECUTES REG995. //REG995 JOB (PPPP,RRRR,09,50),REG995 ,MSGLEVEL=(1,1), // MSGCLASS=A,PRTY=3,CLASS=F /*ROUTE PRINT NNNN //REG995 EXEC REG995,COLLEGE=XX,AGENCY=XXX,SRTSIZE=X //REG995.PARMCARD DD * BBBBBB EEEEEE // SYMBOLIC DESCRIPTION ******************** REQUIRED - AGENCY COLLEGE AGENCY CODE NUMBER (E.G. AGENCY=295) COLLEGE TWO CHARACTER COLLEGE NAME ABBREVIATION (E.G. COLLEGE=TC) OPTIONAL - CENSUS THREE CHARACTER CENSUS DATA BASE IDENTIFIER DEFAULT: NONE (E.G. CENSUS=CEN) FORM FORM NUMBER THE OUTPUT IS TO BE STORED UNDER DEFAULT: A000 (E.G. FORM=0002) QUEUE QUEUE CLASS THE OUTPUT IS TO BE SPOOLED UNDER DEFAULT: * (E.G. QUEUE='A') SRTSIZE AMOUNT OF DASD STORAGE IN CYLINDERS ALLOCATED TO EACH SORT WORK FILE DEFAULT: 3 (E.G. SRTSIZE=5) RUNTYPE INDICATES WHETHER OR NOT TO USE TEST OR PRODUCTION FILES (DEFAULT = PROD) (E.G. RUNTYPE=TEST) DYTYPE INDICATES WHETHER OR NOT TO USE TEST OR PRODUCTION DATABASE (DEFAULT = PROD) (E.G. DBTYPE=TEST) 2.2 INPUT PARAMETERS: PPPP - PROGRAMMER NUMBER RRRR - ROOM NUMBER NNNN - REMOTE SITE INPUT RECORD: BBBBBB EEEEEE CARD COLUMNS: 1-6 WHERE BBBBBB IS THE BEGINNING RANGE DATE FORMAT MMDDYY 7-7 BLANK SPACE 8-13 WHERE EEEEEE IS THE BEGINNING RANGE DATE FORMAT MMDDYY EX: 010190 123190 (01/01/90 TO 12/31/90) FOR ONE YEAR) 070190 123190 (07/01/90 TO 12/31/90) FOR TWO QUARTERS 100190 093090 (10/01/90 TO 09/30/91) FOR AN ACADEMIC YEAR 3.0 JOB SETUP INSTRUCTIONS ---------------------- SPECIAL FORMS QUEUE: A000 FORMS BUFFER: STANDARD ALIGNMENT INSTRUCTIONS: STANDARD PRINTED OUTPUT: SOC CURRICULUM SUMMARY REPORT FORMS TYPE: 14 X 11 SPECIAL INSTRUCTIONS: NONE * 4.0 FILES ----- 4.1 DATA BASE/SEGMENTS USED: ----------------------- 1. CTLCAMPM SEGMENT (READ ONLY) 3. STUDENTM SEGMENT (READ ONLY) 4. STUEXTEN SEGMENT (READ ONLY) 6. CURMASTR SEGMENT (READ ONLY) 4.2 ADDITIONAL FILES USED: --------------------- 1. SORTFILE (FILE USED WHEN SORTING). 2. PRTFILE (FILE USED FOR PRINTED OUTPUT). 3. PARMCARD (FILE USED TO PASS INPUT DATA TO PROGRAM). 4.3 INPUT/OUTPUT RECORD LAYOUT: N/A -------------------------- 5.0 SPECIAL OUTPUT MESSAGES: ----------------------- 1. MESSAGE: NO DATE FOUND FOR PARMCARD BEGIN DATE !!! RUN STOPPED FOR REG995 MEANING: NO PARM CARD WAS FOUND AFTER THE EXEC STATEMENT ON THE JCL FOR THIS PROGRAM ACTION: A PARM CARD IS REQUIRED FOR THIS JOB. PLEASE CHECK PARAGRAGH 2.2 FOR DETAILS OF THE INPUT RECORD 2. MESSAGE: NO DATE FOUND FOR PARMCARD END DATE !!! RUN STOPPED FOR REG995 MEANING: THE ENDING RANGE OF DATES WAS NOT FOUND ON THE PARMCARD ACTION: ENTER AN END RANGE DATE ON THE PARM CARD AND RERUN 3. MESSAGE: BEGIN MONTH IS NOT IN VALID RANGE .. RUN STOPPED FOR REG995 MEANING: THE BEGIN MONTH WAS CHECKED FOR VALIDITY AND WAS NOT VALID ACTION: THE BEGIN MONTH MUST BE BETWEEN 01 AND 12 MESSAGE: BEGIN DAY IS NOT IN VALID RANGE .. RUN STOPPED FOR REG995 MEANING: THE BEGIN DAY WAS CHECKED FOR VALIDITY AND WAS NOT VALID ACTION: THE BEGIN DAY MUST BE BETWEEN 01 AND 31 TO BE VALID 5. MESSAGE: END MONTH IS NOT IN VALID RANGE .. RUN STOPPED FOR REG995 MEANING: THE END MONTH WAS CHECKED FOR VALIDITY AND WAS NOT VALID ACTION: THE END MONTH MUST BE BETWEEN 01 AND 12 6. MESSAGE: END DAY IS NOT IN VALID RANGE .. RUN STOPPED FOR REG995 MEANING: THE END DAY WAS CHECKED FOR VALIDITY AND WAS NOT VALID ACTION: THE END DAY MUST BE BETWEEN 01 AND 31 TO BE VALID 7. MESSAGE: BEGIN YEAR IS NOT NUMERIC - RUN STOPPED FOR REG995 MEANING: THE BEGIN YEAR ON THE PARM WAS NOT A NUMERIC VALUE ACTION: CORRECT THE VALUE ON THE PARMCARD 8. MESSAGE: END YEAR IS NOT NUMERIC - RUN STOPPED FOR REG995 MEANING: THE END YEAR ON THE PARM WAS NOT A NUMERIC VALUE ACTION: CORRECT THE VALUE ON THE PARMCARD 9. MESSAGE: BEGIN YEAR CANNOT BE GREATER THAN END YEAR RUN STOPPED MEANING: THE BEGIN YEAR ENTERED ON THE PARM MUST BE EQUAL OR LESS THAN THE END YEAR. ACTION: CORRECT THE VALUE ON THE PARM CARD AND RERUN JOB 10. MESSAGE: STUDENTS CURRICULUM NOT FOUND IN SOC PROG CURRICULUM STUDENTS SOCIAL SECURITY IS ................. CURRICULUM IS ... MEANING: WHEN PROCESSING THE SOC PROGRAM RECORDS FOUND IN STUEXTEN, THE STUDENT'S CURRICULUM DID NOT MATCH ANY CURRICULUM FOUND IN THEIR SOC PROGRAM RECORDS. IT THEREFORE COULD NOT BE INCLUDED IN ANY HEADCOUNT COLUMN FOR THIS STUDENT. ACTION: THIS IS AN INFORMATIONAL MESSAGE ONLY * 11. MESSAGE: 'FATAL ERROR - REG995 RUN ABORTED' 'DBD-NAME =' 'SEGMENT-NAME =' 'SEGMENT-LEVEL =' 'STATUS-CODE =' MEANING: THERE WAS A DLI ERROR IN A CALL TO A DATA BASE ACTION: CONTACT THE COMPUTER CENTER FOR ASSISTANCE. 6.0 SPECIAL FEATURES: ---------------- 6.1 CALLING PROGRAMS: N/A 6.2 SUBPROGRAMS CALLED: UTL001S, UTL550S 6.3 MESSAGE CODES: N/A 7.0 PROGRAM OPTIONS: N/A --------------- 8.0 CHANGE HISTORY -------------- 8.1 VERSION NO: V4.20 CHANGE DATE: N/A PROGRAMMER NAME: PAT BUCHANAN (TCC) PROGRAM CHANGE REQUEST NO: I: 00006480 DESCRIPTION OF CHANGE: N/A (INITIAL RELEASE)