0.003/13/99 DIANE LIVELY 1.0 PROGRAM NARRATIVE: ----------------- PER915 IS A BATCH PROGRAM WHICH PRODUCES AN ADJUNCT FACULTY PAYROLL REPORT FOR A SPECIFIC TERM IN THE ACADEMIC SEMESTER SYSTEM. THIS PROGRAM CANNOT BE USED FOR QUARTER-SYSTEM TERMS. THE PROGRAM SELECTS ACTIVE INSTRUCTORS WHO ARE TEACHING A CLASS IN THE SELECTED TERM WITH A TEACHING-LOAD OF '3'. THE REPORT LISTS THE INSTRUCTOR'S SOCIAL SECURITY NUMBER, NAME, COURSE ID, DIV-CODE OF THE CLASS, DEPARTMENT BUDGET CODE, TOTAL WORKLOAD CREDITS, RATE PER WORKLOAD, CREDIT, TOTAL CONTRACT AMOUNT, AND FIELD AREAS FOR MARKING APPLICATION TRANSACTIONS, TAX CARDS, VCCS38 OR VWCC6, AND I-9. ADDITIONAL INFORMATION SUCH AS THE PAYMENT CREDITS FOR EACH CLASS, RATE AND A TOTAL FOR INSTRUCTOR CAN OPTIONALLY BE PRINTED. AN OPTION TO INCLUDE ALL ADJUNCT FACULTY, REGARDLESS OF WHETHER THEY HAVE A RECORD ON PERSONNEL WILL ASSIST IN IDENTIFYING THE COURSES WHICH NEED TO BE ASSIGNED TO AN INSTRUCTOR. THERE ARE THREE SORT OPTIONS. OPTION 1 SORTS BY THE ADVISOR CAMPUS AND NAME. OPTION 2 SORTS BY THE ADVISOR CAMPUS AND DIVISION CODE (FROM THE INSTRUCTOR SEGMENT) AND NAME. OPTION 3 SORTS BY THE DIVISION OF THE CLASS, MEANING THE INSTRUC- TOR MAY APPEAR ON THE REPORT MORE THAN ONCE WITH CLASSES TAUGHT ONLY IN THAT DIVISION. THE PROGRAM CALLS A SUBPROGRAM TO COMPUTE THE WORKLOAD HOURS AND CONTRACT AMOUNT. PLEASE SEE THE DOCUMENTATION FOR PER901S FOR INFORMATION ON THE CALCULATIONS AND FOR MORE EXPLANATION ON THE MULTI-MEET AND PRORATE OPTIONS. TOTAL WORKLOAD HOURS AND CONTRACT AMOUNT ARE PRINTED FOR EACH DIVISION, AND A FINAL TOTAL IS GIVEN FOR EACH CAMPUS AND THE COLLEGE. 2.0 SAMPLE JCL ---------- 2.1 RUN JCL ______ //CCPER915 JOB (XXXX,YYYY),PER915, // MSGCLASS=A,MSGLEVEL=(1,1),CLASS=Q /*ROUTE PRINT PPPPPPPP //PER915 EXEC PER915, // AGENCY=AAA, // COLLEGE=CC //PER915.PARMCARD DD * *** INPUT PARAMETERS *** /* // WHERE (XXXX,YYYY) IS YOUR ACCOUNTING INFORMATION PPPPPPPP IS YOUR OUTPUT DESTINATION SYMBOLIC DESCRIPTION -------------------- REQUIRED AGENCY DENOTES THE THREE CHARACTER AGENCY IDENTIFIER (EX. AGENCY=283) COLLEGE DENOTES THE TWO CHARACTER COLLEGE ABBREVIATION (EX. COLLEGE=SR) OPTIONAL FORM FORM NUMBER TO WHICH THE REPORT IS TO BE SPOOLED DEFAULT: A000 (E.G., FORM=0001) QUEUE QUEUE UNDER WHICH THE REPORT IS TO BE SPOOLED DEFAULT: * (E.G., QUEUE=A) RUNTYPE INDICATES WHETHER TO USE THE TEST OR PRODUCTION DATA BASE FILES. DEFAULT: PROD (E.G., RUNTYPE=TEST) SRTSIZE AMOUNT OF DASD STORAGE IN CYLINDERS ALLOCATED TO EACH SORT WORK FILE. DEFAULT: 2 (E.G., SRTSIZE=3) 2.2 INPUT PARAMETERS ---------------- CC CONTENTS -- -------- 01 - 06 TERM (E.G., FALL ,SPRING,SUMMER) 07 - 08 YEAR OF THE TERM (E.G., 89) 09 - 09 MULTIPLE MEETING OPTION: '1' - USE ON ALL CLASSES '2' - DO NOT CONSIDER '3' - ONE MULTIPLE MEETING PER INSTRUCTOR 10 - 10 PRORATE CLASSES OPTION: '1' - PRORATE ON 'X' SECTIONS ONLY '2' - PRORATE ON 'X' SECTIONS AND COURSE NUMBERS OF 90, 97, 98 AND 99 '3' - DO NOT PRORATE CLASSES 11 - 11 EXCLUDE 'STAFF' SOCIAL SECURITY NUMBER 'Y' - EXCLUDE SOCIAL SECURITY NUMBER FOR COLLEGE 'STAFF' CLASS ASSIGNMENTS 'N' - INCLUDE SOCIAL SECURITY NUMBER FOR 'STAFF' 12 - 20 SOCIAL SECURITY NUMBER IF EXCLUDE STAFF OPTION IS 'Y'; OTHERWISE LEAVE BLANK 21 HEADING OPTION '1' - "VCCS 38" '2' - "VWCC 6" 22 SORT OPTION '1' - NAME WITHIN ADV CAMPUS (NORMAL SORT) '2' - NAME WITHIN ADV CAMP AND DIV (SPECIAL SORT) '3' - NAME WITHIN DIVISION OF CLASS (CLS DIV SORT) 23 ADDITIONAL DATA OPTION 'Y' - PRINT PAYMENT CREDITS, RATE FOR CLASS AND INSTRUCTOR TOTAL LINE 'N' - DO NOT PRINT ADDITIONAL DATA 24 INCLUDE ALL INSTRUCTORS 'Y' - INCLUDE INSTRUCTORS WHETHER OR NOT THEY ARE ON PERSONNEL 'N' - EXCLUDE INSTRUCTORS NOT ON PERSONNEL 3.0 JOB SETUP INSTRUCTIONS ---------------------- SPECIAL FORMS QUEUE: STANDARD FOR REPORT(S) FORMS BUFFER: STANDARD FOR REPORT(S) ALIGNMENT INSTRUCIONS: STANDARD PRINTED OUTPUT: ADJUNCT FACULTY PAYROLL REPORT FORMS TYPE: 11 X 14 7/8 SPECIAL INSTRUCTIONS: A HEADER CARD MUST BE PREPARED PRIOR TO RUNNING THIS JOB 4.0 FILES: ----- 4.1 DATA BASES USED: CONTROL DATA BASE CTLCAMPM SEGMENT (READ ONLY) CTLQUART SEGMENT (READ ONLY) PERSONNEL DATA BASE PERSONLM SEGMENT (READ ONLY) PERCONT SEGMENT (READ ONLY) INSTRUCTOR DATA BASE INSTRUCR SEGMENT (READ ONLY) INSTCLAS SEGMENT (READ ONLY) CLASS DATA BASE CLSMASTR SEGMENT (READ ONLY) CLSDETAL SEGMENT (READ ONLY) COURSE DATA BASE CRSSEGM SEGMENT (READ ONLY) CRSDEPT SEGMENT (READ ONLY) 4.2 ADDITIONAL FILES USED: NONE 4.3 INPUT/OUTPUT RECORD LAYOUTS: N/A 5.0 SPECIAL OUTPUT MESSAGES: ----------------------- 1. DL1 TERMINATION MESSAGES AS APPROPRIATE 2. 'PARM CARD IS BLANK! RUN STOPPED.' MEANING: JOB SETUP DID NOT INCLUDE A PARM CARD ACTION: CORRECT JOB AND RE-RUN. 3. 'INVALID MULTIPLE MEETING CODE' MEANING: MULTIPLE MEETING OPTION WAS NOT '1', '2' OR '3' ACTION: CORRECT JOB AND RE-RUN. 4. 'INVALID PRORATE CODE' MEANING: PRORATE OPTION ON PARM CARD WAS NOT '1', '2', OR '3' ACTION: CORRECT AND RE-RUN. 5. 'INVALID TERM' MEANING: TERM ENTERED ON PARMCARD WAS NOT 'FALL ', 'WINTER' 'SPRING' OR 'SUMMER' ACTION: CORRECT JOB AND RE-RUN. 6. 'INVALID YEAR' MEANING: YEAR OF TERM ON PARMCARD WAS NOT NUMERIC ACTION: CORRECT JOB AND RE-RUN. 7. 'CTLQUART SEGMENT NOT FOUND FOR THE SELECTED RUN TERM' MEANING: THE SELECTED TERM DOES NOT EXIST ON THE DATABASE. ACTION: IF DESIRED, CHANGE THE PARMCARD AND RE-RUN THE JOB. 8. 'THE RUN TERM SPECIFIED ON THE PARMCARD IS NOT A SEMESTER-SYS- TEM TERM' MEANING: THIS PROGRAM CANNOT BE USED FOR QUARTER-SYSTEM TERMS. ACTION: IF DESIRED, CHANGE THE PARMCARD AND RE-RUN THE JOB. 9. 'INVALID OPTION TO EXCLUDE STAFF' MEANING: EXCLUDE STAFF OPTION WAS NOT 'Y' OR 'N' ACTION: CORRECT JOB AND RE-RUN. 10. 'STAFF SSN TO BE EXCLUDED MUST BE NUMERIC' MEANING: EXCLUDE STAFF OPTION WAS 'Y', THE SOCIAL SECURITY WAS NOT NUMERIC. ACTION: CORRECT JOB AND RE-RUN. 11. 'CAMPUS ' (CAMPUS ID) 'WAS NOT FOUND IN CTLCAMPM SEGMENT' MEANING: THE CAMPUS DISPLAYED IS NOT ON THE DATA BASE. ACTION: CHECK CAMPUS MASTER. 12. 'DIVSION ' (DIV CODE) 'WAS NOT FOUND IN CTLDIVM SEGMENT' MEANING: THE DIVION DISPLAYED IS NOT ON THE DATA BASE. ACTION: CHECK DIVISION MASTER. 13. 'INVALID HEADING OPTION' MEANING: THE HEADING OPTION WAS NOT '1' OR '2' ACTION: CORRECT PARM AND RESUBMIT 14. 'SORT OPTION NOT '1', '2' OR '3' MEANING: THE OPTION WAS NOT '1', '2' OR '3' ACTION: CORRECT PARM AND RESUBMIT 15. 'IR WEEKS DISAGREE ON CLASS DTLS FOR XXSSNOXXX XXXCLASSIDXXXX' MEANING: PER901S ENCOUNTERED A PROBLEM WITH INSTRUCT WEEKS ACTION: USE SCH010 TO CHECK/CORRECT THE DATA 16. 'PERSONLM NOT FOUND FOR XXSSNOXXX' MEANING: THE PERSONNEL MASTER RECORD FOR THIS INSTRUCTOR'S SOCIAL SECURITY WAS NOT FOUND. 6.0 SPECIAL FEATURES: ---------------- 6.1 SUB-PROGRAMS CALLED: PER901S 7.0 PROGRAM OPTIONS: --------------- NONE (SEE DOCUMENTATION FOR PER901S) 8.0 PROGRAM CHANGE HISTORY: ---------------------- 8.1 VERSION NO: V3.6S CHANGE DATE: 2/88 PROGRAMMER NAME: SUE DOTSON PROGRAM CHANGE REQUEST NO: N/A DESCRIPTION OF CHANGE: RELEASE VERSION 8.2 VERSION NO: V3.16 CHANGE DATE: 1/89 PROGRAMMER NAME: SUE DOTSON PROGRAM CHANGE REQUEST NO: INFO 00002000 DESCRIPTION OF CHANGE: INCREASED TABLE SIZE IN THE SORT RECORD FROM 35 TO 75. ALSO CHANGED RECORD CONTAINS. 8.3 VERSION NO: V4.1 CHANGE DATE: 3/89 PROGRAMMER NAME: WENDY MORRISON PROGRAM CHANGE REQUEST NO: I 1787 DESCRIPTION OF CHANGE: PROGRAM MODIFIED TO CORRECTLY PRINT THE TOTALS WHEN PRO-RATE OPTION "3" WAS SELECTED. ADDED A NEW "1-9" COLUMN TO THE REPORT. NEW PARAMTERS- ONE FOR PRINTING OF THE "VWCC 6" COLUMN HEADING AND ONE FOR SORT BY NAME WITHIN DIVISION. CORRECTED WHEN THE MULTI-REC FIELD IS SET. 8.4 VERSION NO: V4.1 CHANGE DATE: 04/10/89 PROGRAMMER NAME EUGENE WALLO PROGRAM CHANGE REQUEST NO: 2597 DESCRIPTION OF CHANGE: -CHANGED THE COMPUTATIONS INVOLVING INSTRUCT-WEEKS TO USE ROUNDING. -CHANGED THE INSTRUCT-WEEKS LOGIC TO BE CORRECT FOR THE PROCESSING OF TERMS IN THE ACADEMIC SEMESTER SYSTEM, AS FOLLOWS: 1) WHEN INSTRUCT-WEEKS IS A NUMERIC VALUE IN THE RANGE OF 1 THROUGH 9: DIVIDE BY 15, THEN MULTIPLY BY THE CREDITS. 2) WHEN INSTRUCT-WEEKS IS AN ALPHABETIC VALUE OF "A", "B", "C", "D", "E", OR "F": ASSIGN A CORRESPONDING NUMERIC VALUE OF 10, 11, 12, 13, 14, OR 15, RE- SPECTIVELY, DIVIDE BY 15, THEN MULTIPLY BY THE CREDITS. 3) WHEN INSTRUCT-WEEKS IS AN ALPHABETIC VALUE OF "R", "S", "U", OR "W": MULTIPLY THE CREDITS BY .17, .25, .50, OR .22, RESPECTIVELY. -CHANGED THE PROGRAM TO VALIDATE THE RUN TERM FOR THE EX- ISTENCE OF A CTLQUART SEGMENT. -CHANGED THE PROGRAM TO DISALLOW THE PROCESSING OF TERMS IN THE ACADEMIC QUARTER SYSTEM. THE PROGRAM CANNOT BE USED FOR QUARTER-SYSTEM TERMS BECAUSE OF THE INSTRUCT- WEEKS LOGIC, AND BECAUSE OF THE PART-TIME-RATE FIELD OF THE PERSONLM SEGMENT CURRENTLY BEING USED FOR SEMESTER- CREDIT PAY RATES. 8.5 VERSION NO: V4.04 CHANGE DATE: 07/18/89 PROGRAMMER NAME JEAN MAYS PROGRAM CHANGE REQUEST NO: 2822, 3178 DESCRIPTION OF CHANGE: -ADDED CAPABILITY TO RETRIEVE FLAT CONTRACT AMOUNT FROM NEW SEGMENT 'PERCONT'. -ADDED PROGRAM OPTION TO CHECK FOR VALID SESSIONS TO RECEIVE MULTI-MEETING BONUS (PREVIOUSLY CHECKED ONLY 'A' SESSIONS). 8.6 VERSION NO: V4.04 CHANGE DATE: 08/14/89 PROGRAMMER NAME LYN JOHNSON PROGRAM CHANGE REQUEST NO: NONE DESCRIPTION OF CHANGE: -AFTER THE ABOVE CHANGES WERE MADE, THE PROGRAM WOULD GET AN OC7 WHEN PROCESSING AN INSTRUCTOR THAT HAD A HOME CAMPUS OF 'B' AND HAD CLASSES ON BOTH 'A' AND 'B' BECAUSE OF NON- NUMERIC DATA IN SD-CONTRACT-AMT FIELD. -CHANGED THE SAVE-TABLE-DATA TO MATCH THE SORT-REC SO THAT THE INTERNAL SORT WOULD NOT CAUSE LOSS OF DATA. -FIELDS ADDED TO THE SAVE-TABLE-DATA AREA ARE: SAVE-DEPT-FUND-RATIO, SAVE-MULTI-REC, SAVE-CONTRACT-AMT -FIELD LENGTHS CHANGED TO THE SAVE-TABLE-DATA AREA FROM PIC 9(3) TO PIC 9(2)V99 ARE: SAVE-CREDITS, SAVE-LAB-CREDITS, SAVE-LAB-HOURS, AND SAVE-LEC-HOURS. 8.7 VERSION NO: V4.05 CHANGE DATE: 08/22/89 PROGRAMMER NAME DIANE LIVELY PROGRAM CHANGE REQUEST NO: 3427 DESCRIPTION OF CHANGE: -EXPANDED THE DOCUMENTATION SLIGHTLY. -CHANGED DIVISION SORT TO WORK FOR MULTI-CAMPUS COLLEGES BY ADDING THE ADV-CAMPUS AS THE FIRST BYTE OF THE FIELD. -ADDED CAMPUS NAME TO THE DIVISION HEADING LINE. PROGRAM CHANGE REQUEST NO: 3617 DESCRIPTION OF CHANGE: -CHANGED THE PROGRAM TO READ A SYSTEM OPTION SEGMENT -(PERS0201) INSTEAD OF A PROGRAM OPTION SEGMENT (PER91501). 8.8 VERSION NO: V4.08S CHANGE DATE: 12/05/89 PROGRAMMER NAME DIANE LIVELY PROGRAM CHANGE REQUEST NO: 4110 DESCRIPTION OF CHANGE: CHANGED THE PROGRAM TO CALL THE NEW SUB-PROGRAM, PER901S. REMOVED CALLS TO THE CRSSEGM AND TO THE PROGRAM OPTION SEGMENT PERS0201. SORT RECORD NO LONGER CONTAINS TABLE OF CLASSES FOR EACH INSTRUCTOR; THERE IS A RECORD FOR EACH CLASS AND A TOTAL RECORD. REMOVED LOGIC THAT DETERMINED WORKLOAD, CONTRACT AMOUNT, ADJUNCT RATE, MULTI-MEET, AND PRO-RATING. THE SUB-PROGRAM USES A DEFAULT RATE BUT THIS PROGRAM PREVIOUSLY DID NOT. THE FLAT RATE IS NOW PRINTED FOR EACH CLASS WITH A FLAT RATE. PROGRAM CHANGE REQUEST NO: 4311 DESCRIPTION OF CHANGE: CHANGED THE PROGRAM TO USE THE ADV-CAMPUS FOR THE INSTRUCTOR WHEN SORT OPTION 1 IS USED. PROGRAM WAS USING THE CLASS ID CAMPUS FOR THE LAST CLASS. PROGRAM CHANGE REQUEST NO: NONE DESCRIPTION OF CHANGE: CHANGED THE PROGRAM TO COMPILE AND LINK UNDER COBOL II STANDARDS. 8.9 VERSION NO: V4.20 CHANGE DATE: 02/05/91 PROGRAMMER NAME: RH.CLARK PROGRAM CHANGE REQUEST NO: 00006704 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. 8.10 VERSION NO: V4.28 CHANGE DATE: 11/16/91 PROGRAMMER NAME: SUE DOTSON PROGRAM CHANGE REQUEST NO: 00008485 DESCRIPTION OF CHANGE: - MODIFICATIONS WERE MADE TO ACCESS THE NEW FIELDS ON THE PERCONT SEGMENT. THIS INCLUDED A NEW PARMCARD OPTION TO PRINT ADDITIONAL DATA. ANOTHER SORT OPTION BY THE NAME WITHIN THE DIVISION OF THE CLASS WAS ALSO ADDED. ALSO ADDED AN OPTION TO INCLUDE ALL ADJUNCT, EVEN IF THEY ARE NOT ON PERSONNEL. - INSTRUCTOR NAME WILL NOW BE USED INSTEAD OF PERSONNELS. 8.11 VERSION NO: V5.09 CHANGE DATE: 02/15/94 PROGRAMMER NAME: DIANE LIVELY PROGRAM CHANGE REQUEST NO: 00013613 DESCRIPTION OF CHANGE: RECOMPILED PROGRAM USING THE REVISED COPYLIB MEMBER FOR 'PERSONLM'. 8.12 VERSION NO: V7.02 CHANGE DATE: 12/08/98 PROGRAMMER NAME: SUE TATE PROGRAM CHANGE REQUEST NO: Y2K DESCRIPTION OF CHANGE: RECOMPILED PROGRAM WITH THE NEW COMPILER.