0.002/01/98 KEN BALLARD 1.0 PROGRAM NARRATIVE ----------------- REG320 PRINTS AUDIT NOTIFICATION CARDS OR WITHDRAWAL NOTIFICATION CARDS USED TO INFORM THE INSTRUCTORS OF A STUDENT'S CHANGE FROM A CREDIT TO AN AUDIT OR TO INFORM THE INSTRUCTORS OF THE STUDENT'S WITHDRAWAL FROM HIS CLASS. THESE CARDS ARE SENT TO THE ADMISSIONS AND RECORDS OFFICE TO BE DISTRIBUTED TO THE INSTRUCTORS. THE TYPE OF WITHDRAWAL IS NOTED ON THE CARD AS BEING ADMINISTRATIVE, STUDENT INITIATED OR COMPLETE WITHDRAWAL FROM THE COLLEGE. THE GRADE RECEIVED AND THE DATE OF WITHDRAWAL ARE ALSO NOTED. REG320 USES AN INPUT RECORD TO PROVIDE THE TERM AND YEAR TO BE PROCESSED. THE SESSION DATES ARE EXTRACTED FROM THE 'CTLQUART' OF THE CONTROL DATA BASE. THE INPUT RECORD ALSO SELECTS THE NOTIFICATION TYPE: 'A' - AUDIT ONLY 'W' - WITHDRAWAL ONLY, '@' - BOTH AUDIT AND WITHDRAWAL. REG320 HAS AN OPTION ON THE PARMCARD TO PRINT A LIST OF ALL STUDENTS FOR WHICH AN WITHDRAWAL CARD WAS PRINTED. THE REPORT CONTAINS: SOC. SEC. NO., STUDENT'S FULL NAME (FIRST,INTIAL,LAST,SUFFIX), COURSE ID (YEAR/TRM, CAMPUS, DEPT, COURSE, SECT, LAB, SESS), GRADE, WITHDRAWAL TYPE AND DATE (IF APPLICABLE), STUDENT'S FULL ADDRESS AND HOME PHONE NO. REG320 READS THE STUDENT REGISTRATION RECORDS AND SELECTS RECORDS WHICH MEET THE FOLLOWING CRITERIA: AUDITS: PARM-NOTIFY-TYPE = 'A' OR '@' AND GRADE= 'X' AND SR-CIT-LATE-ADD = 'N' AND WITHDRAW-NOTIFY-FLAG = SPACE AND QTRYR (ON INPUT RECORD) = QUARTER-ID OF REGISTRATION SEGMENT WITHDRAWALS: PARM-NOTIFY-TYPE = 'W' OR '@' AND WITHDRAW-TYPE = 'A' OR 'S' OR 'C' AND WITHDRAW-NOTIFY-FLAG = SPACE OR 'X' AND QTRYR (ON INPUT RECORD) = QUARTER-ID OF REGISTRATION SEGMENT WHEN A RECORD IS FOUND WHICH MEETS THE CRITERIA, A NOTIFICATION CARD IS FORMATTED. THE RECORDS ARE SORTED ON GRADE WITHIN NAME (INSTRUCTOR) WITHIN DIVISION WITHIN CAMPUS. IF A STUDENT WITHDRAWS FROM A CLASS WITH A GRADE OF R, S, OR W AND THE WITHDRAW DATE IS PAST THE DATE FOUND ON THE INPUT RECORD, THEN THE MESSAGE "(MITIGATING CIRCUMSTANCES)" IS PRINTED ON THE WITHDRAWAL NOTIFICATION CARD. REG320 UPDATES THE WITHDRAW-NOTIFY-FLAG IN THE STUDENT REGISTRATION SEGMENT TO INDICATE THAT AN AUDIT OF WITHDRAWAL NOTIFICATION CARD HAS BEEN PRINTED. THIS FLAG IS UPDATED AS FOLLOWS: AUDITS: MOVES AN 'X' TO THE FIELD WITHDRAWALS: MOVES A 'Y' TO THE FIELD REG320 CREATES A DROP REGISTRATION WITH THE AUDIT INFORMATION AND THE REGISTRATION SEGMENT INFORMATION PRIOR TO UPDATE. REG320 ALSO READS REG320-01 OPTION SEGMENT TO DETERMINE WHICH ACCOUNT-CODE NAMES ARE TO APPEAR ON THE NOTIFICATION CARD. THERE CAN BE AS MANY AS 10 DIFFERENT ACCOUNT-CODES IN THIS SEGMENT. NO PROGRAM OPTION RECORD IS REQUIRED FOR COLLEGES THAT DO NOT WISH TO USE THIS FEATURE. 2.0 SAMPLE JCL ---------- 2.1 RUN JCL ------- //TCREG320 JOB (XXXX,YYYY,9,9),REG320,CLASS=F, // MSGCLASS=A,MSGLEVEL=(0,0),PRTY=3,REGION=2048K /*ROUTE PRINT RMTZZ /*SETUP ** * * * * * * * * * * * * * * * /*SETUP ** THIS UPDATE JOB WILL REQUIRE TAPE(S) WITH RING /*SETUP ** FROM THE BATCH SCRATCH POOL. /*SETUP ** NEVER REPLY 'U' /*SETUP ** * * * * * * * * * * * * * * * //* //REG320 EXEC REG320,AGENCY=XXX,COLLEGE=XX //REG320.PARMCARD DD * -- INPUT RECORD -- /* // * SYMBOLIC DESCRIPTION ******************** REQUIRED - AGENCY COLLEGE AGENCY CODE NUMBER (E.G. AGENCY=293) COLLEGE TWO CHARACTER COLLEGE NAME ABBREVIATION (E.G. COLLEGE=TN) OPTIONAL - FORM FORM NUMBER THE OUTPUT IS TO BE STORED UNDER DEFAULT: A000 (E.G. FORM=0002) FORM2 FORM NUMBER THE WITHDRAWAL CARDS ARE TO BE STORED UNDER DEFAULT: 0222 (E.G. FORM2=0002) FORM3 FORM NUMBER FOR LABELS DEFAULT: H103 (E.G. FORM3=0100) QUEUE QUEUE CLASS THE OUTPUT IS TO BE SPOOLED UNDER DEFAULT: * (E.G. QUEUE='A') QUEUE2 QUEUE CLASS THE WITHDRAWAL CARDS ARE TO BE STORED UNDER DEFAULT: * (E.G. QUEUE2='A') QUEUE3 QUEUE CLASS FOR LABELS DEFAULT: J (E.G. QUEUE3='J') FCB FORMS CONTROL BLOCK FOR LABELS DEFAULT: H103 (E.G. FCB=H103) SRTSIZE AMOUNT OF DASD STORAGE IN CYLINDERS ALLOCATED TO EACH SORT WORK FILE DEFAULT: 3 (E.G. SRTSIZE=5) 2.2 INPUT PARAMETERS: ---------------- POS CONTENTS --- -------- 01-06 TERM ID (I.E. WINTER, SPRING, SUMMER, FALL) 07-08 YEAR (I.E. 87) 09 ENTER 'X' TO RECEIVE A REPORT OF STUDENTS WITHDRAWAL CARDS 10 ENTER THE TYPE OF NOTIFICATION CARDS TO BE PRINTED (I.E. 'A' - AUDIT, 'W' - WITHDRAWAL, '@' - BOTH TYPES) 11 ENTER THE TYPE OF LABELS TO BE PRINTED (I.E. '1' - 1 UP, '3' - 3-UP, D) 'S' - STANDARD, ' ' - NO LABELS) D) 12 SORT OPTION 'C' OR ' ' - CAMP/DIV/INSTR OF STUDENT ADV 'A' - ALPHA SORT BY INSTRUCTOR 'S' - SORT BY STUDENT NAME 'I' - CAMP/DIV/INSTRUCTOR NAME D) 3.0 JOB SETUP INSTRUCTIONS ---------------------- SPECIAL FORMS QUEUE: 0222 - WITHDRAWAL NOTIFICATION CARDS FORMS BUFFER: TOP OF FORM EVERY 26 LINES PRINT AT 8 LINES PER INCH ALIGNMENT INSTRUCTIONS: LEFT EDGE SAME AS STANDARD LINE PRINT LINE ON SECOND LINE OF FORM. PRINTED OUTPUT: WITHDRAWAL NOTIFICATION CARDS FORMS TYPE: WITHDRAWAL NOTIFICATION CARDS PRINTED OUTPUT: 1UP, 3UP OR STANDARD LABELS FORMS TYPE: 1UP, 3UP OR STANDARD LABELS SPECIAL INSTRUCTIONS: * 4.0 FILES ----- 4.1 DATABASE SEGMENTS USED: ----------------------- A. CLASS DATABASE 1. CLSDETAL (READ) B. CONTROL DATABASE 1. CTLPROPT (READ) 2. CTLQUART (READ) C. COURSE DATABASE 1. CRSSEGM (READ) D. INSTRUCTOR DATABASE 1. INSTRUCR (READ) E. STUDENT DATABASE 1. STUACCTD (READ) 2. STUDENTM (READ) 3. STUREGIS (UPDATE) 4. STUDRPRG (ADD) F. ACCOUNT DATABASE 1. ACCTMSTR (READ) G. ADVISOR DATABASE 1. ADVINSL (READ) 4.2 ADDITIONAL FILES USED: N/A --------------------- 4.3 INPUT/OUTPUT RECORD LAYOUT: N/A -------------------------- 5.0 SPECIAL OUTPUT MESSAGES: N/A ----------------------- * 6.0 SPECIAL FEATURES ---------------- 6.1 CALLING PROGRAMS: N/A 6.2 SUBPROGRAMS CALLED: UTL550S, REG742S 6.3 MESSAGE SEGMENT CODES: N/A 7.0 PROGRAM OPTIONS: N/A --------------- 1. REG32001 - THIS OPTION RECORD IS USED TO SUPPLY THE PROGRAM WITH ACCOUNT-CODES SO THAT THEIR CORRESPONDING NAMES WILL APPEAR ON THE WITHDRAWAL NOTIFICATION CARDS. FIELD POSITION OPTION NAME ---------------------------- 01-04 ] ACCT1 05-08 ] ACCT2 09-12 ] ACCT3 13-16 ] ACCT4 17-20 ] ACCT5 21-24 ] ACCT6 25-28 ] ACCT7 29-32 ] ACCT8 33-36 ] ACCT9 37-40 ] ACCT10 * 8.0 PROGRAM CHANGE HISTORY ---------------------- 8.1 VERSION NO: V1.3 CHANGE DATE: 02/02/84 PROGRAMMER NAME: KEN BALLARD PROGRAM CHANGE REQUEST NO: N/A DESCIPTION OF CHANGE: NEW PROGRAM 8.1 VERSION NO: V1.8 CHANGE DATE: 07/09/84 PROGRAMMER NAME: KEN BALLARD PROGRAM CHANGE REQUEST NO: N/A DESCIPTION OF CHANGE: CHANGED PROC TO CONFORM TO SIS PROC 8.2 VERSION NO: 2.0 CHANGE DATE: 04/25/85 PROGRAMMER NAME: RON LOPEZ PROGRAM CHANGE REQUEST NO: STC-VW-031 DESCIPTION OF CHANGE: MODIFY IN PROC STUDENT DATA BASE DISP=SHR TO DISP=OLD. ALSO MODIFY MODULE TO PRINT CARDS PROCESSED. 8.3 VERSION NO: 2.9 CHANGE DATE: 05/25/86 PROGRAMMER NAME: G. TAYLOR PROGRAM CHANGE REQUEST NO: STC-VW-031 STC-SO-058 STC-SO-118 DESCIPTION OF CHANGE: MODIFY IN PROC STUDENT DATA BASE DISP=SHR TO DISP=OLD. ALSO ADD A OPTION TO PRINT CARDS PROCESSED. DISPLAY PARMCARD. CHANGED PROGRAM ID FROM REG888 TO REG320. 8.4 VERSION NO: V2.11 CHANGE DATE: 09/09/86 PROGRAMMER NAME: RICHARD GILLETTE PROGRAM CHANGE REQUEST NO: STC-SO-210 DESCRIPTION OF CHANGE: ADDED DBRC MONITORING TO PROC. 8.5 VERSION NO: V2.12 CHANGE DATE: 10/28/86 PROGRAMMER NAME: RICHARD GILLETTE PROGRAM CHANGE REQUEST NO: STC-SO-228 DESCRIPTION OF CHANGE: ADDED BATCH LOCKOUT PROCEDURE. MODIFIED RUN JCL ACCORDINGLY, I.E., //PARMCARD BECOMES //REG320.PARMCARD. 8.6 VERSION NO: V3.1 CHANGE DATE: 06/01/87 PROGRAMMER NAME: F. E. FRANKLIN PROGRAM CHANGE REQUEST NO: SCP-SO-030 DESCRIPTION OF CHANGE: MODIFIED PROGRAM TO VALIDATE TERM-ID AGAINST CONTROL QUARTER AND CHANGED REFERENCES FROM QUARTER TO TERM IN PROGRAM AND DOCUMENTATION. NO MODIFICATIONS WERE NECESSARY TO ACCOMODATE FRACTIONAL CREDITS. CHANGED PARM DATE TO BE TERM NAME/YEAR ALSO CREATED EDITS FOR THE SESSION DATES. 8.7 VERSION NO: V3.8 CHANGE DATE: 03/04/88 PROGRAMMER NAME: RICK HEFLIN PROGRAM CHANGE REQUEST NO: STC-TN-192 CHANGE FORM2=A000 TO FORM2=0222 8.8 VERSION NO: V3.11 CHANGE DATE: 05/23/88 PROGRAMMER NAME: JANICE FOLLIS PROGRAM CHANGE REQUEST NO: STC-TC-314 -MODIFIED THE PROGRAM TO PRODUCE AUDIT NOTIFICATION CARDS OR WITHDRAWAL NOTIFICATION CARDS DEPENDING ON THE PARMCARD OPTION SELECTED (COL. 22). THE WITHDRAW-NOTIFY-FLAG IS SET TO 'X' IF AN AUDIT NOTIFICATION CARD IS PRINTED AND IS SET TO A 'Y' IF A WITHDRAWAL NOTIFICATION CARD IS PRINTED. THE NOTIFICATION CARDS ARE IDENTICAL EXCEPT THAT THE WITHDRAWAL DATE AND TYPE ARE BLANK ON THE AUDIT NOTIFICATION CARD AND THERE IS NO MESSAGE PRINTED FOR "MITIGATING CIRCUMSTANCES" ON AN AUDIT NOTIFICATION. 8.9 VERSION NO: V3.11 CHANGE DATE: 06/10/88 PROGRAMMER NAME: ASC PROGRAM CHANGE REQUEST NO: STC-SO-395 DESCRIPTION OF CHANGE: MODIFIED JCL PROC TO; REMOVE LOGTAPE AND RECTAPE PARAMETERS, ADDED RETENTION DATE PROTECTION TO THE TAPES USED FOR IMS LOGGING, ADDED SETUP CARDS TO THE SAMPLE JCL TO INDICATED THAT THE TAPES WILL BE MOUNTED FROM A BATCH SCRATCH POOL. 8.10 VERSION NO: V3.14 CHANGE DATE: 09/20/88 PROGRAMMER NAME: S. EDMONDS PROGRAM CHANGE REQUEST NO: STC-SR-557 (00000952) DESCRIPTION OF CHANGE: MODIFIED PROGRAM TO NOT PRODUCE LINE-UPS WHEN THERE ARE NO RECORDS. 8.11 VERSION NO: V4.00 CHANGE DATE: 02/15/89 PROGRAMMER NAME: P. BUCHANAN PROGRAM CHANGE REQUEST NO: INFO#: 00002130 DESCRIPTION OF CHANGE: MODIFIED PROGRAM SO THAT IF THE ONLINE OPTION FOR THIS PROGRAM HAS ACCOUNT CODES, THE PROGRAM WILL READ THE ACCOUNT MASTER SEGMENT TO OBTAIN THE ACCOUNT NAME, INSTEAD OF TRYING TO RETRIEVE IT FROM THE CONTROL DATA BASE. 8.12 VERSION NO: V4.03 CHANGE DATE: 06/03/89 PROGRAMMER NAME: BOB DODGE PROGRAM CHANGE REQUEST NO: INFO#: 00002507, 00002682 DESCRIPTION OF CHANGE: MODIFIED PROGRAM TO INCLUDE ADVISOR'S NAMED IN THE HEADING THIS REQUIRED A PSB CHANGE TO READ THE ADVISOR DATA BASE. ADDED AN OPTION TO GENERATE 1UP, 3UP OR STANDARD LABELS FOR WITHDRAWN STUDENTS. 8.13 VERSION NO: V4.08 CHANGE DATE: 11/15/89 PROGRAMMER NAME: BOB DODGE PROGRAM CHANGE REQUEST NO: INFO#: 00003859, 00003896 DESCRIPTION OF CHANGE: MODIFIED PROGRAM TO PRINT MITIGATING CIRCUSTANCES ONLY ON WITHDRAWAL NOTIFICATION CARDS. ADDED A LABEL BREAK ON CAMPUS CORRECTED PRINTING 3-UP LABELS WHEN SELECTED. 8.14 VERSION NO: V4.17 CHANGE DATE: 10/02/90 PROGRAMMER NAME: BOB DODGE PROGRAM CHANGE REQUEST NO: INFO#: 00006099 DESCRIPTION OF CHANGE: MODIFIED PROGRAM NOT TO PRINT LINE UPS FOR NOTIFICATION CARDS IF NOT STUDENTS ARE SELECTED. 8.15 VERSION NO: V4.19 CHANGE DATE: 12/20/90 PROGRAMMER NAME: BOB DODGE PROGRAM CHANGE REQUEST NO: INFO#: 00003527, 00005385 00006746 00006980 DESCRIPTION OF CHANGE: - MODIFIED PROGRAM TO SELECT THE SESSION DATE FROM THE 'CTLQUART' OF THE CONTROL DATA BASE. THIS WAY ALL SESSIONS CAN BE SELECTED NOT JUST 3. - ELIMINATED PRINTING FORMS LINE-UPS FOR ALL FORMS IF ZERO RECORDS ARE SELECTED. - CHANGED THE DATA BASE CALLS TO USE A COMMON IOAREA INSTEAD OF THE COPYLIB MEMBER. - I00005385 IS THE SAME AS I00003527 8.16 VERSION NO: V4.23 CHANGE DATE: 05/09/91 PROGRAMMER NAME: BETH DUFF PROGRAM CHANGE REQUEST NO: 00007728,00007841 DESCRIPTION OF CHANGE: - 00007728 CORRECTED PROBLEM WITH NOT PRINTING THE MESSAGE 'MITIGATING CIRCUMSTANCES'. CHANGED CHECK-DATE FIELD TO THE MONTH AND DAY FORMAT TO COMPARE TO DATE-WITHDREW. - 00007841 INCREASED THE NUMBER OF VALID SESSIONS FROM 24 TO 26. SEGMENT CTLSESS HAD BEEN INCREASED WITH V4.21. - MODIFIED PROGRAM TO COMPILE AND LINK UNDER THE COBOL II STANDARDS. 8.17 VERSION NO: V4.27 CHANGE DATE: 09/16/91 PROGRAMMER NAME: MARIE GORDON PROGRAM CHANGE REQUEST NO: 00008044 DESCRIPTION OF CHANGE: RECOMPILED AND TESTED AGAINST CONVERTED DATA BASES TO INCLUDE NEW ACCTMSTR AND STUACCTD COPY MEMBERS. PROGRAM CHANGE REQUEST NO: 00008172 DESCRIPTION OF CHANGE: MODIFIED DOCUMENTATION TO INCLUDE JCL REQUIREMENTS FOR PRINTING LABELS AND TO NOTE THAT A BLANK IN COLUMN 11 OF THE PARMCARD IS USED FOR NO LABELS. 8.18 VERSION NO: V4.35 CHANGE DATE: 06/15/92 PROGRAMMER NAME: LORI CALLIOTTE PROGRAM CHANGE REQUEST NO: 00010103 DESCRIPTION OF CHANGE: - RECOMPILED USING NEW CTLQUART COPYLIB MEMBER WHICH WAS MODIFIED TO INCLUDE THE NEW MILITARY TUITION RATE. 8.19 VERSION NO: V4.39 CHANGE DATE: 07/08/92 PROGRAMMER NAME: WAYNE DAVIS PROGRAM CHANGE REQUEST NO: 00009328 DESCRIPTION OF CHANGE: - ADDED 'ALPHA' SORT OPTION TO PARMCARD. SEE INPUT PARAMETERS FOR DESCRIPTION. 8.20 VERSION: V5.0 CHANGE DATE: 05/15/93 PROGRAMMER: MARIE GORDON PROGRAM REQUEST: 00012161 DESCRIPTION: RECOMPILE FOR 5.0 DATABASE CONVERSION PROGRAM REQUEST: 00012207 DESCRIPTION: MODIFIED PROGRAM TO CONFORM TO THE STANDARD USE OF IOAREA. SEE PAGE 9 OF THE AUGUST 1992 PROGRAMMING STANDARDS, PROCEDURES AND GUIDELINES MANUAL. 8.21 VERSION NO: V5.04 CHANGE DATE: 08/24/93 PROGRAMMER NAME: WAYNE DAVIS PROGRAM CHANGE REQUEST NO: 00012967 DESCRIPTION OF CHANGE: - ADDED 'STUDENT' SORT OPTION TO PARMCARD. SEE INPUT PARAMETERS FOR DESCRIPTION. 8.22 VERSION: V5.07 CHANGE DATE: 12/03/93 PROGRAMMER: KATHY HARCUM PROGRAM REQUEST: 00013117 DESCRIPTION: -MODIFIED TO PLACE THE CAMPUS AND DIVISION FROM THE STUDENTM SEGMENT ON THE NOTIFICATION CARD WHEN THERE IS NO ADVISOR CODE INSTEAD OF MOVING SPACES. 8.23 VERSION: V5.11 CHANGE DATE: 04/15/94 PROGRAMMER: BARBARA SHANKO PROGRAM REQUEST: 00013919 DESCRIPTION: -ADDED ANOTHER SORT OPTION IN COLUMN 12 TO SORT BY CAMPUS/DIVISION OF THE INSTRUCTOR. THE CURRENT SORT BY CAMPUS/DIVISION SORTS IT BY STUDENT'S DIVISION. 8.24 VERSION: V6.0 CHANGE DATE: 11/15/95 PROGRAMMER NAME: BARBARA TRUITT PROGRAM CHANGE REQUEST NO: 00014931 DESCRIPTION OF CHANGE: CHANGED THE PROGRAM TO PASS '0888' TO THE RETURN CODE BEFORE THE GOBACK WHEN AN ERROR CONDITION EXISTED. PROGRAM CHANGE REQUEST NO: 00016163 DESCRIPTION OF CHANGE: ADDED THE STUDRPRG SEGMENT TO THE PSB. CHANGED THE PROGRAM TO ADD A DROP REGISTRATION SEGMENT WITH A 'C' IN PROCESS CODE WHEN A REGISTRATION WAS UPDATED. 8.25 VERSION: V7.00 CHANGE DATE: 09/15/1997 PROGRAMMER: HARRY L. WALDRON, VWCC PROGRAM CHANGE REQUEST: I-16635 (ASC) DESCRIPTION OF CHANGE: 1. I-16635: COMBINED ACCOUNTS RECEIVABLE (FEES PROJECT) ------------------------------------------------------ * COMPILED PROGRAM USING "ASC" COPYLIBS AND LIBRARIES * TESTED PROGRAM USING "ASC" COPYLIBS AND LIBRARIES 2. OTHER PROGRAMMING CHANGES TO MEET VCCS STANDARDS ------------------------------------------------------ * COBOL II MIGRATION - ID DIVISION COMMENTARY CHANGES * COBOL II MIGRATION - FD AND ASSIGN CLAUSE CHANGES * ADDED BLOCK CONTAINS 0 RECORDS TO PRINT FILES 8.26 VERSION: V7.00 CHANGE DATE: 12/12/97 PROGRAMMER: GERRY J. LIETTE (TCC) PROGRAM REQUEST: 00017864 DESCRIPTION: ADDED "VALUE SPACES" CLAUSE TO INITIALIZE WS-PRT-REC IN WORKING STORAGE TO FIX SPACING PROBLEMS WHEN PRINTING 3-UP LABELS THROUGH TCP/IP. WE HAVE FOUND THAT TCP/IP DOES NOT LIKE NULL VALUES.