0.004/25/88 LAURA L. MCCOY

1.0  PROGRAM NARRATIVE:
     ------------------

          THIS BATCH PROGRAM IS DESIGNED TO GENERATE A PUBLISHER LIST
     FOR A PARTICULAR COLLEGE, WITHIN THE VIRGINIA COMMUNITY COLLEGE
     COMPUTING NETWORK (VCCS).

          THE PUBLISHER LIST CONSIST OF PUBLISHER NAMES AND ADDRESSES.
     THE LIST IS ORDERED SEQUENTIALLY ACCORDING TO PUBLISHER CODES.

          THE FOLLOWING MAY BE PRINTED FOR EACH PUBLISHER/VENDOR :

     PUBLISHER CODE
     NAME OF PUBLISHER
     ABBREVIATION        (NAME OF PUBLISHER, SHORT VERSION)
     ORDER ADDRESS
     PHONE-ORDER         (PHONE # TO DIAL WHEN PLACING AN ORDER)
     RETURN ADDRESS
     PHONE-RETURN        (PHONE # TO DIAL WHEN WISHING TO RETURN ORDER)
     RETURN ADDRESS
     PRIOR PERMISSION RETURN
     TIME LIMIT RETURN


2.0  SAMPLE JCL
     ----------

2.1  RUN JCL
     -------

     THE FOLLOWING JCL SHOULD BE USED IF THE FILE IS TO BE
     SORTED BY 'PUBLISHER CODE'.

        //CVBKS550  JOB (PPPP,RRRR,N,NN),'BKS550',CLASS=F,
        //  PRTY=3,MSGCLASS=A,MSGLEVEL=(1,1)
       /*ROUTE PRINT ZZZZZ
       //STEP1 EXEC BKS550,COLLEGE=II,AGENCY=AAA
       //

     THE FOLLOWING JCL SHOULD BE USED IF THE FILE IS TO BE
     SORTED BY 'PUBLISHER NAME'.

        //CVBKS550  JOB (PPPP,RRRR,N,NN),'BKS550',CLASS=F,
        //  PRTY=3,MSGCLASS=A,MSGLEVEL=(1,1)
       /*ROUTE PRINT ZZZZZ
       //STEP1 EXEC BKS550,COLLEGE=II,AGENCY=AAA
       //PARMCARD DD *
       ALPHA
       /*
       //

    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 :
     ------------------


     PPPP - PROGRAMMER NUMBER
     RRRR - ROOM NUMBER
     ZZZZ - REMOTE NUMBER



3.0  JOB SETUP INSTRUCTIONS :
     ------------------------

     SPECIAL FORMS QUEUE :         STANDARD
     FORMS BUFFER :                STANDARD
     ALIGNMENT INSTRUCTIONS :      STANDARD
     PRINTED OUTPUT :              PUBLISHER LIST
     FORMS TYPE :                  STOCK 8 1/2 * 11
     SPECIAL INSTRUCTIONS :



4.0  FILES:
     -----

     4.1  DATA BASES USED:
            CONTROL DATA BASE
              1.  CTLCAMPM               (READ ONLY)

            PUBLISHER DATA BASE
              1.  PUBLMSTR               (READ ONLY)

     4.2  ADDITIONAL FILES USED:
              1.  PRTFILE                  PRINT FILE (PUBLISHER LIST)
              2.  PUBLMSTR-FILE            (FILE OF DESIRED DATA BASE
                                            RECORDS)
              3.  SORTED-FILE              (SORTED FILE OF DESIRED DATA
                                            BASE RECORDS)
              4.  SORT-FILE                (WORK FILE)

              4.  PARM-CARD               INPUT FILE ONLY FOR ALPHA SORT

     4.3  INPUT/OUTPUT RECORD LAYOUTS:
            N/A

5.0  SPECIAL FEATURES:
     ----------------

     5.1  CALLING PROGRAMS:
          NONE

     5.2  SUBPROGRAMS CALLED:
          NONE

     5.3  MESSAGE SEGMENT CODES: N/A


5.4  SPECIAL OUTPUT MESSAGES :
     -------------------------

     1. ERROR - * ROOT SEGMENT (PUBLMSTR) NOT FOUND *
          MEANING:  CAN NOT ENTER PUBLISHER DATA BASE.
          ACTION:   REPORT THE PROBLEM TO PROGRAMMING.

     2. ERROR - * DATA BASE ERROR - PCB = ...
          MEANING:
          ACTION:   REPORT THE PROBLEM TO PROGRAMMING.

     3. 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.

     4. * MSG - * END OF DATA BASE REACHED *
          MEANING:  REACHED THE END OF DATA BASE
          ACTION:   THIS MESSAGE CAN BE IGNORED BY USER; UNLESS PART OR
                    ALL OF OUTPUT IS MISSING.


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.1  VERSION NO:                3.9
          CHANGE DATE:               03/30/88
          PROGRAMMER:                CAROL WILLIS
          PROGRAM CHANGE REQUEST NO: STC-CV-033
          DESCRIPTION OF CHANGE:     ADDED OPTION TO SORT ALPHABETICALLY
                                     BY PUBLISHER'S NAME.