0.002/15/92 MARY HARVEY 1.0 INTRODUCTION: PERIODICALLY STUDENTS ARE ASKED TO EVALUATE THEIR INSTRUCTORS. THEY ANSWER TWENTY PREPARED QUESTIONS REGARDING THEIR INSTRUCTORS PERFORMANCE. THE PURPOSE OF THE STUDENT EVALUATION SYSTEM IS TO PROVIDE FAST, EFFICIENT SUMMARIZED REPORTS FROM THE DATA GENERATED BY THE INDIVIDUAL STUDENTS' EVALUATIONS. THESE SUMMARIZED REPORTS CAN CONTAIN SUMMARIES OF AN INDIVIDUAL CLASS OR A SUMMARY OF ALL CLASSES TAUGHT BY AN INSTRUCTOR FOR THE TERM BEING EVALUATED. THIS SUBSYSTEM ALSO GENERATES CONTROL REPORTS, INSTRUCTIONAL MEMOS, AND IDENTIFICATION LABELS TO PROVIDE ASSISTANCE IN THE EVALUATION PROCESS. A VSAM FILE IS BUILT FROM THE CLASS AND INSTRUCTOR DATA BASES FOR EACH TERM. THIS FACULTY EVALUATION VSAM FILE IS USED FOR ALL SUBSEQUENT PROCESSING BY THIS SUBSYSTEM. * 2.0 SYSTEM NARRATIVE: DEFINING SPACE ON A PERMANENT DISK FOR THE THREE TERM-SPECIFIC FACULTY EVALUATION VSAM FILES IS THE FIRST PROCESS IN THE FACULTY EVALUATION SUBSYSTEM. THIS MUST BE ACCOMPLISHED BY THE REGIONAL COORDINATOR. THE JCL LISTED BELOW SHOULD BE USED BY THE REGIONAL COORDINATOR TO DEFINE SPACE FOR THE THREE TERM-SPECIFIC VSAM FILES, BUILD THE ALTERNATE INDEX FOR THE VSAM FILE, DEFINE THE PATH, LOAD THE FILE WITH DATA, AND BUILD THE ALTERNATE INDEX. THE REGIONAL COORDINATOR MUST RUN THE FOLLOWING: FAC310A TO DEFINE THE CLUSTER FAC315 TO LOAD A CLASS ID IN THE VSAM FILE FAC310B TO DEFINE THE ALTERNATE INDEX, DEFINE THE PATH, AND BUILD THE INDEX. //FAC310A JOB (XXXX,YYYY),'CREATE VSAM',MSGLEVEL=(2,0),CLASS=F, // PRTY=3,MSGCLASS=A //IDCAMS EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //SYSIN DD * DEFINE CLUSTER (NAME(CCADV.SIS.CLUSDDDD.FACCNTL.TTTTTT) - NOREUSE - SPEED - INDEXED KEYS(9,0) - RECORDSIZE(58,490) - VOLUMES(VCC204) - CYL(2,0) - SHAREOPTIONS(1,3) - FREESPACE(0,5)) - DATA (CONTROLINTERVALSIZE(4096) - NAME(CCADV.SIS.KSDSDDDD.FACCNTL.TTTTTT)) - INDEX (NAME(CCADV.SIS.KSIXDDDD.FACCNTL.TTTTTT)) (IN THE ABOVE JCL VSAM FILE NAME, THE FIRST TWO CHARACTERS - CC - SHOULD BE CHANGED TO REFLECT INDIVIDUAL COLLEGE ABREVIATIONS -DDDD- SHOULD REFLECT RUNTYPE AND -TTTTTT- SHOULD REFLECT THE TERM DESIRED) //* //* THIS STEP LOADS A CLASS ID IN THE VSAM FILE //* //FAC315 JOB (XXXX,YYYY),'LOAD VSAM',MSGLEVEL=(2,0),CLASS=F, // PRTY=3,MSGCLASS=A //STEP1 EXEC FAC315,AGENCY=, // COLLEGE=, // TERM=, // RUNTYPE=, // DBTYPE= //FAC315.PARMCARD DD * INPUT PARAMETERS /* ** NOTE ** SEE FAC315 DOCUMENTATION FOR EXPLANATION OF ** INPUT PARAMETERS. THEY ARE TERM, YEAR AND CLASS-ID. ** EX. SPRING90902CIS 10001 //FAC310 JOB (XXXX,YYYY),'CREATE PATH',MSGLEVEL=(2,0),CLASS=F, // PRTY=3,MSGCLASS=A //IDCAMS EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //SYSIN DD * DEFINE AIX (NAME(CCADV.SIS.CLUSDDDD.FACCNTL.ALT.TTTTTT) - RELATE(CCADV.SIS.CLUSTDDDD.FACCNTL.TTTTTT) - NOREUSE - SPEED - KEYS(10,17) - UPGRADE - NONUNIQUEKEY - RECORDSIZE(58,490) - VOLUMES(VCC204) - CYL(2,0) - FREESPACE(20,20)) - DATA (CONTROLINTERVALSIZE(4096) - NAME(CCADV.SIS.KSDSDDDD.FACCNTL.ALT.TTTTTT) - SHAREOPTIONS(1,3)) INDEX (NAME(CCADV.SIS.KSIXDDDD.FACCNTL.ALT.TTTTTT) SHAREOPTIONS(1,3)) DEF PATH (NAME(CCADV.SIS.CLUSDDDD.FACCNTL.PATH.TTTTTT) - PATHENTRY(CCADV.SIS.CLUSDDDD.FACCNTL.ALT.TTTTTT) - UPDATE ) BLDINDEX IDS (CCADV.SIS.CLUSDDDD.FACCNTL.TTTTTT) - ODS (CCADV.SIS.CLUSDDDD.FACCNTL.ALT.TTTTTT) AT THE BEGINNING OF PROCESSING THE FACULTY EVALUATIONS FOR EACH TERM FAC320 IS RUN. THIS PROC DELETES LAST YEARS DATA FROM THE VSAM FILE FOR THAT TERM. THIS PROC MUST BE RUN EACH TERM INCLUDING THE TERM THE VSAM FILES ARE INITIALLY CREATED. THE FACULTY EVALUATION VSAM FILE IS LOADED WITH CLASS INFORMATION FOR A TERM USING FAC300. THIS PROGRAM CAN BE RUN FOR A SPECIFIC SESSION, SPECIFIC CLASS-IDS, OR FOR ALL SESSIONS. FAC300 LOADS THE FILE AND RANDOMLY GENERATES A 5 DIGIT UNIQUE IDENTIFICATION CODE FOR EACH CLASS, WHICH WILL BE USED AS THE RECORD KEY IN THE VSAM FILE AND AS THE CLASS IDENTIFICATION IN SUBSEQUENT PROCESSING. FROM THIS NEWLY LOADED VSAM FILE REPORTS, MEMOS AND LABELS ARE GENERATED. THESE REPORTS, MEMOS, AND LABELS ARE PRODUCED BY FAC710. THE CONTROL-REPORTS ARE PRODUCED TO FACILITATE COMPUTER OPERATIONS AND DIVISIONAL PERSONNEL IN THE PROCESSING AND DISTRIBUTION OF THE EVALUATION FORMS. THESE REPORTS ARE PRODUCED IN DUPLICATE, ONE FOR COMPUTER OPERATIONS AND ONE DISTRIBUTED TO THE HEAD OF EACH DIVISION. THESE REPORTS ARE SORTED BY DIVISION, AND CONTAIN THE CLASS IDENTIFICATION NUMBER, INSTRUCTOR NAME, CLASS DEPARTMENT, COURSE AND SECTION NUMBERS, NUMBER OF STUDENTS REGISTERED FOR A CLASS AND A BLANK SPACE ENTITLED DATED RETURNED. THIS DATE RETURNED SPACE WILL BE USED BY DIVISION HEADS AND OPERATIONS TO DOCUMENT DATES. INSTRUCTIONAL MEMOS ARE GENERATED FOR EACH INSTRUCTOR. THE MEMO LISTS EACH CLASS TAUGHT THIS TERM BY THE INSTRUCTOR AND ALSO SUPPLIES THE IDENTIFICATION NUMBER AS WELL AS THE CLASSES DEPARTMENT, COURSE AND SECTION DATA. THE INSTRUCTOR'S NAME AND DIVISION AS WELL AS STEP BY STEP INSTRUCTIONS FOR COMPLETING THE EVALUATION FORMS ARE INCLUDED ON THE MEMOS. A LABEL IS GENERATED FOR EACH CLASS ON THE VSAM FILE. THESE LABELS ARE GENERATED FOR IDENTIFICATION AND ARE AFFIXED TO ENVELOPES WHICH WILL CONTAIN THE EVALUATION SHEETS FOR EACH CLASS. AT SOME TIME AFTER THE PRECEDING STEPS INSTRUCTORS ARE GIVEN AN EVALUATION PACKET (INSTRUCTIONAL MEMO AND ENVELOPE CONTAINING EVALUATION FORMS FOR THEIR STUDENTS) AND ARE ASKED TO DISTRIBUTE TO EACH OF THEIR STUDENTS THE EVALUATION FORMS AND INSTRUCT THE STUDENTS VIA THE MEMOS IN THE COMPLETION OF THESE FORMS. THE EVALUATION FORMS HAVE A DESIGNATED PLACE WHERE THE CLASS IDENTIFICATION NUMBER AND THE ANSWERS TO TWENTY QUESTIONS REGARDING THEIR INSTRUCTOR MUST BE ENTERED. THESE EVALUATION FORMS FOR A CLASS ARE GATHERED AND RETURNED TO THE DIVISION HEAD, THEN SUBSEQUENTLY TO COMPUTER OPERATIONS FOR PROCESSING. PROCESSING WILL OCCUR WHEN A SUFFICIENT NUMBER OF CLASSES HAVE BEEN RETURNED TO COMPUTER OPERATIONS. (EVALUATION FORMS WILL BE PROCESSED ON SEVERAL OCCASIONS DURING EACH TERM; HOWEVER, EACH CLASSES' EVALUATIONS SHOULD BE PROCESS- ED ONLY ONCE. WHEN AN UPDATE OCCURS IT IS NOT CUMMLATIVE. THEREFORE, ALL EVALUATIONS FOR A CLASS SHOULD BE COLLECTED AND SUBMITTED FOR PROCESSING TOGETHER). FIELDS CONTAINING THE CALCULATED RESULTS OF EVALUATION FORMS ARE CLEARED EACH TIME A CLASS IS PROCESSED. EXAMPLE: EVALUATION FORMS FROM 10 STUDENTS IN A CLASS WERE SUBMITTED TO COMPUTER OPERATIONS AND WERE PROCESSED. AS A RESULT OF THIS PROCESSING THE RECORD FOR THIS CLASS IN THE VSAM FILE NOW CONTAINS THE RESULTS OF THESE 10 EVALUATION FORMS. HOWEVER, IF SOMETIME LATER 15 DIFFERENT EVALUATIONS WERE SUBMITTED AND PROCESSED FOR THE SAME CLASS, THE VSAM RECORD NOW CONTAINS ONLY THE RESULTS OF THE LAST 15 EVALUATIONS. EVALUATIONS ARE FIRST PROCESSED THRU A SCANNER/PC COMPUTER. THE PC PRODUCES A DATA FILE ON THE IBM-AT HARD DISK. THIS DATA FILE CONTAINS A RECORD FOR EACH EVALUATION SHEET PROCESSED THRU THE SCANNER/PC COMPUTER. THIS DATA IS UPLOADED VIA IRMALINK TO A PARTITIONED DATA SET. THIS PARTITIONED DATA SET SHOULD BE DEFINED USING IMRALINK AND NAMED: CCUSERS.A.DATA(FACDAT). ONCE THE DATA FILE IS UPLOADED TO THE PARTITIONED DATA SET, CCUSERS.A.DATA(FACDAT) WHERE CC IS THE COLLEGE ABREVIATION. IDENTIFICATION CODES ARE CHECKED AGAINST THE VSAM FILE FOR VALIDITY. IF AN IDENTIFICATION CODE IS DEEMED INCORRECT THE PREVIOUSLY CORRECT IDENTIFICATION CODE IS ASSUMED CORRECT. HOWEVER, A WARNING MESSAGE IS ALWAYS GENERATED BY FAC956 WHEN THIS CONDITION OCCURS AND SHOULD BE CHECKED BY COMPUTER OPERATIONS. A FINAL EDITED DATA FILE (FACREC) IS GENERATED BY FAC956 AND STORED IN THE SAME PDS. THE EDITED DATA FILE IS THEN PROCESSED BY FAC330 TO UPDATE THE VSAM FILE. THIS EDITED DATA FILE, CONTAINING ALL STUDENTS' ANSWERS, IS SUMMARIZED FOR EACH CLASS BY FAC330 AND THE TOTALS FOR EACH CLASS IS UPDATED TO THAT CLASSES' RECORD IN THE VSAM FILE. FAC330 WILL CHECK THE UPDATE-VSAM FIELD IN THE FACULTY EVALUATION VSAM FILE. (BLANK REPRESENTS NO PREVIOUS UPDATES, 'X' REPRESENTS PREVIOUS UPDATES) UPDATING WILL ALWAYS OCCUR EVEN IF THE CLASS HAS BEEN UPDATED PREVIOUSLY. FAC330 ALWAYS UPDATES THE UPDATE-VSAM FIELD WITH A 'U' IN THE RECORDS OF ALL CLASSES PROCESSED. A WARNING MESSAGE IS PRINTED AND SHOULD BE CHECKED BY COMPUTER OPERATIONS. SINCE UPDATES ARE NOT CUMMULATIVE MOST ERRORS COULD BE CORRECTED BY REPROCESSING. A SITUATION COULD ARISE WHERE MORE THAN ONE UPDATE OF A CLASS WOULD BE DESIRABLE. EXAMPLE: STUDENT EVALUATION SHEETS WERE PROCESSED AND UPDATED FOR A CLASS. LATER MORE EVALUATION SHEETS WERE FOUND FOR THE SAME CLASS. IF ALL OF THESE EVALUATION SHEETS (THE ONES PREVIOUSLY PROCESSED AND THE ONES JUST FOUND) WERE AVAILABLE, REPROCESSING WOULD BE ADVISABLE. FAC957 SHOULD BE EXECUTED, WITH A REPORT-OPTION OF 'U', AFTER EACH UPDATE BY FAC330 AND CHECKED FOR ACCURACY. FAC957 IN REPORT UPDATE MODE WILL PRINT ONLY THE CLASSES THAT WERE JUST UPDATED AND NOT ANY PREVIOUSLY UPDATED CLASSES. FAC957 IN REPORT UPDATE MODE WILL ALSO UPDATE THE UPDATE- VSAM FIELD IN THE FACULTY EVALUATION VSAM FILE FROM A 'U' TO AN 'X'. THIS ASSURES THAT ANY SUBSEQUENT UPDATES TO THIS CLASS BY FAC330 WILL PRODUCE A WARNING MESSAGE. FAC957 CAN BE EXECUTED ON DEMAND TO PRINT A CLASS SUMMARY OR INSTRUCTOR SUMMARY OF ALL CLASSES. THE CLASS RECORD IN THE VSAM FILE MUST HAVE BEEN UPDATED BY FAC330 PRIOR TO EXECUTION OF FAC957. NORMALLY AT THE END OF EACH TERM WHEN ALL EVALUATION FORMS HAVE BEEN PROCESSED, FAC957 IS EXECUTED TO PRINT A CLASS SUMMARY AND AN INSTRUCTOR SUMMARY OF ALL CLASSES. FOR EASE OF OPERATION AND ELIMINATION OF USER ERRORS ONE JOB STREAM FOR FAC956, FAC330 AND FAC957 IS RECOMMENDED. JCL FOR THIS IS IN FAC956 DOCUMENTATION. * 2.1 SYSTEM FLOW FACULTY EVALUATION SUBSYSTEM SYSTEMS FLOWCHART A. DEFINE, BUILD AND REPORT _________ ]FAC310_] ]-------] DEFINE FILE, ONE TIME PROCESS ]DEFINE ] ] VSAM ] ]_______] ] ] ____]___ ] NEW ] ] VSAM ] ] FILE ] -------- _________ ]FAC320_] DELETE, BUILD, AND REPORT EVERY TERM ]-------] ]DELETE ] ] VSAM ] ]_______] ] ____]___ ] EMPTY] ________ ] VSAM ] ] CLASS] ]______] ]DBD ] ] ]______] ] ] ] ___]_____ ] ]FAC300 ] _________ ] ]-------] ] INSTR ] ]___________] LOAD ]-----] DBD ] ] ] VSAM ] ]_______] ________ ]_______] ]BUILT ] ]VSAM ] ]______] ] _____]_____ ___________ ] FAC710 ] ]REPORTS ] ]---------]_________ ] MEMOS ] ] REPORT ] ]LABELS ] ] PROGRAM ] ] ] ]_________] --------- * B. PROCESS, UPDATE, AND REPORT ___________ ] STUDENT ] ] EVAL ] ] SHEETS ] ] ] --------- ] ] ___________ _____________ ] PCFAC01 ] ] FAC700 ] ]---------] ]-----------] ] SCANNER/]---------]TRANSLATES ] ] PC PGM ] ]SCANNER ] ]_________] ]DATA_______] ] ___]___ ] PC ] ]DATA ] ]FILE ] ___________ ]______] ]_________] ]________] IRMA ] ] ] UPLOAD ] ] ]_________] ______________ ] FAC956 ] ]------------] ] EDIT ] ]____________] ] __________ ____________ ] EDITED ] ] FAC330 ] ] DATA ] ]-----------] ] FILE ]_____] UPDATE ] ] FACREC ] ]VSAM FILE ] ]________] ]___________] ____]____ _____________ ]UPDATED ] ] FAC957 ] ] VSAM ] ]-----------] ] FILE ]___________ ]REPORT PGM ] ] ] ]___________] ]________] ] * ] ] _____________ ] REPORT ] ] SUMMARY BY] ] CLASS ] ] INSTRUCTOR] ^^^^^^^^^^^ ] ] _____]_______ ] FAC950 ] ]-----------] ]LABEL PGM ] ]___________] ] ] _____________ ] EVALUATION] ] LABELS ] ] ] ] ] ^^^^^^^^^^^ * 3.0 VSAM FILE DESIGN: ---------------- FACULTY EVALUATION VSAM FILE FACEVAL CONTROL RECORD ID-CODE PIC S9(9) (KEY) TERM-VSAM PIC X SESSION-CODE-VSAM PIC X FILLER PIC X(4) YR-VSAM PIC S99 DEPT-NAME PIC X(4) COURSE-NAME PIC X(3) SECN PIC XX CAMPUS PIC X DIVIS PIC X INST-L-NAME PIC X(16) INST-F-NAME PIC X(10) INST-INITIAL PIC XX SOC-SEC-NUM PIC S9(9) ENROLL-VSAM PIC S9(4) VSAM-UPDATE PIC X ' ': INITIAL VALUE CREATED BY FAC300 'M': MEMO HAS BEEN CREATED FOR THAT CLASS 'U': CLASS HAS BEEN PROCESSED BY FAC330 'X': PREVIOUS UPDATES HAVE BEEN DONE BY FAC957 COUNTER1 PIC X(210) COUNTER2 PIC X(210) DATA BASES ACCESSED BY FACULTY EVALUATION SUBSYSTEM (DATA BASES ARE READ ONLY) 1. CLASS DATA BASE CLASS MASTER SEGMENT CLASS DETAIL SEGMENT 2. INSTRUCTOR DATA BASE INSTRUCTOR SEGMENT 3. CONTROL DATA BASE CAMPUS SEGMENT DIVISION SEGMENT * 4.0 PROGRAM SUMMARIES: ------------------ 1. FAC310 - DEFINE FACULTY EVALUATION VSAM FILE ------ THIS JCL IS USED TO DEFINE THE FACULTY EVALUATION VSAM FILE. THIS SHOULD BE RUN BY THE REGIONAL COORDINATOR AND SHOULD ONLY BE RUN ONCE. 2. FAC300 - LOADS FACULTY EVALUATION VSAM FILE ------ THIS PROGRAM LOADS THE FACULTY EVALUATION VSAM FILE FROM THE CLASS DATA BASE. IT CAN BE RUN MULTIPLE TIMES PER TERM. ALSO, IT CAN BE RUN FOR A SPECIFIC SESSION, FOR SPECIFIC CLASS-IDS, OR FOR ALL SESSIONS. 3. FAC320 - DELETES LAST YEARS DATA FROM THE VSAM FILE FOR ------ THAT TERM. THIS IS RUN AT THE BEGINNING OF PROCESSING EACH TERM. 4. FAC710 - PRINTS CONTROL REPORT, MEMOS, AND LABELS. ------ THIS PROGRAM USES THE FACULTY EVALUATION VSAM FILE TO PRINT A CONTROL REPORT, MEMOS, AND LABELS. THIS PROGRAM MAY BE RUN ANYTIME AFTER FAC300. 5. PCFAC01- PROMPTS USER FOR STEPS TO UPLOAD DATA. ------ CALLS IRMALINK UTILITIES TO UPLOAD DATA. 6. FAC956 - EDITS CONVERTED DATA FILE, FACDAT INTO FACREC. ------ THIS PROGRAM EDITS THE IDENTIFICATION CODE FROM EACH EVALUATION SHEET AND GENERATES A DATA FILE AND ISSUES WARNING MESSAGES WHICH SHOULD BE CHECKED BY OPERATORS. 7. FAC330 - UPDATE FACULTY EVALUATION VSAM FILE ------ THIS PROGRAM USES THE DATA FILE CONSISTING OF STUDENT'S EVALUATION FORM ANSWERS TO UPDATE THE FACULTY EVALUATION VSAM FILE. 8. FAC700 - TRANSLATES SCANNER DATA ------ 9. FAC950 - FACULITY EVALUATION LABELS ------ 10. FAC957 - PRINTS SUMMARY BY CLASS OR BY INSTRUCTOR ------ THIS PROGRAM CALCULATES THE PERCENTAGES AND PRINTS A SUMMARY REPORT EITHER FOR EACH CLASS OR FOR ALL OF AN INSTRUCTOR'S CLASSES FOR THE TERM. ALSO PRINTS A DIVISION SUMMARY. FAC957 ALSO FUNCTIONS AS A PRINT CONTROL SUMMARY REPORT FOR UPDATES BY FAC330. SEE FAC957 DOCUMENTATION FOR DETAILS. 8.0 CHANGE HISTORY -------------- 8.1 VERSION NO: V4.09 CHANGE DATE: 12/13/89 PROGRAMMMER NAME: S. EDMONDS PROGRAM CHANGE REQUEST NO: 00004497 DESCRIPTION OF CHANGE: REVISED DOCUMENTATION BY ADDING THE PROGRAMS FAC700 AND FAC950 TO THE 4.0 PROGRAM SUMMARIES SECTION. THESE PROGRAMS WERE ON INDEX BUT HAD NOT BEEN INCLUDED IN THIS DOCUMENT. 8.2 VERSION NO: V4.16 CHANGE DATE: 09/14/90 PROGRAMMMER NAME: DANA BRYANT PROGRAM CHANGE REQUEST NO: 5759 DESCRIPTION OF CHANGE: ADDED NEW PROGRAM FAC320 TO DOCUMENTATION. PROGRAM CHANGE REQUEST NO: 5688 DESCRIPTION OF CHANGE: UPDATED DESCRIPTION OF FAC300. 8.3 VERSION NO: V4.31 CHANGE DATE: 02/15/92 PROGRAMMMER NAME: DANA BRYANT PROGRAM CHANGE REQUEST NO: 9290 DESCRIPTION OF CHANGE: UPDATED DESCRIPTION OF FAC956.