0.001/15/91 MARIE GORDON 1.0 PROGRAM NARRATIVE: ------------------ BOOK LIST BY COURSE WRITTEN EXCLUSIVELY FOR THOMAS NELSON COMMUNITY COLLEGE THIS PROGRAM LISTS ALL BOOKS FOR A PARTICULAR TERM. IT CAN SERVE AS A WORK SHEET FOR ENTERING QUANTITIES OF BOOKS IN DIFFERENT CATEGORIES. THE FOLLOWING OPTIONS HAVE BEEN INCORPORATED INTO THE PROGRAM: (1) WHICH TERM THE REPORT IS TO BE GENERATED FOR. (2) WHICH YEAR THE REPORT IS TO BE GENERATED FOR. (3) WHETHER OR NOT THE REPORT IS TO INCLUDE ALL CAMPUSES OR JUST ONE SPECIFIC CAMPUS, USER SELECTS CAMPUS. (4) WHETHER OR NOT THE REPORT IS TO BE SORTED BY DIVISION CODES. IF THE REPORT IS SORTED BY DIVISIONS, THE REPORT WILL BE PRINTED BY DIVISION ORDER, WITH THE DIVISION NAME APPEARING AT THE TOP OF THE REPORT. (5) PRINT OPTION - IF A USER SO WISHES, THIS PROGRAM WILL PRINT VALUES IN EACH OF THE CATEGORIES LISTED BELOW: (A) QUANTITY NEEDED (B) QUANTITY ON HAND (C) QUANTITY ORDERED (NEW) (D) QUANTITY ORDERED (USED) (E) MAXIMUM ENROLLMENT VALUES ARE NOT PRINTED FOR SOME CATEGORIES, BECAUSE THEY DO NOT APPEAR ON THE BOOKSTORE DATA BASE. THOSE CATEGORIES ARE LISTED BELOW: (A) BUY BACK QUANTITY (B) EXCESS ON HAND (C) NUMBER TO RETURN (D) TOTAL (CAN NOT BE CALCULATED, BECAUSE ABOVE VALUES ARE NOT PRESENT) SIMPLY ENTER "YES" IN THE SPACE PROVIDED FOR PRINT OPTION ON THE PARAMETER CARD. IF THE USER ENTERS 'NO ' IN THE PRINT OPTION FIELD, ALL CATEGORIES WILL REMAIN BLANK; TO BE USED AS WORK AREAS ALLOWING THE USER TO "FILL IN" THE VALUES. ALSO, IN PLACE OF MAXIMUM ENROLLMENT THE CATEGORY BECOMES ACTUAL ENROLLMENT. A TEXTBOOK MAY HAVE SEVERAL REMARK STATEMENTS ACCOMPANYING IT. IF ANY ARE PRESENT REMARKS WILL BE PROMPTLY DISPLAYED (PRINTED). THE FOLLOWING DATA ELEMENTS WILL BE PRINTED: BOOKMSTR SEGMENT FLDS. ---------------------- CAMPUS DEPARTMENT COURSE NUMBER BKREC SEGMENT FLDS. ------------------- AUTHOR/EDITOR BOOK TITLE DIVISION CODES (EACH BOOK HAS AT LEAST 1 CODE; MAXIMUM OF 3) EDITION NUMBER ISBN (INTERNATIONAL STANDARD BOOK NUMBER) QUANTITY NEEDED REMREC SEGMENT FLDS. -------------------- BOOK REMARKS PUBLMSTR SEGMENT FLDS. ---------------------- PUBLISHER NAME OTHER ----- MAXIMUM ENROLLMENT 2.0 SAMPLE JCL ---------- 2.1 RUN JCL ------- //CVBKS570 JOB (PPPP,RRRR,N,NN),'BKS570',CLASS=F, // PRTY=3,MSGCLASS=A,MSGLEVEL=(1,1) /*ROUTE PRINT ZZZZZ //STEP1 EXEC BKS570,COLLEGE=II,AGENCY=AAA //PARMCARD DD * XXXXXXXXXXXXX /* // 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 "//BKS570 PARMCARD DD" CARD USING THE FOLLOWING DIRECTIONS : CC CONTENTS -- -------- 01-06 NAME OF THE TERM THE REPORT IS TO BE PRINTED FOR. (I.E. FALL ) 07-08 YEAR THE REPORT IS BE PRINTED FOR, ENTER LAST 2 DIGITS. (I.E. 88) 09 CAMPUS CODE FOR REPORT 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 : CAMPUS, DEPT, COURSE & BOOKNUM DETAILED SORT - SORT ALL OF THE FOLLOWING FLDS IN ASCENDING ORDER : CAMPUS, DIV, DEPT, COURSE & BOOKNUM 11-13 PRINT OPTION - IF USER WISHES, PROGRAM WILL PRINT VALUES FOR CATEGORIES LISTED ON REPORT, THESE CATEGORIES ARE DESCRIBED ABOVE, (SEE 1.0 PROGRAM NARRATIVE). PROGRAM GENERATED VALUES - ENTER 'YES' WORK AREAS - ENTER 'NO ' 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 : BOOKS BY DIVISION / DEPARTMENT 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) COURSE DATA BASE 1. CRSDEPT (READ ONLY) 2. CRSSEGM (READ ONLY) BOOK STORE DATA BASE 1. BOOKMSTR (READ ONLY) 2. BOOKREC (READ ONLY) 3. INVREC (READ ONLY) 4. PORDREC (READ ONLY) 5. REMREC (READ ONLY) CLASS DATA BASE 1. CLSMASTR (READ ONLY) PUBLISHER DATA BASE 1. PUBLMSTR (READ ONLY) 4.2 ADDITIONAL FILES USED: 1. PRINT-FILE PRINT FILE (REPORT) 2. BKS-FILE (FILE OF DESIRED DATA BASE RECORDS) 3. SORTED-FILE (SORTED FILE OF DESIRED DATA BASE RECORDS) 4. SORT-FILE (WORK FILE) 5. 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 - * PARM PRINT OPTION INVALID - RUN ABORTED * MEANING: THE PRINT OPTION SUPPLIED ON THE PARAMETER CARD IS NOT "YES", OR "NO ". ACTION: SUPPLY THE CORRECT PRINT OPTION AND RE-RUN JOB. 9. ERROR - * ROOT SEGMENT (BOOKMSTR) NOT FOUND *' MEANING: CAN NOT ENTER DATA BASE. ACTION: REPORT THE PROBLEM TO PROGRAMMING. 10. 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. 11. 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. 12. ERROR - * DEPARTMENT NOT FOUND * MEANING: DEPARTMENT NOT ON CONTROL DATA BASE. ACTION: INSURE DEPARTMENT DOES NOT EXIST, IF IT DOES REPORT THE PROBLEM TO PROGRAMMING. 13. ERROR - * COURSE TITLE NOT FOUND * MEANING: COURSE TITLE NOT ON CONTROL DATA BASE. ACTION: INSURE COURSE TITLE DOES NOT EXIST, IF IT DOES REPORT THE PROBLEM TO PROGRAMMING. 14. ERROR - * NO RECORDS IN SORTED FILE - PROGRAM ABORTED * MEANING: SORTED FILE CONTAINS NO RECORDS ACTION : REPORT THE PROBLEM TO PROGRAMMING. 15. 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.10 CHANGE DATE: 05/02/88 PROGRAMMER: CAROL WILLIS PROGRAM CHANGE REQUEST NO: STC-CV-037 DESCRIPTION OF CHANGE: 1) IF NO PURCHASE ORDER SEGMENTS, TAKE PUBLISHER CODE FROM BOOKREC SEGMENT. 2) FOR PRINT-OPTION = 'YES', ALL VALUES EXCEPT QTY-NEEDED AND MAX-ENROLL WILL BE BLANK WHEN ZERO. 7.3 VERSION NO: 4.19 00350016 CHANGE DATE: 12/06/90 00360016 PROGRAMMER NAME: MARIE GORDON 00370016 PROGRAM CHANGE REQUEST NO: 00006576 00380016 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.