Google
 

Trailing-Edge - PDP-10 Archives - decus_20tap4_198111 - decus/20-0128/copymt.rnd
There are 2 other files named copymt.rnd in the archive. Click here to see a list.
.LOWER CASE.RIGHT MARGIN 72
.TITLE ^^COPYMT -- MAGNETIC TAPE COPIER (SON OF MAGCPY)\\ %7
.FIRST TITLE
.PARAGRAPH
^^COPYMT\\ IS A UTILITY PROGRAM TO COPY ONE MAGNETIC TAPE TO ANOTHER
WITH SIMPLE PROCESSING.  ^^COPYMT\\ REPLACES AND SUPERCEDES ^^MAGCPY\\
AND MAKES FULL USE OF THE NEW ^^TAPOP_. UUO\\ IN THE 6.02 AND LATER
MONITORS.
.PARAGRAPH
^THE GENERAL COMMAND FORMAT IS:
.BLANK 1
##########################^^ODEV:/SWITCHES=IDEV:/SWITCHES\\
.BLANK 1
^AVAILABLE SWITCHES:
.BLANK 1
.LIST 
.LE;/^^BACKSP\\:F:R
.BREAK
^BACKSPACE F FILES AND R RECORDS (SEE COMMAND NOTE 6)
.LE;/^^BUFSIZ:\\N
.BREAK
^USE A BUFFER SIZE OF N (DEFAULT=1024(10)).
.LE;/^^CLOSE\\
.BREAK
^TERMINATE LOG FILE OUTPUT IF IT WAS OPEN.
.LE;/^^COMMENT:"STRING-NO-DOUBLE-QUOTES .LE. 28. CHARACTERS"
.BREAK
^SEND THE STRING INSIDE QUOTES TO THE LOG FILE.  ^IF NO LOG FILE
IS BEING MADE, THE SWITCH IS A NOOP.
.LE;/^^CONCAT\\:F:R
.BREAK
^COPY F FILES AND R RECORDS, BUT DO NOT COPY ENDS-OF-FILES.  ^THE
ONLY WAY TO WRITE AN END-OF-FILE WITH /^^CONCAT\\ IS TO USE THE
/^^EOF\\ SWITCH (THIS ALSO TURNS OFF CONCATENATION MODE), OR BY
ENCOUNTERING THE LOGICAL END-OF-TAPE ON THE INPUT TAPE. (SEE COMMAND
NOTE 5)
.LE;/^^COPY\\:F:R
.BREAK
^COPY F FILES AND R RECORDS (SEE COMMAND NOTE 6)
.LE;/^^DENSITY:\\ARG
.BREAK
^SET THE MAGTAPE DENSITY TO ONE OF: 200 BPI (7-TRACK ONLY), 556 BPI
(7-TRACK ONLY), 800 BPI (DEFAULT FOR 7-TRACK, CAN BE USED ON 9-TRACK
ALSO), OR 1600 BPI (9-TRACK ONLY, DEFAULT ON 9-TRACK).
.LE;/^^EOF\\
.BREAK
^WRITE AN END-OF-FILE MARK.  ^THIS SWITCH MAY APPEAR ON THE INPUT
SIDE, BUT END-OF-FILE MARKERS ARE ALWAYS WRITTEN ON THE OUTPUT TAPE.
.LE;/^^ERROR:\\ARG
.BREAK
^CONTROLS WHAT HAPPENS WHEN THERE IS AN INPUT ERROR. ^^ARG\\ MAY BE ONE OF:
.LIST
.LE;^^CONTIN\\
.BREAK
^REPORT THE ERROR AND CONTINUE PROCESSING.
.LE;^^IGNORE\\
.BREAK
^DO NOT REPORT THE ERROR AND CONTINUE PROCESSING.
.LE;^^QUERY\\
.BREAK
^WHEN THERE IS AN ERROR, PROMPT THE TERMINAL FOR AN OPTION. ^SEE BELOW.
.END LIST
.LE;/^^IBUF:\\N
.BREAK
^USE N INPUT BUFFERS (DEFAULT=2).
.LE;/^^IFTYP\\
.BREAK
^ENABLE FOR TYPE-IN WHILE ^^COPYMT\\ IS PROCESSING COMMANDS.  ^THIS
SWITCH IS IGNORED IN BATCH JOBS.  ^LEGAL COMMANDS ARE:
.LIST
.LE;^E - ^GIVE ERROR TOTALS
.LE;^I - ^IGNORE FURTHER TYPE-IN (CANCEL /^^IFTYP\\).
.LE;^K - ^KILL PROCESSING, RETURN TO COMMAND MODE
.LE;^P - ^PAUSE AND WAIT FOR ANOTHER CHARACTER TO CONTINUE
.LE;^S - ^GIVE ELAPSED TIME AND CPU TIME USED
.END LIST
^ILLEGAL COMMANDS WILL BE ANSWERED WITH A BELL.
.LE;/^^LOG:DEV:FILE.EXT[P,PN]\\
.BREAK
^SETUP TO SEND ALL MESSAGES FROM ^^COPYMT\\ TO THE SPECIFIED LOG FILE
ALSO.  ^THIS SWITCH STICKS ACROSS DIFFERENT COMMANDS.  (I.E. YOU CAN
GIVE SEVERAL DIFFERENT COMMANDS AND THE LOG FILE WILL BE APPENDED TO
WITH EACH SUCCESSIVE COMMAND).  ^IF /^^LOG\\ IS GIVEN WITH NO FILE
SPECIFICATION, THE DEFAULT IS ^^DSK:COPYMT.LOG[-]\\.  (^IF PARTS OF
THE FILE SPECIFICATION ARE MISSING, THE MISSING PARTS ARE FILLED IN
FROM THE DEFAULTS.  ^THE LOG FILE IS OPENED AFTER THE WHOLE COMMAND
HAS BEEN SCANNED AND PROCESSING IS READY TO BEGIN.  ^ALL THE /^^CLOSE\\
SWITCH DOES IS CLEAR SOME FLAGS AND RE-ENABLE FOR ANOTHER /^^LOG\\
SWITCH.
.LE;/^^MODE:\\ARG
.BREAK
^SET THE MODE TO ONE OF:
.LIST
.LE;^^BINARY\\ (DEFAULT)
.BREAK
^THIS IS ^^DEC\\-COMPATIBLE CORE-DUMP MODE (WHATEVER THAT IS).  ^^BINARY\\
MODE IS THE MODE ALL MAGTAPES ARE WRITTEN IN ON THE ^^DEC\\-10 WHEN NO
OTHER SPECIAL MODE (SEE ^^INDUSTRY\\ AND ^^SEVENBIT\\ MODES)
IS USED.
.LE;^^INDUSTRY\\
.BREAK
^USE INDUSTRY-COMPATIBLE 8-BIT MODE.  ^THE LOWER 4 BITS OF EACH
WORD ARE IGNORED. 9-TRACK ONLY.
.LE;^^SEVENBIT\\
.BREAK
^THIS IS THE ^^TU70\\ "MARVELOUS ^^ASCII\\" MODE.  ^THIS MODE IS LEGAL
ONLY ON 9-TRACK ^^TU\\70 TAPE UNITS.
.END LIST
.LE;/^^NORETRY\\
.BREAK
^DISABLE MONITOR ERROR RETRIES. ^USE ON VERY BAD INPUT TAPES.  ^THIS ALSO
DISABLES /^^REPORT\\.  ^IF ERROR REPORTING IS DESIRED WITH /^^NORETRY\\,
YOU MUST ALSO SPECIFY /^^REPORT\\.
.LE;/^^OBUF:\\N
.BREAK
^USE N OUTPUT BUFFERS (DEFAULT=2).
.LE;/^^PARITY:\\ARG
.BREAK
^SET THE PARITY FOR THE TAPE UNIT TO: ^^ODD\\ (DEFAULT) OR ^^EVEN\\.
^NOTE THAT 9-TRACK TAPES ARE ALWAYS WRITTEN IN ODD PARITY.
.LE;/^^REPEAT:N\\
.BREAK
^USED ONLY WITH /^^TEST\\ OR /^^TAPTST\\ (SEE "^TAPE TESTING FACILITY").
/^^REPEAT\\ DIRECTS ^^COPYMT\\ TO TEST THE WHOLE TAPE ^N TIMES.  ^THIS
IS VERY USEFUL WITH TAPES THAT HAVE NOT BEEN EXERCISED IN A LONG TIME.
^NOTE THAT /^^REPEAT\\ HAS NO EFFECT IF /^^TEST\\ IS GIVEN AN ARGUMENT
IN THE COMMAND (TO ONLY TEST PART OF THE TAPE).
.LE;/^^REPORT\\
.BREAK
^THIS IS USED IN CONJUNCTION WITH /^^NORETRY\\.  ^UNLESS /^^REPORT\\ HAS
BEEN SPECIFIED WITH /^^NORETRY\\, INPUT ERRORS WILL NOT BE REPORTED
TO THE USER.
.LE;/^^RETRY:\\N
.BREAK
^WHEN TESTING A TAPE, PERFORM A MAXIMUM OF N RETRIES (DEFAULT=4) BEFORE
DECLARING THE SPOT TO BE BAD.
.LE;/^^REWIND\\
.BREAK
^REWIND THE TAPE UNIT.
.LE;/^^SKIP:\\F:R
.BREAK
^SKIP FORWARD F FILES AND R RECORDS (SEE COMMAND NOTE 6)
.LE;/^^TIME\\
.BREAK
^AT THE END OF A TAPE-TO-TAPE OR DISK-TAPE COPY, TYPE THE ELAPSED AND
CPU TIME USED.
.LE;/^^UNLOAD\\
.BREAK
^REWIND AND UNLOAD THE TAPE UNIT.
.END LIST
.PARAGRAPH
^SINCE ^^COPYMT\\ USES ^^SCAN\\, ALL STANDARD SWITCHES ARE ALSO AVAILABLE.
^TYPE /^^HELP:SWITCHES\\ FOR A LIST OF THE STANDARD SWITCHES.
.PARAGRAPH
^ALL SWITCHES EXCEPT /^^BUFSIZ, /ERROR, /IBUF, /MODE, /NORETRY, /OBUF,
\\AND /^^REPORT\\ ARE EXECUTED IN THE ORDER THEY ARE GIVEN IN THE COMMAND
STRING.
.NOJUSTIFY.NOFILL.BLANK 1
EXAMPLE:
.BLANK 1
##############^^MTA1:/SKIP:3=MTA2:/COPY:3:0/SKIP:1/CONCAT:2:0\\
.BLANK 1
.FILL.JUSTIFY.PARAGRAPH
^THE ABOVE COMMAND WOULD SKIP 3 RECORDS ON THE OUTPUT TAPE, COPY 3
FILES FROM THE INPUT TO THE OUTPUT TAPE, SKIP 1 RECORD ON THE INPUT
TAPE, AND THEN CONCATENATE THE NEXT TWO FILES FROM THE INPUT TAPE
INTO ONE FILE ON THE OUTPUT TAPE.
.PAGE
.CENTER;^^COMMAND NOTES\\
.LIST 1
.LE;^INPUT AND OUTPUT DEVICES MUST BE MAGTAPES AND MAY NOT BE THE
SAME PHYSICAL MAGTAPE.  ^AN EXTENSION TO THIS IS THAT IF EITHER THE
INPUT DEVICE OR THE OUTPUT DEVICE IS A DISK FILE, IT WILL BE READ(WRITTEN)
IN ^^IREAD\\ MODE.  ^ON TAPE, ^^IREAD\\ MODE IS ONE LOGICAL RECORD/PHYSICAL RECORD.
^ON THE DISK, A RECORD CONSISTS OF A WORD COUNT FOLLOWED BY THAT MANY
DATA WORDS.
.LE;^WHEN COPYING FROM DISK TO TAPE OR TAPE TO DISK, THE DEFAULT EXTENSION
IS .^^DAT\\.  ^TO GET A NULL EXTENSION YOU MUST TYPE THE DOT.
.LE;^IF NO COPY SWITCH (EITHER /^^COPY\\ OR /^^CONCAT\\) IS GIVEN, THE
WHOLE INPUT TAPE IS COPIED TO THE OUTPUT TAPE.
.LE;/^^COPY, /CONCAT\\ ARE ILLEGAL ON THE OUTPUT SPECIFICATION.
.LE;^AN END OF FILE IS NEVER WRITTEN WHEN /^^CONCAT\\ IS USED EXCEPT
AT COMMAND TERMINATION, OR WHEN /^^EOF\\ IS ENCOUNTERED.  ^NOTE THAT
/^^EOF\\ TERMINATES CONCATENATION MODE.
.LE;^TO SPECIFY THE NUMBER OF FILES WITH /^^BACKSP, /COPY, /CONCAT,\\AND
/^^SKIP\\, YOU MUST SPECIFY THE NUMBER OF RECORDS ALSO. (^I.^E. /^^BACKSP:3\\
MEANS BACKSPACE 3 RECORDS AND /^^BACKSP:3:0\\ MEANS BACKSPACE 3 FILES.)
.LE;^^COPYMT\\ WILL ALSO SCAN ^^SWITCH.INI\\ FOR APPLICABLE SWITCHES.
^ALLOWABLE SWITCHES ARE /^^BUFSIZ, /ERROR, /IBUF, /IFTYP, /TIME, \\AND
 /^^OBUF\\.  ^THIS
IS DEPENDENT ON FEATURE TEST SWITCH ^^FT$OPT=-1\\ AT ASSEMBLY TIME
(DEFAULT).  ^SEE APPENDIX ^A FOR A SHORT DESCRIPTION OF ^^SWITCH.INI\\.
.END LIST
.BLANK 1
.CENTER;^^OPTIONS FOR /ERROR:QUERY\\
.PARAGRAPH
^WHEN THERE IS AN ERROR ON THE INPUT TAPE, AND /^^ERROR:QUERY\\ HAS BEEN
SPECIFIED, THE USER HAS SEVERAL OPTIONS AVAILABLE:
.BREAK
.LIST 1
.LE;^C - COPY THIS RECORD (^I.^E. RECORD IN ERROR) AND CONTINUE
.LE;^D - DUMP RECORD IN ERROR TO ^^LPT:COPYMT.LPT\\ AND ASK AGAIN.
.LE;^E - EXIT NOW. IF YOU TYPE ^^CONTINUE\\ TO THE MONITOR, YOU WILL
BE ASKED AGAIN FOR AN OPTION.
.LE;^G - SAME AS "^C", AND CHANGE /^^ERROR:QUERY\\ TO /^^ERROR:CONTINUE\\.
.LE;^H - TYPE HELP MESSAGE
.LE;^S - SKIP THIS RECORD (DON'T SEND TO OUTPUT TAPE) AND CONTINUE.
.END LIST
.CENTER;^^OUTPUT TAPE END-OF-TAPE HANDLING\\
.PARAGRAPH
^WHEN ^^COPYMT\\ ENCOUNTERS AND END-OF-TAPE ON THE OUTPUT TAPE, A DOUBLE
END-OF-FILE IS WRITTEN, AND THE USER IS ASKED FOR AN OPTION.  ^AVAILABLE
OPTIONS INCLUDE:
.LIST 1
.LE;^C - CONTINUE (ASSUMES A NEW TAPE HAS BEEN MOUNTED).
.LE;^E - EXIT. ^A CONTINUE WILL AGAIN ASK FOR AN OPTION.
.LE;^H - TYPE SOME HELP ON THE TERMINAL.
.LE;^R - REWIND THE OUTPUT TAPE (SEE NOTE BELOW)
.LE;^U - REWIND AND UNLOAD THE OUTPUT TAPE (SEE NOTE BELOW)
.END LIST
.NOTE
^OPTIONS "^R" AND "^U" WILL AGAIN ASK FOR AN OPTION AFTER THE ACTION
HAS BEEN PERFORMED.
.END NOTE
.CENTER;^^COPYMT-BATCH JOB INTERACTION\\
.PARAGRAPH
^WHEN ^^COPYMT\\ IS USED IN BATCH, IT WILL INTERACT WITH THE OPERATOR
UNDER CERTAIN CONDITIONS.  ^CURRENTLY, THE ONLY IMPLEMENTED CONDITION
IS OUTPUT END-OF-TAPE.  ^TO ENABLE BATCH TO USE THIS FACILITY, YOU
MUST INCLUDE THE LINE ".^^OPERATOR\\" IN YOUR BATCH CONTROL FILE
BEFORE ^^COPYMT\\ IS RUN.  ^THEN, ANY MESSAGES THAT REQUIRE OPERATOR
INTERACTION WILL BE SEEN ON THE ^^CTY\\ AND THE OPERATOR WILL BE ABLE
TO HANDLE THE CONDITION BY REPLYING AS OUTLINED ABOVE.
.PARAGRAPH
^TO REPLY TO A BATCH JOB THAT HAS ENTERED DIALOG MODE, THE OPERATOR
MUST TYPE:
.BREAK
############"^B_<SJOB_#_>-^^OPERATOR\\ _<LINE_>_<CR_>"
.BREAK
WHERE _<SJOB_#_> IS THE SUBJOB NUMBER ASSIGNED BY THE BATCH CONTROLLER
AND TYPED OUT ON ALL MESSAGES TO THE OPERATOR, _<LINE_> IS THE LINE
OF TEXT TO SEND TO THE BATCH JOB, AND _<CR_> IS A CARRIAGE RETURN.
.PAGE
.CENTER; ^^TAPE TESTING FACILITY\\
.PARAGRAPH
^A TAPE TESTING FACILITY ALSO EXISTS IN ^^COPYMT\\.  ^THIS CODE IS
UNDER THE ASSEMBLY-TIME SWITCH ^^FT$TST\\ (NORMALLY ON).  ^THIS ALLOWS
YOU TO TEST YOUR TAPES BY WRITING ALL ONES WITH THE MONITOR ERROR-CORRECTION
DISABLED, SO ALL BAD SPOTS WILL BE SEEN BY THE PROGRAM.  ^IT IS BELIEVED
THAT THE VERIFICATION FEATURE IS NOT NEEDED, AND A SIMPLE ^^FORTRAN\\
PROGRAM CAN DUPLICATE THIS FEATURE IF DESIRED.
.PARAGRAPH
^TO USE THE TAPE TESTING FEATURE THE COMMAND IS:
.BREAK.BLANK 1
##########^^TAPNAM:/TAPTST\\
.BREAK
######OR:#^^TAPNAM:/TEST\\
.BREAK
######OR:#^^/TEST\\#####(ATTEMPTS TO USE LOGICAL DEVICE "^^TAPTST\\")
.BREAK
.PARAGRAPH
^THE ONLY OTHER SWITCHES THAT MAY BE APPLIED TO THIS COMMAND ARE /^^REPEAT\\,
/^^DENSITY\\ AND /^^PARITY\\.  ^^COPYMT\\ WILL TEST ANY TAPE AT
ANY DENSITY AND CORRECTLY REPORT THE LENGTH OF THE TAPE, AS WELL
AS THE BAD SPOTS AND THE TOTAL NUMBER OF ERRORS.  ^USE OF THE /^^REPEAT:N\\
SWITCH PERMITS YOU TO TEST THE TAPE ^N TIMES (VERY USEFUL WITH OLD TAPES).
.PARAGRAPH
^IN ADDITION, IF A NUMBER IS SPECIFIED WITH /^^TEST\\ OR /^^TAPTST\\,
THEN ^^COPYMT\\ WILL ONLY TEST THAT NUMBER OF RECORDS, AND WILL NOT
REWIND THE TAPE.  ^THIS IS USEFUL IF YOU WISH TO STRIP SOME TAPE OFF
THE BEGINNING  (^I.^E. /^^TEST\\:20 WOULD TEST 20 FEET OF TAPE AND
THEN QUIT).
.BLANK 2
.CENTER; ^^MTAPE MONITOR COMMAND\\
.PARAGRAPH
^IF ^^COPYMT\\ IS ASSEMBLED WITH ^^FT$MTP=-1\\ (DEFAULT), THEN
THERE IS A MONITOR COMMAND ^^MTAPE\\ AVAILABLE.  ^THE COMMAND FORMAT
IS:
.BREAK.BLANK 1
##################.^^MTAPE MTA:/S\\
.BREAK.BLANK1
WHERE /^S IS ONE OF /^^BACKSP, /EOF, /SKIP, /REWIND, \\OR /^^UNLOAD\\.
^A COMMAND MAY CONTAIN SEVERAL SWITCHES:
.BLANK 1
##################.^^MTAPE MTA:/REW/SKIP:100\\
.BLANK 1
^THIS WOULD REWIND THE TAPE UNIT AND THEN SKIP 100 RECORDS FORWARD.
.PAGE
.CENTER;^^COPYMT MESSAGES\\
.BLANK 1
^ERROR MESSAGES:
.LIST
.LE;^^?CMTBTS MTA BUFFER TOO SMALL FOR RECORD SIZE = \\N
.BREAK
^^COPYMT\\ HAS ENCOUNTERED A RECORD TOO LARGE TO FIT IN THE
MAGTAPE BUFFER WHEN COPYING FROM DISK TO TAPE.  ^THE COPY IS
ABORTED.  ^YOU SHOULD RESPECIFY THE COMMAND WITH A LARGER /^^BUFSIZ\\.
.LE;^^?CMTCER COMMAND ERROR\\
.BREAK
^THE COMMAND DID NOT CONTAIN ANYTHING DECIPHERABLE.
.LE;^^?CMTCGH CAN'T GET HIGH SEGMENT\\
.BREAK
^^COPYMT\\ COULD NOT FIND ITS HIGH SEGMENT.  ^THIS MESSAGE IS NOT
EXPECTED TO OCCUR.  ^PLEASE SHOW THE TERMINAL SESSION TO THE MAINTAINER.
.LE;^^?CMTCOD CAN'T OPEN DEVICE, FILE\\ DEV:FILE.EXT
.BREAK
^THE ^^OPEN\\ FOR THE SPECIFIED DEVICE FAILED.  ^IT IS PROBABLY UNAVAILABLE
TO YOU.
.LE;^^?CMTDIF DSK IS FULL -- ABORTING\\
.BREAK
^THIS MESSAGE MAY OCCUR WHEN COPYING FROM MAGTAPE TO DISK IF YOU
GO OVER YOUR LOGGED-IN QUOTA.
.LE;^^?CMTDNM DEVICE IS NOT A MAGTAPE - DEV\\
.BREAK
^THE SPECIFIED DEVICE IS NOT A MAGTAPE.
.LE;^^?CMTID7 ILLEGAL DENSITY FOR 7-TRACK\\
.BREAK
^THE ONLY LEGAL DENSITIES FOR 7-TRACK ARE /^^DENSITY:200,/DENSITY:556,
\\AND^^ /DENSITY:800.\\
.LE;^^?CMTID9 ILLEGAL DENSITY FOR 9-TRACK\\
.BREAK
/^^DENSITY:200\\ AND /^^DENSITY:556\\ ARE ILLEGAL FOR 9-TRACK MAGTAPES.
.LE;^^?CMTIM7 ILLEGAL MODE FOR 7-TRACK\\
.BREAK
^THE ONLY MODE LEGAL FOR 7-TRACK OPERATION IS /^^MODE:BINARY\\.
.LE;^^?CMTISO INPUT SWITCH ILLEGAL ON OUTPUT - SWITCH\\
.BREAK
^THE SPECIFIED SWITCH MAY APPEAR ONLY WITH INPUT SPECIFICATIONS.
.LE;^^?CMTLER LOOKUP/ENTER ERROR (N) FILE DEV:FILE.EXT\\
.BREAK
.LE;^^?CMTMNA MTA IS NOT AVAILABLE - MTA\\
.BREAK
^THE SPECIFIED MAGTAPE IS NOT AVAILABLE TO YOUR JOB.
.LE;^^?CMTOSI OUTPUT SWITCH ILLEGAL ON INPUT - SWITCH\\
.BREAK
^THE SPECIFIED SWITCH MAY ONLY APPEAR ON THE OUTPUT SPECIFICATION.
.END LIST
.PAGE
^WARNING MESSAGES:
.LIST
.LE;^^%CMTIOE I/O STATUS = XXXXXX (YYY) ON DEV:FILE.EXT - CONTINUING\\
.BREAK
^THE SPECIFIED ^I/^O ERROR HAS OCCURRED ON ^^DEV:FILE.EXT\\.  ^THE ^I/^O
ERROR BITS ARE ^^XXXXXX\\, WITH THE DECODING ^^YYY\\, WHICH MAY BE ONE
OR MORE OF:
.LIST
.LE;^^IMP\\
.BREAK
^THE TAPE IS WRITE-LOCKED.  ^^COPYMT\\ WILL WAIT FOR YOU TO WRITE-ENABLE
IT.  ^AT THE CURRENT TIME, RECOVERY IS NOT AVAILABLE, SO THE
JOB WILL BE ABORTED (TEMPORARY RESTRICTION).
.NOTE
^DUE TO HARDWARE RESTRICTIONS THE OPERATING SYSTEM HAS A VERY
HARD TIME TELLING IF THE ^^IBM\\ 729 TAPE UNITS ARE WRITE-LOCKED
OR NOT.  ^THEREFORE, YOU WILL PROBABLY NOT SEE THIS ON THE 729
TAPE UNITS.  ^RATHER, YOUR JOB WILL PROBABLY GO INTO ^^IO\\ WAIT,
AND EVENTUALLY YOU WILL GET A HUNG DEVICE.
.END NOTE
.LE;^^DER\\
.BREAK
^DEVICE ERROR -- DATA MISSED, TAPE IS BAD OR TRANSPORT IS HUNG.
.LE;^^PAR\\
.BREAK
^PARITY ERROR..
.LE;^^BKT\\
.BREAK
^BLOCK TOO LARGE -- YOU SHOULD RECOPY THE TAPE WITH A LARGER /^^BUFSIZ\\
VALUE.
.END LIST
.LE;^^%CMTIOT TOTAL OF \X \\YYYYYY^^ ERRORS\\
.BREAK
^THIS IS THE SUMMARY LINE OUTPUT AT THE END OF A COPY.  X IS THE TOTAL
NUMBER OF ERRORS SEEN ON YYYYYY (INPUT OR OUTPUT).
.END LIST
.BLANK 1
^INFORMATIVE MESSAGES:
.BREAK
.LIST
.LE;^^[CMTBKT BLOCK TOO LARGE ON INPUT--TRY LARGER /BUFSIZ]\\
.BREAK
^^COPYMT\\ HAS ENCOUNTERED A RECORD TOO LARGE TO FIT IN THE BUFFER, AND
WILL ASK YOU IF YOU WANT TO CONTINUE COPYING.  ^IF YOU ANSWER "Y", THE
COPY WILL CONTINUE, ELSE IT WILL BE ABORTED.  ^NOTE THAT THIS MESSAGE
AND THE CONTINUE QUESTION WILL NOT BE OUTPUT TO BATCH JOBS, BUT THE
^^%CMTIOE I/O STATUS\\ MESSAGE WILL.
.END LIST
.BLANK 1
^OPERATOR MESSAGES:
.BREAK
^THESE MESSAGES ARE ALSO SEEN BY THE OPERATOR IN A BATCH JOB IF ENABLED TO
DO SO (SEE NOTE ABOVE ON ^^COPYMT\\-BATCH INTERACTION).
.LIST
.LE;^^%CMTOTF OUTPUT TAPE IS FULL\\
.BREAK
^THE OUTPUT TAPE IS FULL.  ^YOU MUST MOUNT A NEW TAPE AND RESPOND WITH
THE "C" OPTION.
.END LIST
^TAPE TESTING MESSAGES:
.BREAK
^THESE MESSAGES MAY BE SEEN WHEN USING THE /^^TEST\\ (OR /^^TAPTST\\) SWITCH.
.LIST
.LE;^^%CMTFAR FAILED AFTER \N TRIES AT \M FEET\\
.BREAK
^^COPYMT\\ HAS TRIED N TIMES (ASSEMBLY TIME FEATURE=10.) TO WRITE
ON THE TAPE AT M FEET AND FAILED.  ^THIS SPOT IS PROBABLY UNUSABLE.
.LE;^^[CMTTNE TOTAL NUMBER OF ERRORS = \N]\\
.BREAK
^THIS MESSAGE IS OUTPUT AT THE END OF THE TEST AND IS A REPORT OF THE
TOTAL NUMBER OF ERRORS FOUND ON THE TAPE.
.LE;^^[CMTTLI TAPE LENGTH = \N]\\
.BREAK
^^COPYMT\\ WRITES ONE FOOT TAPE RECORDS, AND HAS FOUND THE LENGTH OF
THE TAPE TO BE N FEET.
.END LIST
.PAGE
.APPENDIX ^^A PRIMER IN SWITCH.INI\\
.PARAGRAPH
^^SWITCH.INI\\ IS AN OPTION FILE.  ^IT ALLOWS YOU TO PLACE YOUR FAVORITE
SWITCH SETTINGS IN A FILE WHICH IS AUTOMATICALLY READ (UNLESS DISABLED
BY /^^NOOPTION\\) BY SEVERAL ^^SYSTEM\\ PROGRAMS, ^^COPYMT\\ AMONG THEM.
.PARAGRAPH
^THE FORMAT OF A LINE IN ^^SWITCH.INI\\ IS:
.BREAK
^^PROGRAM(:OPTIONNAME) /SWITCH/SWITCH.../SWITCH
.PARAGRAPH
^A PROGRAM NAME MAY BE IN THE FILE MORE THAN ONE TIME, BY ADDING
AN ^^OPTIONNAME\\, PRECEDED BY A COLON, RIGHT AFTER THE PROGRAM NAME.
^THUS A TYPICAL ^^SWITCH.INI\\ FILE MIGHT BE:
.NOFILL.NOJUSTIFY.BLANK 1
.BREAK
^^LOGIN	/WIDTH:80/MESSAGE:NAMES/NORTCOM/PAGE/NOFORM
DIRECT	/WIDTH:80/OKNONE
DIRECT:WIDE	/WIDTH:132/OKNONE
COPYMT	/OBUF:6/IBUF:6/BUFSIZ:200
COPYMT:BIG	/OBUF:1/IBUF:1/BUFSIZ:4000
.FILL.JUSTIFY
.PARAGRAPH
^AFTER ^^COPYMT\\ (OR ANY OTHER PROGRAM WHICH SCANS THIS FILE) HAS
ACCEPTED A COMMAND FROM THE USER, ^^SWITCH.INI\\ WILL BE SCANNED, AND
ANY SWITCHES FOUND FOR THE PROGRAM WHICH HAVE NOT BEEN SET BY USER
COMMAND WILL BE APPLIED.  ^THUS, IF THE USER HAD A /^^BUFSIZ\\ SWITCH
IN HIS COMMAND, THE /^^BUFSIZ:200\\ IN ^^SWITCH.INI\\ WOULD NOT BE
APPLIED.
.PARAGRAPH
^IN ADDITION, ONE MAY SPECIFY THE DESIRED OPTION BY ADDING THE SWITCH "/^^OPTION:NAME\\"
TO THE COMMAND STRING (ANYWHERE SHOULD DO THE TRICK).  ^FOR INSTANCE, IF
YOU ADDED /^^OPTION:BIG\\ TO A ^^COPYMT\\ COMMAND STRING, THE LINE
BEGINNING WITH ^^COPYMT:BIG\\ WOULD BE SEARCHED FOR.  ^IF THE SPECIFED
OPTION IS NOT FOUND, A WARNING MESSAGE WILL BE ISSUED.
.PAGE
.APPENDIX ^^COPYMT INSTALLATION GUIDE\\
.LIST
.LE;^^COPYMT\\ MUST BE ASSEMBLED WITH ^^MACRO\\ %50 OR LATER.
.LE;^^COPYMT\\ USES ^^DEC\\-SUPPLIED UNIVERSAL FILES ^^JOBDAT, UUOSYM,
MACTEN,\\ AND ^^SCNMAC\\.
.LE;^^COPYMT\\ LOADS ^^REL:HELPER\\ AND REL:SCN7B\\.
.LE;^FEATURE TEST SWITCHES WHICH MAY SAFELY BE CHANGED ARE:
.LIST
.LE;^^FT$OPT\\ (DEFAULT=ON)
.BREAK
^IF THIS SWITCH IS ON, ^^SWITCH.INI\\ WILL BE READ AFTER A COMMAND
IS ACCEPTED FROM THE TERMINAL.
.LE;^^FT$TST\\ (DEFAULT=ON)
.BREAK
^IF THIS SWITCH IS ON, THE TAPE TESTING CODE WILL BE INCLUDED.
.LE;^^FT$MTP\\ (DEFAULT=ON)
.BREAK
^IF THIS SWITCH IS ON, ^^COPYMT\\ WILL HANDLE THE MONITOR COMMAND
^^MTAPE\\.  ^THIS REQUIRES A SMALL CHANGE TO THE MONITOR:
.BREAK
^IN ^^COMCON.MAC\\, INSERT "^^C MTAPE,RUNFLG,RUNCMT\\" INTO THE NAMES
MACRO SOMEWHERE.  ^SOMEWHERE CONVENIENT (AROUND RUNQUE) INSERT THE
FOLLOWING TWO LINES:
.BREAK
^^RUNCMT:	MOVE	P2,[SIXBIT/COPYMT/]
.BREAK
###########JRST	RUNAME\\
.BREAK
.END LIST
.END LIST
.BLANK 1
[END OF ^^COPYMT.DOC\\]