0.010/15/94 ANDREW HASLETT 1.0 PROGRAM NARRATIVE ----------------- PROGRAM UTL530 PRODUCES MAILING LABELS. THE USER CAN SPECIFY EITHER ONE-UP OR THREE-UP LABELS BY THE USE OF A PARMCARD. THE USER CAN ALSO DETERMINE THE QUANTITY OF EACH LABEL TO BE PRINTED BY THE VALUE THAT IS INPUT ON EACH HEADER RECORD. THE ACTUAL INFORMATION THAT IS PRINTED IS INPUT ON A SERIES OF RECORDS THAT FOLLOWS EACH HEADER RECORD. BEFORE ANY LABELS ARE PRINTED, A FULL PAGE OF SETUP LABELS WILL BE PRINTED. 2.0 SAMPLE JCL ---------- 2.1 RUN JCL ------- //VWUTL530 JOB (XXXX,YYYY,,,,,,,0),'MAILING LABELS',CLASS=Q, // MSGCLASS=A,MSGLEVEL=(2,0) /*ROUTE PRINT RMTZZ //UTL530 EXEC UTL530 //PARMCARD DD * 3 /* //DATACRDS DD * 0 0405 1 NAME 2 ADDRESS 3 ADDRESS 4 ADDRESS 5 ADDRESS /* // SYMBOLIC DESCRIPTION ******************** REQUIRED - NONE OPTIONAL - FORM FORM NUMBER THE OUTPUT IS TO BE STORED UNDER. (DEFAULT=NLBL) (E.G. FORM=0333 FOR 3-UP) QUEUE QUEUE OUTPUT IS TO BE SPOOLED UNDER. (DEFAULT=J) (E.G. QUEUE='*') RUNTYPE INDICATES WHETHER OR NOT TO USE TEST OR PRODUCTION FILES. (DEFAULT=PROD) (E.G. RUNTYPE=TEST) 2.2 PARMCARD -------- UTL530 READS ONE REQUIRED PARMCARD THAT CONTAINS THE FOLLOWING INFORMATION: POS 1 - LABEL TYPE: 1 = ONE-UP LABELS 3 = THREE-UP LABELS 2.3 DATACRDS -------- UTL530 READS A SERIES OF 6 DATA RECORDS THAT CONTAIN THE INFORMATION TO BE PRINTED ON THE LABELS. THE FIRST RECORD IS A HEADER RECORD CONTAINING THE NUMBER OF LABELS TO BE PRINTED FOR THAT SERIES OF RECORDS. THE NEXT FIVE RECORDS CONTAIN THE ACTUAL LABEL INFORMATION. A. HEADER RECORD POS 1 LITERAL '0' POS 3 - 6 NUMBER OF LABELS TO BE PRINTED FOR THAT SERIES OF RECORDS. EX.: 0405 B. DATA RECORDS POS 1 LITERAL '1', '2', '3', '4', '5' POS 3 - 32 ADDRESS INFO 3.0 JOB SETUP INSTRUCTIONS ---------------------- SPECIAL FORMS QUEUE: QUEUE OF 'J' FORMS BUFFER: STANDARD (6-LPN) FOR ONE-UP, 8-LPN FOR THREE-UP ALIGNMENT INSTRUCTIONS: STANDARD PRINTED OUTPUT: MAILING LABELS FORMS TYPE: ONE-UP (NLBL) THREE-UP (0333) SPECIAL INSTRUCTIONS: N/A 4.0 SPECIAL OUTPUT MESSAGES: ----------------------- 1. 'NO PARM INPUT' 'UNABLE TO DETERMINE LABEL TYPE' THE ONE AND ONLY REQUIRED PARMCARD WAS NOT SUBMITTED. CREATE THE PARMCARD AND RESUBMIT. 2. 'INVALID LABEL TYPE' THE LABEL TYPE SUBMITTED WAS INCORRECT. IT MUST BE EITHER A '1' OR '3'. CORRECT AND RESUBMIT. 3. 'INVALID LABEL COUNT' THE LABEL COUNT ENTERED ON DATACARD WAS INVALID. IT MUST BE NUMBERIC AND GREATER THAN ZERO. CORRECT AND RESUBMIT. 5.0 PROGRAM CHANGE HISTORY: ---------------------- 5.1 VERSION NO: V3.1 (NEW PROGRAM) CHANGE DATE: N/A PROGRAMMER NAME: LAYNE WARREN PROGRAM CHANGE REQUEST NO: N/A DESCRIPTION OF CHANGE: N/A 5.2 VERSION NO: V3.4 CHANGE DATE: 10/30/87 PROGRAMMER NAME: JEAN MAYS PROGRAM CHANGE REQUEST NO: SCT-SR-334 DESCRIPTION OF CHANGE: MODIFIED JCL IN DOCUMENTATION TO SHOW EXEC STATEMENT AS: //UTL530 EXEC UTL530. CHANGED PROGRAM ID TO DESIGNATE A BATCH NON-UPDATE PROGRAM. RENAME FROM UTL050 TO UTL530. 5.3 VERSION NO: 4.20 CHANGE DATE: 02/15/91 PROGRAMMER NAME: PAM GUNN PROGRAM CHANGE REQUEST NO: 7184 DESCRIPTION OF CHANGE: 5.2 VERSION NO: V5.18 CHANGE DATE: 10/15/94 PROGRAMMER NAME: ANDREW HASLETT PROGRAM CHANGE REQUEST NO: 00014800 DESCRIPTION OF CHANGE: REVISED INPUT DATA CARD 1 TO PERMIT 9999 LABEL REQUESTS