0.001/15/91 MARIE GORDON 1.0 PROGRAM NARRATIVE: ------------------ THIS BATCH PROGRAM IS DESIGNED TO GENERATE A BOOK LIST FOR A USER, AT A PARTICULAR COLLEGE, WITHIN THE VIRGINIA COMMUNITY COLLEGE COMPUTING NETWORK (VCCS). THIS PROGRAM ALLOWS THE USER THE OPTION OF GENERATING A BOOK LIST FOR "ALL" CAMPUSES OF THE COLLEGE OR JUST ONE SPECIFIC CAMPUS. THE BOOK LIST PRODUCED CAN INCLUDE BOTH NEW AND USED BOOKS, OR NEW BOOKS ONLY, OR ONLY USED BOOKS; DEPENDING UPON THE BOOK OPTION SELECTED BY USER. THE USER ALSO DETERMINES HOW THE BOOKS ARE TO BE SORTED, WITH SPECIAL REGARD TO DIVISION CODES. THE FOLLOWING MAY BE PRINTED DEPENDING UPON WHETHER OR NOT THE INFORMATION IS "AVAILABLE" : CAMPUS DEPARTMENT COURSE NUMBER COURSE TITLE (OF LENGTH 40) SPECIAL SECTIONS (IF ANY) BOOK TITLE-1 RETAIL PRICE (NEW & USED BOOKS) AUTHOR EDITOR-1 BOOK TITLE-2 AUTHOR EDITOR-2 EDITION NUMBER EDITION COMMENT NAME OF PUBLISHER (NEW & USED BOOKS) QUANTITY ON HAND (NEW & USED BOOKS) ISBN (INTERNATIONAL STANDARD BOOK NUMBER) DIVISION CODES (EACH BOOK HAS AT LEAST 1 CODE; MAXIMUM OF 3) REMARKS 2.0 SAMPLE JCL ---------- 2.1 RUN JCL ------- //CVBKS510 JOB (PPPP,RRRR,N,NN),'BKS510',CLASS=F, // PRTY=3,MSGCLASS=A,MSGLEVEL=(1,1) /*ROUTE PRINT ZZZZZ //STEP1 EXEC BKS510,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 "//BKS510 PARMCARD DD" CARD USING THE FOLLOWING DIRECTIONS : CC CONTENTS -- -------- 01-06 NAME OF THE TERM YOU DESIRE THE BOOKLIST 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 BOOK LIST TO BE PRINTED FOR. VALID ENTRIES ARE : '@' - FOR ALL CAMPUSES 'A' - A VALID CAMPUS CODE AT YOUR COLLEGE 10 SORT OPTION STANDARD SORT - ENTER A BLANK DIVISION SORT - ENTER A 'D' STANDARD SORT - SORT ALL OF THE FOLLOWING FLDS IN ASCENDING ORDER : CAMPUS, DEPT, COURSE & BOOKNUM DIVISION SORT - SORT ALL OF THE FOLLOWING FLDS IN ASCENDING ORDER : CAMPUS, DIV, DEPT, COURSE & BOOKNUM 11-14 BOOK OPTION NEW & USED BOOKS - ENTER 'ALL' NEW BOOKS ONLY - ENTER 'NEW' USED BOOKS ONLY - ENTER 'USED' 15-17 QUANTITY OPTION PRINT QUANTITY OF BOOKS ON HAND - ENTER 'QTY' DO NOT PRINT QUANTITY OF BOOKS ON HAND - ENTER BLANKS 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 3 LINES FOR TOP MARGIN PRINTED OUTPUT : BOOK LIST 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. INVOICE (READ ONLY) 6. REMREC (READ ONLY) PUBLISHER DATA BASE (PBL) 1. PUBLMSTR (READ ONLY) 4.2 ADDITIONAL FILES USED: 1. PRINT FILE PRINT FILE (BOOK LIST) 2. SORT-SEGMENTS-FILE (FILE OF DESIRED DATA BASE RECORDS) 3. SORTED-BKMSTR-BKREC-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 - * BOOK OPTION IS INVALID - RUN ABORTED * MEANING: THE BOOK OPTION SUPPLIED ON THE PARAMETER CARD IS NOT "ALL", "NEW", OR "USED". ACTION: SUPPLY THE CORRECT BOOK 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 - * INV-REC NOT FOUND (MOD 365) * MEANING: INVENTORY RECORD NOT ON BOOK DATA BASE. ACTION: INSURE INVENTORY RECORD DOES NOT EXIST, IF IT DOES REPORT THE PROBLEM TO PROGRAMMING. 15. 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. 16. ERROR - * NO RECORDS IN SORTED FILE - PROGRAM ABORTED * MEANING: SORTED FILE CONTAINS NO RECORDS ACTION : REPORT THE PROBLEM TO PROGRAMMING. 17. ERROR - * BOOKMSTR FROM BACK UP MODULE NOT FOUND * MEANING: ATTEMPTED TO BACK UP TO ROOT SEGMENT WITH THE USE OF THE (F) COMMAND CODE ACTION : REPORT THE PROBLEM TO PROGRAMMING. 18. ERROR - * RESET FOR PORDREC NOT PERFORMED * MEANING: NO PORDREC FOUND FOR PUBLISHER CODE CONTAINED IN THE SEGMENT SEARCH ARGUMENT ACTION : REPORT THE PROBLEM TO PROGRAMMING. 19. ERROR - * PREVIOUS PORDREC NOT FOUND * MEANING: PROGRAM IS UNABLE TO RETRIEVE A PREVIOUSLY RETRIEVED PORDREC; CHECK SEGMENT SEARCH ARGUMENTS ACTION : REPORT THE PROBLEM TO PROGRAMMING. 20. ERROR - * DATA BASE ERROR (MOD XXX) - PCB = * ... MEANING: ACTION: REPORT THE PROBLEM TO PROGRAMMING !!!!!!! 21. * MSG - * * * N O U S E D B O O K S * * * MEANING: BOOK OPTION SELECTED - USED BOOKS ONLY, HOWEVER THERE ARE NO USED BOOKS. 22. * MSG - * * * N O N E W B O O K S * * * MEANING: BOOK OPTION SELECTED - NEW BOOKS ONLY, HOWEVER THERE ARE NO NEW BOOKS. 23. * MSG - * * * N O B O O K S !!! * * * MEANING: BOOK OPTION SELECTED - ALL BOOKS, BUT THERE ARE NO BOOKS. 6.0 PROGRAM OPTIONS : ----------------- 1. BKS51001 - THIS OPTION RECORD ALLOWS THE USER TO ENTER USED DEALER CODES. A TOTAL OF EIGHTEEN CODES MAY BE ENTERED. THE PROGRAM OPTION IS NOT REQUIRED. FIELD POSITION OPTION NAME VALUE PROCESSING DESCRIPTION _______________________________________________________________ 1-5 ] USED-DEALER-CODE(1) ] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 6-10 ] USED-DEALER-CODE(2) ] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 11-15 ] USED-DEALER-CODE(3) ] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 16-20 ] USED-DEALER-CODE(4) ] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 21-25 ] USED-DEALER-CODE(5) ] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 26-30 ] USED-DEALER-CODE(6) ] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 31-35 ] USED-DEALER-CODE(7) ] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 36-40 ] USED-DEALER-CODE(8) ] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 41-45 ] USED-DEALER-CODE(9) ] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 46-50 ] USED-DEALER-CODE(10)] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 51-55 ] USED-DEALER-CODE(11)] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 56-60 ] USED-DEALER-CODE(12)] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 61-65 ] USED-DEALER-CODE(13)] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 66-70 ] USED-DEALER-CODE(14)] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 71-75 ] USED-DEALER-CODE(15)] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 76-80 ] USED-DEALER-CODE(16)] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 81-85 ] USED-DEALER-CODE(17)] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 86-90 ] USED-DEALER-CODE(18)] VALID ] ENTER THE PUBLISHER ] ] CODE ] CODE FOR USED DEALER ] ] ] 7.0 PROGRAM CHANGE HISTORY: ---------------------- 7.1 VERSION NO: (NEW PROGRAM) CHANGE DATE: N/A PROGRAMMER: LAURA L. MCCOY PROGRAM CHANGE REQUEST NO: N/A DESCRIPTION OF CHANGE: N/A 7.2 VERSION NO: N/A CHANGE DATE: 12/09/87 PROGRAMMER: CAROL WILLIS PROGRAM CHANGE REQUEST NO: N/A DESCRIPTION OF CHANGE: 1. STRING TITLES TO LEAVE OUT GAPS. 00864 2. STRING EDITION NUMBER AND EDITION COMMENT. 00864 3. REMOVE REFERENCES TO QTY. 00865 4. MOVE 'REMARKS' UNDER BOOK RECORD 00866 SINCE REMARKS NOW APPLY TO THE INDIVIDUAL BOOK 00867 AND NOT THE CLASS. 00868 7.3 VERSION NO: 3.7 CHANGE DATE: 03/88 PROGRAMMER: CAROL WILLIS PROGRAM CHANGE REQUEST NO: NEW RELEASE DESCRIPTION OF CHANGE: 1. MAKE PRINTING OF QTY FIELDS A PROGRAM OPTION. 00864 7.4 VERSION NO: 3.10 CHANGE DATE: 05/06/88 PROGRAMMER: CAROL WILLIS PROGRAM CHANGE REQUEST NO: STC-CV-038 DESCRIPTION OF CHANGE: IF NO PURCHASE ORDER SEGMENTS, TAKE PUBLISHER CODE 00864 FROM BOOKREC SEGMENT. 7.5 VERSION NO: 3.13 CHANGE DATE: 08/22/88 PROGRAMMER: CAROL WILLIS PROGRAM CHANGE REQUEST NO: N/A DESCRIPTION OF CHANGE: MODIFIED TO CHECK INVENTORY SEGMENT FOR BOOK PRICE. 00864 HOWEVER, TAKE PRICE FROM INVOICE SEGMENT IF ONE EXISTS. 7.6 VERSION NO: 3.15 CHANGE DATE: 10/24/88 PROGRAMMER: CAROL WILLIS PROGRAM CHANGE REQUEST NO: STC-CV-056 DESCRIPTION OF CHANGE: BLANKED OUT 'QTY' LITERAL WHEN 'NO TEXTBOOK REQUIRED'. 00864 7.7 VERSION NO: 4.07 CHANGE DATE: 10/02/89 PROGRAMMER: CAROL WILLIS PROGRAM CHANGE REQUEST NO: 00003626 DESCRIPTION OF CHANGE: ADDED A PROGRAM OPTION TO ENTER PUBLISHER CODES THAT 00864 ARE USED BOOK DEALERS. 7.8 VERSION : V4.19 CHANGE DATE : 12/01/90 PROGRAMMER : MARIE GORDON CHANGE REQUEST #: 00006571 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.