Trailing-Edge
-
PDP-10 Archives
-
decuslib20-05
-
decus/20-0137/mthmrg/mthmrg.doc
There are 2 other files named mthmrg.doc in the archive. Click here to see a list.
LIBRARY PROGRAM #3.4.1
CALLING NAME: MTHMRG
PREPARED BY: BERENICE HOUCHARD
PROGRAMMED BY: BERENICE HOUCHARD
APPROVED BY: JACK R. MEAGHER
DATE. OCTOBER, 1972
MATCH MERGE PROGRAM
1.0 GENERAL DESCRIPTION
THE MATCH MERGE PROGRAM UPDATES A DATA FILE WITH THE USER'S CHOSEN OPTION
ON A CERTAIN KEY WORD. THE FIVE OPTIONS AVAILABLE ARE: REPLACE, INSERT,
DELETE, MISMATCH AND MATCH.
A FILE IS UPDATED BY EITHER REPLACING, ADDING, DELETING A RECORD OR BY
CREATING MATCHED AND MISMATCHED FILES.
2.0 LIMITATIONS & REQUIREMENTS
1. TWO INPUT DATA FILES ARE REQUIRED:
(A) AN ORIGINAL DATA FILE TO BE UPDATED, AND
(B) AN UPDATING FILE.
2. THE INPUT FILES SHOULD BE ON THE USER'S AREA BEFORE EXECUTION
UNDER A FILENAME NOT MORE THAN SIX CHARACTERS LONG WITH OR
WITHOUT AN EXTENSION.
3. THERE IS NO LIMIT ON FILE SIZE.
4. PROGRAM GENERATES OUTPUT FILES AND AUTOMATICALLY ASSIGNS NAMES.
THE FILENAMES HAVE THE FORM ?N.DAT WHERE ? RANGES FROM A TO Z
AND N RANGES FROM 1 TO 3.
5. THE PROGRAM CAN BE REPEATED AT MOST 26 TIMES PER EXECUTION.
3.0 PROGRAM CAPABILITIES & OPTIONS
THE MATCH MERGE PROGRAM CAN BE PROCESSED BY BATCH OR TERMINAL. THE
PROGRAM IS IN CONVERSATIONAL MODE TO ALLOW INTERACTION WITH THE USER
ON TERMINAL JOBS.
3.1 PROGRAM OUTLINE
FOLLOWING IS AN OUTLINE OF THE PROGRAM OPTIONS. THE STATEMENTS LISTED
BELOW WILL BE TYPED OUT BY THE PROGRAM IN WHICH A RESPONSE IS IMPERATIVE
TO EACH LINE. ON BATCH JOB, MAKE UP ONE CARD FOR EACH APPROPRIATE STATEMENT.
ALL ENTRIES ON TERMINAL JOBS ARE TERMINATED BY A "<CR>".
LINE 1 ENTER INPUT DATA FILENAME--
ENTER NAME OF THE DATA FILE TO BE UPDATED. THIS NAME SHOULD BE AT MOST
SIX (6) CHARACTERS LONG WITH OR WITHOUT EXTENSION.
LINE 2 UPDATE FILENAME--
ENTER THE NAME OF THE UPDATING FILE. AGAIN, THIS NAME SHOULD BE AT
MOST SIX (6) CHARACTERS LONG WITH OR WITHOUT EXTENSION. EVIDENTLY,
ENTRIES FOR LINES 1 AND 2 CANNOT BE IDENTICAL.
LINE 3 ENTER OPTION (REPLACE, INSERT,DELETE,MISMATCH,MATCH)--
ENTER ONE OF THE ABOVE OPTIONS ENCLOSED IN PARENTHSES. THE FIRST
THREE OPTIONS ARE SELF-EXPLANATORY, AFILE IS UPDATED BY EITHER REPLACING,
INSERTING OR DELETING A SPECIFIC RECORD. IN THE LAST TWO OPTIONS,
RECORDS IN THE DATA FILE AND THE UPDATING FILE THAT DO NOT MATCH
WITH ONE ANOTHER ARE PLACED IN TWO DIFFERENT FILES. A THIRD FILE IS
GENERATED COMPRISING OF , IN THE CASE OF THE MATCH OPTION, RECORDS
PRESENT IN BOTH INPUT DATA FILES; AND IN THE CASE OF THE MISMATCH
OPTION, RECORDS FROM BOTH INPUT DATA FILES THAT DO NOT MATCH WITH ONE
ANOTHER.
LINE 4 KEY WORD LOCATED IN COLUMNS--FROM,TO--
ALL UPDATING IS BASED ON THE KEY WORD, EXAMPLE: STUDENT NUMBER, LAST
NAME OF A PERSON, CATALOG NUMBER. THE KEY WORD SHOULD APPEAR
IN THE SAME COLUMNS FOR EVERY RECORD OF BOTH INPUT DATA FILES. IT
CAN BE AT MOST 80 CHARACCTERS LONG.
IN THIS LINE INDICATE WHERE THE KEY WORD IS LOCATED BY ENTERING THE FIRST AND
LAST COLUMNS BETWEEN WHICH THE KEY WORD IS SITUATED. SEPARATE THE TWO NUMBERS BY A
COMMA.
LINE 5 END OF JOB, TYPE 1 TO CONTINUE OR 0 TO TERMINATE--
AT THIS STAGE, ONE UPDATING JOB IS DONE. THE USER HAS THE CHOICE OF
REPEATING THE PROCESS, IN THIS CASE ENTER A 1 AND PROCEED TO LINE 1
OR BRANCHING OUT OF THE PROGRAM, IN THIS CASE ENTER A 0.
3.2 PROGRAM OUTPUT
(1) A SUMMARY REPORT THAT COMES OUT ON THE TERMINAL ON TERMINAL
JOBS OR ON THE TRAILER SHEET ON BATCH JOBS.
(2) OUTPUT FILES
OUTPUT FILES HAVE THE FORM ?N.DAT, WHERE ? RANGES FROM A TO Z
CORRESPONDING TO THE ALLOWABLE 26 REPETITIONS PER EXECUTION AND
AND N RANGES FROM 1 TO 3 TO BE EXPLAINED BELOW:
TWO OUTPUT FILES WILL BE GENERATED WITH THE REPLACE, INSERT AND
DELETE OPTIONS. THE FIRST FILE, WHERE N=1, IS THE FINAL UPDATED
FILE. THE SECOND FILE, WITH N=2, CONSISTS OF ALL RECORDS IN THE
INPUT UPDATING FILE THAT ARE NOT USED. OBVIOUSLY, IN THE THE CASE
WHERE ALL THE RECORDS ARE USED, THE SECOND FILE WILL BE EMPTY.
THREE OUTPUT FILES WILL BE GENERATED WITH THE MISMATCH AND
MATCH OPTIONS. THE FIRST TWO FILES, WITH N=1 AND 2, COMPRISE
OF RECORDS FROM THE ORIGINAL DATA FILE AND THE UPDATING
FILE RESPECTIVELY THAT DO NOT MATCH WITH ONE ANOTHER. IN THE
CASE OF THE MISMATCH OPTION, THE THIRD FILE CONSISTS OF RECORDS
FROM BOTH INPUT DATA FILES THAT DO NOT MATCH WITH ONE ANOTHER.
IN THE CASE OF THE MATCH OPTION,THE THIRD FILE CONSISTS OF
RECORDS THAT ARE PRESENT IN BOTH INPUT DATA FILES. FOR
EXAMPLE, SUPPOSE TWO DATA FILES, DATA1.FIL AND DATA2.FIL
ARE TO BE UPDATED BY UP1.FIL AND UP2.FIL WITH OPTIONS DELETE
AND MATCH RESPECTIVELY. THEN, ASIDE FROM THE TWO SUMMARY REPORTS
FIVE (5) OUTPUT FILES WILL BE GENERATED; NAMELY A1.DAT, A2.DAT,
B1.DAT, B2.DAT, B3.DAT.
4.0 METHOD OF USE
PROCEDURE AND SET UP FOR TERMINAL AND BATCH JOBS DIFFER SLIGHTLY.
4.1 TERMINAL JOB
FOLLOWING A SUCCESSFUL LOGIN, IF THE USER NEEDS TO PUT THE DATA ON
THE DISK ENTER THE FOLLOWING LINES (DO NOT TYPE IN THE PERIODS AND
STARS I.E. . AND *):
.AS CDR<CR> ASSIGN CARD READER TO USER'S JOB
.R PIP MONITOR CONTROL INSTRUCTION
*DATA.DAT=CDR: THESE LINES IN ESSENCE ARE
*UP.DAT=CDR: 2*N NUMBER OF LINES WHERE
(A) N=# OF DATA FILES TO BE
BE CREATED AND UPDATED.
(B) THE NAMES DATA.DAT AND
UP.DAT ARE ARBITRARY,
*^C MONITOR CONTROL INSTRUCTION
.DEAS CDR<CR> DEASSIGN CARD READER
TO START PROGRAM EXECUTION, ENTER "R MTHMRG<CR>". INTERACTION BETWEEN
USER AND PROGRAM BEGINS AT THIS POINT. THE PROGRAM WILL TYPE OUT THE
STATEMENTS OUTLINED IN SECTION 3.1.
OUTPUT DISK FILES WILL HAVE <077> PROTECTION CODE, USER IS ADVISED TO
CHANGE THE PROTECTION CODE IF THE FILES ARE TO BE SAVED FOR FUTURE USE.
ONE WAY OF GIVING A HIGHER PROTECTION CODE WILL BE,
.PRO ??.DAT<155><CR>
4.1.1 SAMPLE TERMINAL RUN
CONSIDER A DATA FILE INI.DAT TO BE UPDATED BY UP.DAT. THE KEY WORD IS
LOCATED IN COLUMNS 1 TO 5. TWO OPTIONS ARE SELECTED USING THE SAME
INPUT FILES.
NOTE: EXCEPT FOR PROMPTINGS, <CR> AND ALL INFORMATION ON THE
SAME LINE WITH <CR> ARE ENTERED BY USER.
.R MTHMRG<CR>
ENTER INPUT DATA FILENAME--INI.DAT<CR>
UPDATE FILENAME--UP.DAT<CR>
ENTER OPTION (REPLACE,INSERT,DELETE,MISMATCH,MATCH)--REPLACE<CR>
KEY WORD LOCATED IN COLUMNS--FROM,TO--1,5<CR>
*****SUMMARY REPORT*****
TOTAL NUMBER OF RECORDS IN INPUT DATA FILES:
INI.DAT = 7
UP.DAT = 5
NUMBER OF RECORDS IN FINAL UPDATED FILE = 7
THIS FILE IS UNDER FILENAME A1.DAT
NUMBER OF RECORDS REPLACED = 2
NUMBER OF RECORDS IN UP.DAT NOT USED = 3
THIS FILE IS UNDER FILENAME A2.DAT
**************
END OF JOB, TYPE 1 TO CONTINUE OR 0 TO TERMINATE--1<CR>
ENTER INPUT DATA FILENAME--INI.DAT
UPDATE FILENAME--UP.DAT
ENTER OPTION (REPLACE,INSERT,DELETE,MISMATCH,MATCH)--MATCH<CR>
KEY WORD LOCATED IN COLUMNS--FROM,TO--1,5<CR>
*****SUMMARY REPORT*****
TOTAL NUMBER OF RECORDS IN INPUT DATA FILES:
INI.DAT = 7
UP.DAT = 5
NUMBER OF RECORDS MISMATCHED IN INI.DAT = 5
THIS FILE IS UNDER FILENAME B1.DAT
NUMBER OF RECORDS MISMATCHED IN UP.DAT = 3
THIS FILE IS UNDER FILENAME B2.DAT
TOTAL NUMBER OF RECORDS MATCHED = 2
THIS FILE IS UNDER FILENAME B3.DAT
**************
END OF JOB, TYPE 1 TO CONTINUE OR 0 TO TERMINATE--0<CR>
EXIT
.
FOR REFERENCE PURPOSES, FOLLOWING ARE THE INPUT AND OUTPUT FILES:
INPUT FILES
INI.DAT UP.DAT
12384AAAAAAA 11111KOKOKOK
29384KKKKKKK 28345UPUPUPU
98475IIIIIII 12384HUHUHUH
18273LLLLLLL 73849UIUIUIU
29389KKKKKKK 29381TYTYTYT
87645OOOOOOO
29381LLLLLLL
REPLACE OPTION OUTPUT FILES
A1.DAT A2.DAT
12384HUHUHUH 11111KOKOKOK
18273LLLLLLL 28345UPUPUPU
29381TYTYTYT 73849UIUIUIU
29384KKKKKKK
29389KKKKKKK
87645OOOOOOO
98475IIIIIII
MATCH OPTION
B1.DAT B2.DAT B3.DAT
18273LLLLLLL 11111KOKOKOK 12384AAAAAAA
29384KKKKKKK 28345UPUPUPU 29381LLLLLLL
29389KKKKKKK 73849UIUIUIU
87645OOOOOOO
98475IIIIIII
4.2 BATCH JOB
THE FOLLOWING IS A BATCH JOB SET UP: (EACH LINE REPRESENTS ONE
CARD, EACH CARD STARTING IN COLUMN 1; DO NOT INCLUDE THE COMMENTS AT THE
RIGHT. IGNORE $DECK TO $EOD IF DATA ARE ALREADY ON THE DISK.
COMMENTS
$JOB [#,#] JOB CARD; INSERT USER'S PROJECT
PROGRAMMER NUMBER WITHIN THE BRACKET
$PASSWORD ###### IN PLACE OF THE 6 #'S, PUT IN THE
PASSWORD.
$DECK FILE.EXT FILE.EXT IS A DUMMY NAME USED IN THIS
WRITEUP. THE USER IS EXPECTED TO
PROVIDE A UNIQUE NAME TO EACH DATA
FILE.
DO NOT USE ANY OF THE OUTPUT
FILE NAMES TO BE GENERATED BY THE
PROGRAM.
(DATA CARDS) INSERT THE DATA CARDS TO BE UPDATED
HERE
(REPEAT THE ABOVE 4 LINES AS MANY TIMES AS THERE ARE DATA FILES TO BE UPDATED.)
$EOD SIGNIFY THE END OF THE DATA DECKS.
.R MTHMRG START PROGRAM EXECUTION.
(RESPONSES TO LINES 1-5 IN
SECTION 3.1) USER'S RESPONSES.
.PRO ??.DAT<155> TO PROTECT OUTPUT FILES.
.Q ??.DAT/FI:AS IF YOU WANT A LISTING OF THE OUTPUT
FILES, USE THIS LINE OTHERWISE IGNORE IT.
***********************************************************************
IF YOU WANT A CARD DECK OF THE OUTPUT FILES, USE THE FOLLOWING
.PLEASE START THE CDP SPOOLER
.Q CDP:=??.DAT
***********************************************************************
(EOF) AN END-OF-FILE CARD