0.001/15/91 MARIE GORDON 1.0 PROGRAM NARRATIVE: ------------------ THIS BATCH PROGRAM PRODUCES THE FOLLOWING REPORT: TEXTBOOK BUY BACK LIST BY AUTHOR THIS REPORT GENERATES A LIST OF BOOKS FOR A GIVEN TERM. THE TERM WILL BE SELECTED BY THE USER. THE LIST IS TO BE USED BY THE BOOKSTORE FOR DETERMINING HOW MANY USED TEXTBOOKS WILL BE BOUGHT BACK FROM STUDENTS. IF A BOOK IS USED FOR SEVERAL COURSES, THEN ALL APPLICABLE COURSES WILL APPEAR BELOW THAT TEXTBOOK. THIS PREVENTS THE DUPLICATION OF TEXTBOOKS ON THE REPORT. WORK SPACE IS PROVIDED ON THE REPORT FOR MANUAL CALCULATION OF THE FOLLOWING: (1) QUANTITY NEEDED (2) PRICE PER BOOK (3) QUANTITY BOUGHT (4) TOTAL PRICE *** N O T E S *** (1) TWO DETAIL LINES ARE PROVIDED FOR THE LISTING OF COURSES WHICH USE A GIVEN TEXTBOOK. EACH LINE ALLOWS A MAXIMUM OF "10" CLASSES TO BE PRINTED. (2) THE PUBLISHER PRINTED ON THIS REPORT IS THE ACTUAL PUBLISHER OF THE BOOK, RATHER THAN THE PUBLISHER/VENDOR FROM WHOM BOOKS ARE ORDERED. *** E N D N O T E S *** THE FOLLOWING DATA ELEMENTS WILL BE PRINTED: CAMPUS DEPARTMENT COURSE NUMBER BOOK TITLE AUTHOR/EDITOR EDITION NUMBER NAME OF PUBLISHER DIVISION CODES (EACH BOOK HAS AT LEAST 1 CODE; MAXIMUM OF 3) 2.0 SAMPLE JCL ---------- 2.1 RUN JCL ------- //CVBKS580 JOB (PPPP,RRRR,N,NN),'BKS580',CLASS=F, // PRTY=3,MSGCLASS=A,MSGLEVEL=(1,1) /*ROUTE PRINT ZZZZZ //STEP1 EXEC BKS580,COLLEGE=II,AGENCY=AAA //PARMCARD DD * XXXXXXXXXX /* // PPPP - PROGRAMMER NUMBER RRRR - ROOM NUMBER ZZZZ -REMOTE NUMBER THE USER SHOULD SUPPLY A VALID JOB CARD FOR THIS PROCEDURE CONFORMING TO SYSTEM STANDARDS. SYMBOLIC PARAMETERS ******************* REQUIRED - THE FOLLOWING SUBSTITUTIONS MUST BE PERFORMED ON THE ABOVE JCL'S SYMBOLIC PARAMETERS: AGENCY AAA - ENTER YOUR COLLEGE'S AGENCY CODE NUMBER (E.G. AGENCY=292) COLLEGE II - ENTER YOUR COLLEGE'S TWO CHARACTER NAME ABBREVIATION (E.G. COLLEGE=CV) 2.2 INPUT PARAMETERS : ------------------ * THE USER SHOULD PREPARE A PARAMETER/HEADER CARD AND PLACE IT AFTER THE "//BKS580 PARMCARD DD" CARD USING THE FOLLOWING DIRECTIONS : CC CONTENTS -- -------- 01-06 NAME OF THE TERM YOU DESIRE THE TEXTBOOK LIST PRINTED FOR (I.E. 'FALL '). 07-08 LAST TWO DIGITS OF THE YEAR ASSOCIATED WITH THE NAME OF TERM (I.E. '87') 09 CAMPUS CODE YOU DESIRE THE TEXTBOOK BUY BACK LIST PRINTED FOR. VALID ENTRIES ARE : '@' - FOR ALL CAMPUSES 'A' - A VALID CAMPUS CODE AT YOUR COLLEGE 10 SORT OPTION STANDARD SORT - ENTER A BLANK DETAILED SORT - ENTER A 'D' STANDARD SORT - SORT ALL OF THE FOLLOWING FLDS IN ASCENDING ORDER : AUTHOR/EDITOR, BOOK TITLE, AND CAMPUS DETAILED SORT - SORT ALL OF THE FOLLOWING FLDS IN ASCENDING ORDER : DIVISION, AUTHOR/EDITOR, BOOK TITLE, AND CAMPUS 3.0 JOB SETUP INSTRUCTIONS : ------------------------ SPECIAL FORMS QUEUE : STANDARD FORMS BUFFER : STANDARD ALIGNMENT INSTRUCTIONS : MAKE SURE PRINTER IS AT TOP OF PAGE; NOT MORE THAN 6 LINES FOR TOP MARGIN PRINTED OUTPUT : TEXTBOOK BUY BACK LIST BY AUTHOR FORMS TYPE : STOCK 11 * 14 SPECIAL INSTRUCTIONS : 4.0 FILES: ----- 4.1 DATA BASES USED: CONTROL DATA BASE 1. CTLQUART (READ ONLY) 2. CTLDIVM (READ ONLY) 3. CTLCAMPM (READ ONLY) BOOK STORE DATA BASE 1. BOOKMSTR (READ ONLY) 2. BOOKREC (READ ONLY) PUBLISHER DATA BASE (PBL) 1. PUBLMSTR (READ ONLY) 4.2 ADDITIONAL FILES USED: 1. PRINT FILE PRINT FILE (BUY BACK LIST) 2. BK-BUYBACK-FILE (FILE OF DESIRED DATA BASE RECORDS) 3. TEXT-OUT-FILE (SAME AS ABOVE, BUT DOES NOT CONTAIN DUPLICATE BOOKS) 4. SORTED-FILE (SORTED FILE OF DESIRED DATA BASE RECORDS) 5. NEW-FILE (SORTED FILE USED WITH TEXT-OUT-FILE) 6. SORT-FILE (WORK FILE) 7. SORT-FILE2 (WORK FILE USED WITH TEXT-OUT-FILE) 8. PARM-CARD-FILE (CARD FILE - SUPPLIES USER INPUT PARAMETERS) 4.3 INPUT/OUTPUT RECORD LAYOUTS: N/A 5.0 SPECIAL FEATURES: ---------------- 5.1 CALLING PROGRAMS: NONE 5.2 SUBPROGRAMS CALLED: UTL550S 5.3 MESSAGE SEGMENT CODES: N/A 5.4 SPECIAL OUTPUT MESSAGES : ------------------------- 1. ERROR - * PARMCARD DD STATEMENT IS MISSING * MEANING: YOUR JOB CONTROL STATEMENTS ARE NOT CORRECT. YOU ARE MISSING THE INDICATED STATEMENT. ACTION: SUPPLY THE MISSING STATEMENT. RE-RUN JOB. 2. ERROR - * NO PARAMETER RECORD WAS FOUND FOLLOWING DD STATEMENT * MEANING: YOU LEFT OUT OR MISPLACED THE PARAMETER CARD IN THE DECK. ACTION: SUPPLY THE PARAMETER CARD IN THE CORRECT PLACE. RE-RUN JOB. 3. ERROR - * NAME OF TERM IS INVALID * MEANING: NAME OF TERM SUPPLIED ON THE PARAMETER CARD IS NOT WINTER, SPRING, SUMMER, OR FALL. ACTION: SUPPLY THE CORRECT TERM AND RE-RUN JOB. 4. ERROR - * YEAR IS NOT NUMERIC - RUN ABORTED * MEANING: YEAR SUPPLIED ON THE PARAMETER CARD IS NOT NUMERIC (00-99). ACTION: SUPPLY THE CORRECT YEAR AND RE-RUN JOB. 5. ERROR - * YEAR NOT FOUND ON CTLQUART * MEANING: YEAR SUPPLIED ON THE PARAMETER CARD DOES NOT EXIST ON THE CONTROL DATA BASE. ACTION: SUPPLY A YEAR THAT EXISTS ON THE CONTROL DATA BASE. 6. ERROR - * CAMPUS CODE NOT FOUND - INVALID * MEANING: THE CAMPUS CODE SUPPLIED ON THE PARAMETER CARD CAN NOT BE LOCATED ON THE CONTROL DATA BASE. ACTION: SUPPLY A VALID CAMPUS CODE FOR YOUR COLLEGE ON THE PARAMETER CARD. 7. ERROR - * PARM SORT OPTION INVALID - RUN ABORTED * MEANING: THE PARM SORT OPTION SUPPLIED ON THE PARAMETER CARD IS NOT D OR SPACE. ACTION: SUPPLY THE CORRECT SORT OPTION AND RE-RUN JOB. 8. ERROR - * ROOT SEGMENT (BOOKMSTR) NOT FOUND *' MEANING: CAN NOT ENTER DATA BASE. ACTION: REPORT THE PROBLEM TO PROGRAMMING. 9. ERROR - * CAMPUS "A" NOT FOUND ON CONTROL CAMPUS * MEANING: CAMPUS CODE OF "A" NOT FOUND ON CONTROL DATA BASE. ACTION: REPORT THE PROBLEM TO PROGRAMMING. 10. ERROR - * DIVISION NOT FOUND ON CONTROL DIVISION * * SS-DIV-1 = _ * WS-HOLD-DIVISION = _ MEANING: DIVISION NOT FOUND ON CONTROL DIVISION. ACTION: INSURE DIVISION DOES NOT EXIST, IF IT DOES REPORT THE PROBLEM TO PROGRAMMING. 11. ERROR - * PUBLISHER FOR ____ BOOK NOT FOUND * (NEW OR USED) MEANING: PUBLISHER CODE NOT FOUND ON PUBLMSTR. ACTION: INSURE PUBLISHER CODE DOES NOT EXIST, IF IT DOES REPORT THE PROBLEM TO PROGRAMMING. 12. ERROR - * NO RECORDS IN SORTED FILE - PROGRAM ABORTED * MEANING: SORTED FILE CONTAINS NO RECORDS ACTION : REPORT THE PROBLEM TO PROGRAMMING. 13. ERROR - * DATA BASE ERROR (MOD XXX) - PCB = * ... MEANING: ACTION: REPORT THE PROBLEM TO PROGRAMMING !!!!!!! 6.0 PROGRAM OPTIONS : ----------------- NONE 7.0 PROGRAM CHANGE HISTORY: ---------------------- 7.1 VERSION NO: 3.7 CHANGE DATE: 03/88 PROGRAMMER: LAURA L. MCCOY PROGRAM CHANGE REQUEST NO: N/A DESCRIPTION OF CHANGE: NEW RELEASE 7.2 VERSION NO: 3.13 CHANGE DATE: 09/02/88 PROGRAMMER: LAURA L. MCCOY PROGRAM CHANGE REQUEST NO: STC-CV-054 DESCRIPTION OF CHANGE: CORRECTED TABLE OVERFLOW PROBLEM CAUSING GARBAGE TO BE WRITTEN ON PART OF TITLE LINE. 7.3 VERSION NO: 4.19 00310002 CHANGE DATE: 12/06/90 00320002 PROGRAMMER NAME: MARIE GORDON 00330002 PROGRAM CHANGE REQUEST NO: 00006577 00340002 DESCRIPTION OF CHANGE: - CHANGED ALL DATA BASE CALLS TO USE STANDARD IOAREA. SEE PAGE 29 OF THE 02/90 PROGRAMMING STANDARD, PROCECEDURES AND GUIDELINES MANUAL. - MADE CHANGES FOR COBOL II.