0.011/15/92 KATHY ARRINGTON 1.0 PROGRAM NARRATIVE ----------------- THIS PROGRAM RUNS AS AN EXTRA CHECK TO BE SURE THE SCANNER DID NOT READ GRADE(S) INCORRECTLY. THE GRADES IN THE VSAM CONTROL FILE ARE COMPARED TO GRADES IN A SEQUENTIAL FILE CREATED BY THE RESCANNING OF ROSTERS. IT SHOULD BE RUN BEFORE GRP310, GPA UPDATE. AFTER ALL GRADE ROSTERS HAVE BEEN SCANNED, UPLOADED, AND POSTED TO THE GRADE CONTROL FILE BY GRP330, THEN ALL GRADE ROSTERS SHOULD BE RESCANNED A SECOND TIME AND UPLOADED. *NOTE* BEFORE SCANNING ROSTERS A SECOND TIME PUT THE ROSTERS IN CLASS-ID ORDER. THIS WILL HELP IN RESEARCHING ERRORS ON THE COMPARE REPORT. SEE SECTION 3.0 (SPECIAL INSTRUCTIONS) FOR AID IN RESEARCHING ERRORS. THEN GRP996 SHOULD BE SUBMITTED FOR EXECUTION. GRP996 WILL LOAD THE VSAM GRADE CONTROL FILE INTO A SEQUENTIAL FILE CHECKING FOR 'W' AND 'F' GRADES REPLACING THEM WITH A SPACE. THIS EDIT WAS ADDED TO PREVENT PREPRINTED GRADES FROM SHOWING UP AS AN ERROR. PREPRINTED GRADES ARE ON THE VSAM FILE BUT NOT ON THE RESCAN FILE. AFTER THE VSAM FILE IS LOADED TO A SEQUENTIAL FILE A ONE TO ONE COMPARISON IS MADE BETWEEN THE TWO FILES. INACTIVE CONTROL NUMBERS IN THE VSAM FILE WILL NOT BE LOADED INTO THE SEQUENTIAL 'ORIGDS' FILE FOR COMPARISON, AS INACTIVE CONTROL NUMBERS SHOULD NOT BE IN THE 'RERUNDS' FILE. THEY WILL BE WRITTEN OUT TO THE INACTIVE CONTROL NUMBER REPORT. IF AN INACTIVE CONTROL NUMBER HAPPENS TO GET IN THE 'RERUNDS' FILE A MESSAGE WILL BE DISPLAYED THAT THE CONTROL NUMBER IS MISSING IN ORIGINAL OPSCAN OUTPUT. THIS IS NOTHING TO BE CONCERNED ABOUT. IF THERE ARE ANY DISCREPANCIES BETWEEN THE TWO DATA FILES, A MESSAGE IS WRITTEN TO THE REPORT FILE. HOWEVER, IF ALL RECORDS MATCH EXACTLY, NO OUTPUT MESSAGES ARE PRODUCED. IF THERE ARE DISCREPANCIES BETWEEN THE TWO DATA FILES THE 'GRADE CONTROL REPORT', GRP730 CAN BE USED TO DETERMINE WHY THE DIFFERENCE OCCURS. GRP730 LISTS ALL OF THE ROSTERS THAT WERE CREATED. IT LISTS THE CONTROL NUMBER, AND CLASS-ID, AND ALSO INDICATES IF THE CONTROL NUMBER IS INACTIVE OR RECREATED. SEE SPECIAL INSTRUCTIONS IN SECTION 3.0 FOR RESEARCHING ERROR REPORT. THERE ARE FOUR TYPES OF MESSAGES IN THE ERROR REPORT PRODUCED BY THE PROGRAM. FOR MORE INFORMATION ON THE VARIOUS MESSAGES ON THE ERROR REPORT SEE SECTION 5.0 'SPECIAL OUTPUT MESSAGES'. 2.0 SAMPLE JCL ---------- //GRP996 JOB (XXXX,YYYY),'COMPARE GRADES',CLASS=F, // PRTY=3,MSGCLASS=A,MSGLEVEL=(2,0) /*ROUTE PRINT RMTZZ //GRP996 EXEC SAS,REGION=1000K //VSAMDS DD DSN=__ADV.SIS.CLUSPROD.GRPCNTL.TTTTTT,DISP=SHR //ORIGDS DD DSN=__AD.SIS.PSEQPROD.GRP996.TTTTTT, // DISP=(,PASS), // UNIT=SYSDA,SPACE=(CYL,(2,2)), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=6800,DSORG=PS) //RERUNDS DD DSN=_______.A.DATA(UPGRAD),DISP=SHR //RERUN2 DD DSN=__AD.SIS.PSEQPROD.GRP996.RERUN, // DISP=(,PASS), // UNIT=SYSDA,SPACE=(CYL,(2,2)), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=6800,DSORG=PS) //SYSUDUMP DD SYSOUT=* //SYSIN DD DSN=SYS5.SIS.PARMLIB(GRP996),DISP=SHR // WHERE '__' MUST BE FILLED IN WITH THE 'A.DATA' DATASET NAME OF WHERE THE UPLOAD MEMBER (UPGRAD) RESIDES. EX: 'VWSCANR' TTTTTT IS THE TERM OF THE VSAM FILE EX: SPRING 2.2 INPUT PARAMETERS ---------------- NONE 3.0 JOB SETUP INSTRUCTIONS ---------------------- SPECIAL FORMS QUEUE: N/A FORMS BUFFER: N/A ALIGNMENT INSTRUCTIONS: N/A PRINTED OUTPUT: INACTIVE CONTROL NUMBER LISTING COMPARE REPORT FORMS TYPE: STANDARD SPECIAL INSTRUCTIONS: BEFORE SCANNING THE ENTIRE SET OF ROSTERS IT WILL HELP TO HAVE THEM IN CLASS-ID ORDER. THIS WILL AID IN RESEARCHING OF THE ERROR MESSAGES ON THE COMPARE REPORT. AFTER RUNNING GRP996: 1) LOOK UP THE CONTROL NUMBER OF THE FIRST ERROR MESSAGE ON GRP730 GRADE CONTROL REPORT. 2) FIND THE CORRESPONDING CLASS-ID. 3) USE THE CLASS-ID TO FIND THE ROSTER. 4) LOOK AT THE ROSTER TO DETERMINE WHETHER THE GRADES WERE MISREAD OR WHETHER THE GRADE CIRCLES WERE DARK ENOUGH OR IF THE INSTRUCTOR LEFT OUT A GRADE, OR IF A PREPRINTED GRADE WAS BLACKEN IN, ETC..... THERE IS NORMALLY A LOGICAL EXPLANATION FOR THE DIFFERENCE. 4.0 FILES ----- 4.1 DATA BASE SEGMENTS USED NONE 4.2 ADDITIONAL FILES USED: GRADE CONTROL VSAM FILE (VSAMDS) GRADES FILE (RERUNDS) TEMP FILE (ORIGDS) 4.3 INPUT/OUTPUT RECORD LAYOUT: FILE NAME: VSAMDS POSITION FROM TO FIELD NAME SIZE TYPE COMMENT -------- ---------- ---- ---- ------- 01 - 07 VSAMCTL 7 A/N CONTROL NUMBER 08 - 21 CLASSID 14 A/N CLASS-ID 22 SESSION 1 A/N SESSION CODE 23 VSAMFLAG 1 A/N UPDATE FLAG 0 - ORIGINAL VALUE CREATED BY GRP336 00 1 - GRADES HAVE BEEN UPDATED TO THE 00 VSAM FILE 2 - GRADES HAVE BEEN UPDATED TO THE 00 DATABASE 24 CNTLFLAG 1 N CONTROL NUMBER FLAG 0 - ORIGINAL VALUE CREATED BY GRP336 00 1 - CONTROL NUMBER HAS BEEN UPDATED TO THE 00 CLASS USER SEGMENT 2 - DEACTIVATED CONTROL NUMBER 00 25 - 26 VSAMCNT 2 N NUMBER OF STUDENTS ON A ROSTER 27 - 326 SSN_GRD OCCURS 0 TO 30 TIMES DEPENDING ON VSAMCNT SSN 9 N STUDENT SOCIAL SECURITY NUMBER GRD 1 A/N STUDENT GRADE FILE NAME: RERUNDS POSITION FROM TO FIELD NAME SIZE TYPE COMMENT -------- ---------- ---- ---- ------- 01 - 07 VSAMCTL 7 A CONTROL NUMBER 08 - 37 GRD 30 A STUDENT'S GRADES 38 - 79 FILLER 42 A FILLER 80 Q_CNTL 1 A QUALITY CONTROL FILE NAME: ORIGDS POSITION FROM TO FIELD NAME SIZE TYPE COMMENT -------- ---------- ---- ---- ------- 01 - 07 VSAMCTL 7 A CONTROL NUMBER 08 - 37 GRD 30 A STUDENT'S GRADES 38 - 79 FILLER 42 A FILLER 80 Q_CNTL 1 A QUALITY CONTROL 5.0 SPECIAL OUTPUT MESSAGES: 1. 'INACTIVE CONTROL NUMBERS IN ORIGINAL OPSCAN OUTPUT' ' CONTROL NUMBER 9999999 ' THIS IS AN INFORMATIONAL MESSAGE AND IS NOT AN ERROR. IT MEANS THE CONTROL NUMBER IN THE VSAM FILE IS AN INACTIVE CONTROL NUMBER. AS THEY ARE NOT LOADED INTO THE ORIGINAL FILE FOR COMPARISON. 2. 'CONTROL NUMBER 9999999 IS MISSING IN RERUN OPSCAN OUTPUT' THIS MESSAGE IS PRINTED WHEN A CONTROL NUMBER ON THE VSAM GRADE CONTROL FILE IS NOT PRESENT IN THE FILE CREATED BY THE RERUN OF GRP700. 3. 'CONTROL NUMBER 9999999 IS MISSING IN ORIGINAL OPSCAN OUTPUT' THIS MESSAGE IS PRINTED WHEN A CONTROL NUMBER ON THE FILE CREATED BY THE RERUN OF GRP700 IS NOT ON THE VSAM GRADE CONTROL FILE. *** NOTE *** THIS MESSAGE WILL ALSO OCCUR IF AN INACTIVE CONTROL NUMBER IS IN THE RERUN DATASET. CHECK TO SEE IF THE CONTROL NUMBER IS IN THE LIST OF INACTIVE CONTROL NUMBERS. IF IT IS, THIS IS OK. HOWEVER, IF THE NUMBER IS NOT INACTIVE, THE CONTROL NUMBER WAS NOT LOADED INTO THE ORIGINAL FILE BECAUSE THE VSAM-FLAG EQUALED ZERO. MEANING THAT THE CLASS WAS NEVER RUN THROUGH THE FIRST TIME. THE GRADE ROSTERS IN THIS SITUATION COULD HAVE BEEN DONE MANUALLY THROUGH GRP020. 4. CONTROL NUMBER 9999999 GRADE DIFFERENCE -- ORIGINAL GRADES = ABC XBDCCD RERUN GRADES = ABC BDCCD' THIS MESSAGE IS PRINTED WHEN THE GRADES OF THE VSAM CONTROL FILE DO NOT MATCH THE GRADES PRODUCED BY THE RERUN. PREPRINTED 'W' & 'F' GRADES WILL BE SPACED OUT. ONLY REAL GRADE DIFFERENCES SHOULD BE REPORTED. THE SCANNER COULD READ ROSTER DIFFERENTLY THE SECOND TIME. FIND ROSTER TO BE SURE THE CORRECT GRADE WAS PROCESSED. 6.0 SPECIAL FEATURES ---------------- 6.1 CALLING PROGRAMS: N/A 6.2 SUBPROGRAMS CALLED: N/A 6.3 MESSAGE SEGMENT CODES: NONE 7.0 PROGRAM OPTIONS: N/A --------------- 8.0 PROGRAM CHANGE HISTORY: ---------------------- 8.1 VERSION NO: V3.1 (NEW PROGRAM) CHANGE DATE: N/A PROGRAMMER NAME: KATHY ARRINGTON PROGRAM CHANGE REQUEST NO: N/A DESCRIPTION OF CHANGE: N/A 8.2 VERSION NO: V3.5 CHANGE DATE: N/A PROGRAMMER NAME: LAYNE WARREN PROGRAM CHANGE REQUEST NO: N/A DESCRIPTION OF CHANGE: MODIFIED JCL TO REFLECT THE CORRECT TEMPORARY FILE FOR DD REFUNDS TO &&GRADES. 8.3 VERSION NO: V4.01 CHANGE DATE: 2/21/89 PROGRAMMER NAME: KATHY ARRINGTON PROGRAM CHANGE REQUEST NO: 00001936 DESCRIPTION OF CHANGE: ADDED $CHARW. FORMAT TO ALL INPUT AND PUT STAMENTS FOR CHARACTER FIELDS TO PREVENT LEADING AND TRAILING BLANKS FROM BEING DROPPED. CHANGED RERUNDS DATASET NAME AND DISPOSITION. 8.4 VERSION NO: V4.09 CHANGE DATE: 11/03/89 PROGRAMMER NAME: BOB DODGE PROGRAM CHANGE REQUEST NO: 00004084 DESCRIPTION OF CHANGE: CHANGED JCL FROM 'USERS.A.DATA' TO 'SCANR.A.DATA'. 8.5 VERSION NO: 4.12 CHANGE DATE: 04/15/90 PROGRAMMER NAME: DANA BRYANT PROGRAM CHANGE REQUEST NO: 4716 DESCRIPTION OF CHANGE: ADDED THE TERM TO THE VSAM FILE NAME IN THE DOCUMENTATION. ADDED THE CNTL-FLAG TO THE VSAM FILE LAYOUT IN THE DOCUMENTATION. UPDATED THE PROGRAM TO REFLECT THE NEW FILE LAYOUT. PROGRAM CHANGE REQUEST NO: 4717 DESCRIPTION OF CHANGE: ADDED CODE TO LIST THE INACTIVE CONTROL NUMBERS FROM THE VSAM FILE. 8.6 VERSION NO: 4.23 CHANGE DATE: 02/15/91 PROGRAMMER NAME: JEAN MAYS PROGRAM CHANGE REQUEST NO: 6395 DESCRIPTION OF CHANGE: ADDED ADDITIONAL COMMENTS TO THE SPECIAL MESSAGES IN THE DOCUMENTATION FOR CLARITY. 8.7 VERSION NO: 4.40 CHANGE DATE: 11/15/92 PROGRAMMER NAME: DANA BRYANT PROGRAM CHANGE REQUEST NO: 10205 DESCRIPTION OF CHANGE: EXPANDED THE DOCUMENTATION TO EXPLAIN HOW TO READ THE ERROR REPORT AND HOW TO USE THE GRP730 GRADE CONTROL REPORT TO FIND ROSTERS AND REVIEW THE ERROR. MODIFIED THE SAS PROGRAM TO IGNORE W(S) AND F(S) FROM THE VSAM FILE TO ELIMINATE ALOT OF THE ERROR MESSAGES WHERE THE SECOND READ DIFFERS FROM THE FIRST ONLY BECAUSE OF THE PREPRINTED GRADES. ADDED THE RERUN2 DATASET TO THE RUN JCL. REMOVED THE TERM PARAMETER FROM THE JOB STATEMENT IN THE DOCUMENTATION.