0.001/15/91 MARIE GORDON 1.0 PROGRAM NARRATIVE ----------------- THIS PROGRAM PRODUCES A ROOM UTILIZATION COMPARISON REPORT. IT USES AS INPUT A TEMPORARY DISK FILE CREATED BY FIS540. EACH RECORD CONTAINS THE ROOM USE HOURS AND STATION USE HRS FOR ALL CLASSES THAT MEET IN A ROOM FOR EACH DAY OF THE WEEK (17 TIME PERIODS). STATION USE HOURS ARE ROOM USE HOURS MULTIPLIED BY THE NO OF STATIONS. THE PROGRAM ADDS THE STATION USE HOURS FOR THE 17 TIME PERIODS FOR ALL 7 DAYS. THE PROGRAM GIVES THE OPTION TO USE ACTUAL STATION USE HOURS OR CONVERTED STATION USE HOURS. CONVERTED STATION USE HOURS ARE COMPUTED BY MULTIPLYING STATION USE HOURS BY 1.2 (60/50). IF THE DETAIL RECORDS SHOW CLASS TIMES ROUNDED TO THE HOUR INSTEAD OF 50 MINUTES, YOU WOULD PROBABLY NOT WANT TO USE CONVERTED STATION USE HOURS. REQUIRED STATION USE HOURS ARE COMPUTED BY DIVIDING THE SQUARE FOOTAGE BY THE SPACE PLANNING GUIDE VALUE. THE PROGRAM USES A DISCIPLINE CODE ASSIGNED BY FIS540 FOR EACH ROOM TO DETERMINE WHICH SPACE PLANNING GUIDE TO USE. "C" (CLASSROOM) IS ASSIGNED IF THE ROOM FUNCTION IS 1 AND THE ROOM USE IS 110 OR 115. "H" (HEAVY LAB) IS ASSIGNED IF THE FUNCTION IS 1 AND THE ROOM USE IS 210 OR 215 WITH THE ROOM DISCIPLINE OF 1002, 1004, OR 5300-5399. "R" (REGULAR LAB) IS ASSIGNED IF THE FUNCTION IS 1 AND THE ROOM USE IS 210 OR 215 WITH ALL OTHER DISCIPLINES. THE ROOM JUSTIFICATION PERCENT IS THE CONVERTED OR ACTUAL STATION USE HOURS DIVIDED BY THE REQUIRED STATION USE HOURS. THE REPORT SHOWS THE STATION USE HOURS, REQUIRED STATION USE HOURS, AND JUSTIFICATION PERCENT BY ROOM USE CATEGORY. IN ADDITION, THE DATA IS ACCUMULATED FOR FOUR DIFFERENT CATEGORIES: DAY AND EXTENDED DAY WITH "Z" BUILDINGS EXCLUDED AND DAY AND EXTENDED DAY WITH "Z" BUILDINGS INCLUDED. "Z" BUILDINGS ARE NOT OWNED OR RENTED BY THE COLLEGE. "DAY" REPRESENTS THE HOURS OF 7 A.M. TO 5:59 P.M. "EXTENDED DAY" REPRESENTS THE HOURS OF 7 A.M. TO 6:59 A.M. (DAY AND EVENING). TOTALS ARE ACCUMULATED AND A PAGE IS PRINTED EACH TIME THERE IS A CHANGE IN CAMPUS, BUILDING, OR DIVISION. ROOM USE CATEGORIES ARE AS FOLLOWS: ROOM USE CODE DESCRIPTION 110 CLASSROOM 115 CLASSROOM SERVICE AREA 210 HEAVY LAB 215 HEAVY LAB SERVICE AREA 216 REGULAR LAB 217 REGULAR LAB SERVICE AREA 220 SPECIAL LAB 225 SPECIAL LAB SERVICE AREA 230 STUDY LAB 235 STUDY LAB SERVICE AREA 310 STAFF OFFICE 410 LIBRARY 510 ARMORY 520 PHYSICAL EDUCATION 610 ASSEMBLY ROOM 615 SERVICE AREA 000 OTHER 999 UNKNOWN THE CONTROL DATA BASE IS READ TO OBTAIN THE COLLEGE NAME, CAMPUS NAMES, AND DIVISION NAMES FOR REPORT HEADINGS, AND TO VALIDATE THE TERM SPECIFIED ON THE PARMCARD. THE BUILDING DATA BASE IS READ TO OBTAIN BUILDING NAMES. FIS540 MUST BE RUN PRIOR TO RUNNING THIS PROGRAM IN ORDER TO CREATE THE DISK FILE. PREPARE A PARMCARD FOR FIS540 WHICH WILL SATISFY THE REQUIREMENTS FOR FIS542. IF Z BUILDINGS ARE EXCLUDED BY FIS540, THEY CANNOT BE REFLECTED IN FIS542. FIS540 HAS AN OPTION TO USE ONLY ONE PARTICULAR CAMPUS OR ALL CAMPUSES. PLEASE USE SORT OPTION "D" FOR FIS540. TO HAVE AN ACCURATE HEADING, PLEASE SPECIFY THE SAME TERM AND YEAR IN BOTH PARMCARDS. 2.0 SAMPLE JCL: ---------- 2.1 RUN JCL ------- //FIS542 JOB (WWWW,XXXX,9),FIS542, // MSGCLASS=A,CLASS=F,PRTY=3 /*ROUTE PRINT YYYYYYYY //FIS540 EXEC FIS540, // AGENCY=DDD, // COLLEGE=DD, // CENSUS=, // FORM=A000, // RUNTYPE=PROD, // SRTZIZE=3 //PARMCARD DD * INPUT CARD /* //PRTFILE DD DUMMY //FIS542 EXEC FIS542, // AGENCY=DDD, // COLLEGE=DD, // CENSUS=, // FORM=A000, // RUNTYPE=PROD, // SRTZIZE=3 //PARMCARD DD * INPUT CARD /* // SYMBOLIC DESCRIPTION ******************** REQUIRED - AGENCY COLLEGE AGENCY CODE NUMBER (E.G. AGENCY=291) COLLEGE TWO CHARACTER COLLEGE NAME ABBREVIATION (E.G. COLLEGE=BR) 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=0001) QUEUE QUEUE CLASS THE OUTPUT IS TO BE SPOOLED UNDER DEFAULT: * (E.G. QUEUE='A') RUNTYPE INDICATES WHETHER OR NOT TO USE TEST OR PRODUCTION FILES DEFAULT: PROD (E.G. RUNTYPE=TEST) SRTSIZE AMOUNT OF DASD STORAGE IN CYLINDERS ALLOCATED TO EACH SORT WORK FILE DEFAULT: 3 (E.G. SRTSIZE=4) 2.2 INPUT PARAMETERS ---------------- WWWW - PROGRAMMER NUMBER XXXX - ROOM NUMBER YYYYYYYY - PRINTER INPUT CARD CC DESCRIPTION -- ----------- 1-6 TERM TO APPEAR IN THE HEADING (SAME AS IN PARMCARD FOR FIS540) 7-8 YEAR TO APPEAR IN THE HEADING (SAME AS IN PARMCARD FOR FIS540) 9 USE CONVERTED STATION USE HRS Y - YES, USE CONVERTED N - NO, USE ACTUAL EX: WINTER85Y 3.0 JOB SETUP INSTRUCTIONS: ---------------------- SPECIAL FORMS QUEUE: NONE FORMS BUFFER: NONE ALIGNMENT INSTRUCTIONS: STANDARD PRINTED OUTPUT: ROOM UTILIZATION COMPARISON REPORT FORMS TYPE: 11 X 14 7/8 SPECIAL INSTRUCTIONS: TWO PARMCARDS MUST BE PREPARED PRIOR TO RUNNING THIS JOB. 4.0 FILES: ----- 4.1 DATA BASE SEGMENTS USED CONTROL DATA BASE 1. CAMPUS (READ ONLY) 2. DIVISION (READ ONLY) 3. PROGRAM OPTION (READ ONLY) 4. QUARTER (READ ONLY) BUILDING DATA BASE 1. BUILDING (READ ONLY) 4.2 ADDITIONAL FILES USED: 1. WORKFILE 4.3 INPUT/OUTPUT RECORD LAYOUTS: LOCATION LENGTH TYPE DESCRIPTION 1 1 ALPH CAMPUS 2-4 3 ALPH BUILDING 5-8 4 ALPH ROOM 9-11 3 ALPH ROOM USE 12 1 ALPH ROOM FUNCTION 13 1 ALPH ROOM DISCIPLINE 14-19 6 NUM SQUARE FOOTAGE (9999V99) 20-22 3 NUM NUMBER OF STATIONS 23-24 2 ALPH DIVISION 25-976 952 NUM ROOM VALUE TABLE TIME OCCURS 17 TIMES DAY OCCURS 7 TIMES STATION USE HRS 999V9 ROOM USE HRS 999V9 5.0 SPECIAL FEATURES ---------------- 5.1 CALLING PROGRAMS: N/A 5.2 SUBPROGRAMS CALLED: UTL550S 5.3 MESSAGE SEGMENT CODES: N/A 6.0 PROGRAM OPTIONS: ---------------- FIS54001 - THIS OPTION RECORD IS USED TO STORE SIX SPACE PLANNING GUIDES. THERE IS AN EXTENDED AND REGULAR VALUE FOR EACH ROOM DISCIPLINE--CLASSROOM, HEAVY LAB (ART, MUSIC, ENG), AND REGULAR LAB. THESE SPG'S ARE NEEDED TO DETERMINE REQUIRED STATION USE. THEY MUST BE NUMERIC AND NOT ZERO. THEY VARY DEPENDING ON FTES. VALUES MAY BE OBTAINED FROM THE RESEARCH OFFICE. ALL PROGRAM OPTION RECORDS ARE 90 POSITIONS LONG. PLEASE USE THE SPACE AS FOLLOWS: POSITION PICTURE 1-4 EXTENDED CLASS 99.99 5-8 EXTENDED HEAVY LAB 99.99 9-12 EXTENDED REGULAR LAB 99.99 13-16 REGULAR CLASS 99.99 17-20 REGULAR HEAVY LAB 99.99 21-24 REGULAR REGULAR LAB 99.99 25-90 NOT USED FOR FTE OVER 2500: 005504310194007205210234 7.0 PROGRAM CHANGE HISTORY: ----------------------- 7.1 VERSION NO: V3.0 CHANGE DATE: 06/9/86 PROGRAMMER NAME: DIANE LIVELY PROGRAM CHANGE REQUEST NO: NONE DESCRIPTION OF CHANGE: RELEASE VERSION 7.2 VERSION NO: V3.12 CHANGE DATE: 07/06/88 PROGRAMMER NAME: EUGENE WALLO PROGRAM CHANGE REQUEST NO: SCP-SO-186 DESCRIPTION OF CHANGE: -MODIFIED TO VALIDATE THE TERM SPECIFIED IN THE PARMCARD AGAINST THE CONTROL QUARTER SEGMENT. -MODIFIED TO DISPLAY THE PROGRAM-ID, VERSION, COMPILE DATE, AND COMPILE TIME. -CHANGED ALL REFERENCES OF "QUARTER" TO "TERM" IN THE DOC- UMENTATION. 7.3 VERSION NO: V4.19 CHANGE DATE: 12/17/90 PROGRAMMER NAME: MARIE GORDON PROGRAM CHANGE REQUEST NO: 00006656 DESCRIPTION OF CHANGE: MADE CHANGES FOR COBOL II. 7.4 VERSION NO: V7.02 CHANGE DATE: 03/31/99 PROGRAMMER NAME: ANDREW HASLETT PROGRAM CHANGE REQUEST: 00018008 DESCRIPTION OF CHANGE: - NO MODIFICATIONS REQUIRED FOR Y2K - CLEANLY COMPILED FOR COBOL II