PDP-10 Archive: flx17.rnd from ap-c796e-sb

Trailing-Edge - PDP-10 Archives - ap-c796e-sb - flx17.rnd
There are no other files named flx17.rnd in the archive.
.;14-FEB-77-YL
\\
.LM0;.RM70;.F;.J;.FLAG CAP;.SP1;.TS5
<FILEX.DOC -- ^CHANGES FROM ^16 TO ^17(52)
.BR
^JUNE 1975
.FG30
^COPYRIGHT (^C) 1975,1977
.BR
^DIGITAL ^EQUIPMENT ^CORPORATION, ^MAYNARD, ^MASS.
.B 2
^THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE INCLUSION
OF THE ABOVE COPYRIGHT NOTICE. ^THIS SOFTWARE, OR ANY OTHER
COPIES THEREOF, MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE
TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH SYSTEM AND TO ONE WHO
AGREES TO THESE LICENSE TERMS. ^TITLE TO AND OWNERSHIP OF THE
SOFTWARE SHALL AT ALL TIMES REMAIN IN <DEC.
.B 1
^THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY ^DIGITAL
^EQUIPMENT ^CORPORATION.
.B 1
<DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY <DEC.
.T <FLX17.DOC
.PG
<FILEX.DOC -- ^CHANGES FROM ^16 TO ^17(52)
.BR
^JUNE 1975
.B3
1.0	<SUMMARY
.B1
^THIS RELEASE SUPPORTS <.EXE FORMAT SAVE FILES FOR
THE 6.02 MONITOR RELEASE. ^IT ALSO REWORKS THE </R LOGIC
TO ENABLE MORE CONSISTENT OPERATION. ^THE COMMAND SCANNING IS
STANDARDIZED INCLUDING SUPPORT FOR <SFD<'S AND DEFAULT PROJECT
AND PROGRAMMER NUMBERS. ^THE SOURCES HAVE BEEN CLEANED UP
AND REARRANGED INTO MANY SUBROUTINES. <FILEX IS NOW REENTRANT.
.B1
^THIS RELEASE RUNS ON ALL MONITORS SINCE 5.04 AND HAS
BEEN TESTED ON 5.07 AND 6.02. ^IT FULLY SUPERSEDES ALL
PREVIOUS VERSIONS. ^IT ANSWERS ALL <SPR<'S RECEIVED BEFORE
^JUNE, 1975.
.B1
<FILEX IS DOCUMENTED IN ^SOFTWARE ^NOTEBOOK 9.
.B3
2.0	<EXTERNAL <CHANGES
.B1
^NONE.
.B3
3.0	^^KNOWN BUGS AND DEFICIENCIES\\
.B1
^NONE.
.B3
4.0	^^INSTALLATION INSTRUCTIONS\\
.B1
^COMPILE WITH <C.UNV AND ^^JOBDAT.UNV\\ ON <UNV: AND
LOAD WITH <HELPER.REL ON <REL:. ^SSAVE AS A SHARABLE
PROGRAM AND PLACE <FILEX.SHR ON <SYS: TOGETHER WITH <FILEX.HLP ON
<HLP:. ^REMOVE THE OLD <FILEX.SAV.
.B3
5.0	^^INTERNAL CHANGES\\
.B1
^EDIT _#
.B1.LM7.TS7.I-7
11	^REMOVE THE SPECIAL LOGIC WHICH PUT A SPECIAL SET OF
PROTECTIONS ON FILES BEING WRITTEN TO <SYS:, SINCE THIS
LOGIC HAS BEEN IN THE MONITOR SINCE 5.03.
.B1.I-7
12	^REWORK THE </R LOGIC SO THAT THE <DEC<TAPE NEED
NOT BE MOUNTED. ^THIS DOES NOT CHANGE THE SPECIFICATION.
.B1.I-7
13	^INTERNALLY, CLEAN UP THE <I/O LOGIC TO BE CONSISTENT.
.B1.I-7
14	^CONVERT THE SOURCES TO USE <C.MAC.
.B1.I-7
15	^SUPPORT </P AND </R ON THE OUTPUT <DEC<TAPE. ^BOTH REUSE
THE SCRATCH FILE UNLESS THERE IS ALSO A </Z. </R SUPPRESSES THE
FINAL WRITE TO THE TAPE. ^THUS, ON OUTPUT, </Q WRITES A SCRATCH
AND COPIES IT TO TAPE; </P REUSES AN EXISTING SCRATCH AND WRITES
IT TO TAPE; AND </R REUSES AN EXISTING SCRATCH AND SAVES
IT FOR SUBSEQUENT COMMANDS WITHOUT ACCESSING THE TAPE. ^NOTE THAT
THIS EDIT TOGETHER WITH 12 MEAN THAT </R DOES NOT TOUCH THE
<DEC<TAPE.
.B1.I-7
16	^INTERNALLY REWORK THE </L LOGIC TO BE EASIER TO
FOLLOW THE CODE.
.B1.I-7
17	^DROP THE OBSOLETE USAGE OF __ AND 175 AND 176. ^THUS,
COMMANDS MUST BE SEPARATED BY =.
.B1.I-7
20	^MAKE REENTRANT AND CALL <HELPER TO PRINT THE HELP TEXT.
^MAKE THE HELP TEXT BE A SEPARATE FILE INSTEAD OF BEING BUILT IN.
.B1.I-7
21	^INTERNALLY, REFORMAT THE SOURCES WITH <PGRFMT TO
BE LINED UP CONSISTENTLY. ^CONVERT ALL MESSAGES TO BE UPPER AND
LOWER CASE.
.B1.I-7
22	^CHANGE THE <DEVPPN <UUO TO <PATH_. IN ORDER TO SUPPORT
ALL THE ERSATZ DEVICES.
.B1.I-7
23	^IMPLEMENT <SFD<'S. ^SUPPORT MISSING PROJECT
OR PROGRAMMER NUMBERS TO DEFAULT TO THE LOGGED IN DIRECTORY.
^ALLOW _< AND _> AS EQUIVALENT TO [ AND ].
.B1.I-7
24	^ALLOW </Z EVEN IF NO EQUAL SIGN. ^THUS, TO ZERO A TAPE,
JUST TYPE "^^TAPE:/Z\\".
.B1.I-7
25	^ON OUTPUT IF </Q OR IF THE <.XFO FILE IS ABSENT, ASSUME
</Z BY DEFAULT.
.B1.I-7
26	^IF </R, USE THE DEVICE AS THE TEMPORARY
FILE NAME AND USE <.DTA AS THE EXTENSION. ^THUS, THE USER CAN
KEEP SEVERAL PSEUDO <DEC<TAPES IN HIS DISK AREA AND REFERENCE
THEM BY NAME.
.B1.I-7
27	^MAKE ANY DEVICE SPECIFIED BE THE DEFAULT ON THE
REMAINING FILES SPECIFIED (INPUT SIDE ONLY). ^EXTEND THE SYNTAX
TO ALLOW A SECOND DEVICE IN THE SAME SPECIFICATION TO BE THE
SCRATCH FILE NAME IF </Q OR </R OR </P.
.B1.I-7
30	^ADD SUPPORT FOR <.HGH, <.SHR, AND <.EXE FILES. ^THE
COMPRESSED FILE FORMAT IS SPECIFIED BY </C AS BEFORE WITH
THE EXTENSION INDICATING WHICH FORMAT. ^THUS, <.EXE OR <.SHR
OR <.HGH WILL FORCE THE SPECIFIED FORMAT; ANY
OTHER EXTENSION WILL FORCE THE OLD COMPRESSED SAVE FILE FORMAT.
^IF CONVERTING FROM <.EXE TO <.HGH OR <.SHR, A <.LOW FILE
WILL ALSO BE CREATED IN EXACTLY THE CASE THAT THE MONITOR USED
TO (NAMELY IF THERE IS NON-ZERO LOW SEG DATA AFTER 140).
^IF CONVERTING FROM <.SHR OR <.HGH TO <.EXE, A <.LOW FILE
WILL BE READ ALSO IF THE MONITOR WOULD HAVE.
.B1.I-7
31	^SUPPORT THE DEVICE <NUL:.
.B1.I-7
32	^^PDP-11\\ DIRECTORIES WERE LISTED WRONG.
.B1.I-7
33	^^DTAX-/Q=A,B\\ DID WRITE A ZERO TAPE BUT FORGOT
TO ENTER A ZERO STRUCTURE.
.B1.I-7
34	^^DTAX:/Q/Z/L=A,B\\ TRIES TO LIST FROM A SCRATCH FILE WHICH
NO LONGER EXISTS USE INSTEAD THE REAL DECTAPE.
.B 1;.I -7
35	^^DSK:=DTAX:/Q\\ DOES NO LONGER WORK AS ^^READBZ\\ CLOBBERS ^^I/O\\ STATUS.
.B 1;.I -7
36	^^DTAX:/Q/L=FOO\\ WAS BROKEN FOR ^^PDP10\\ FILES.
.B 1;.I -7
37	^ALL TEN TO TEN TRANSFERS WITH DEVICES HAVING DIFFERENT
BUFFER SIZES DO NOT WORK.
.B 1;.I -7
40	^CHANGE ^^EXEFLG\\ DEFINITION TO A BLOCK 1 STATEMENT SO
NO LOW SEGMENT IS CREATED.
.B 1;.I -7
41	^CONVERSION FROM ^^SHR(HGH) _& LOW\\ TO ^^EXE\\ FORMAT DOES NOT
WORK WHEN THE SAVE FILES ^^IOWDS\\ DO NOT FILL UP THE LAST PAGES.
.B 1;.I -7
42	^^=DTA0:/L\\ USED TO LIST ONLY DIRECTORY NOW IT COPIES ALL
THE FILES ON THE TAPE CAUSING FILES TO DISAPPEAR.
.B 1;.I -7
43	^^DTA0:/L\\ WILL LIST THE DIRECTORY OF THE DECTAPE AND AFTER
SOME WAITING A FILE ^^DTA0\\ WILL BE IN THE DISK AREA.  ^THIS WAS INTRODUCED BY ^EDIT 42.
.B 1;.I -7
44	^^A.XPN=A.EXE\\ THE EXPANDED FILE CREATED WAS WRONG. ^THE FIRST
20 LOCATIONS ARE NON ZERO CAUSING GRIEF TO ^^FILDDT\\ E.G.
.B 1;.I -7
45	^^A.SAV=A.EXE\\ DID NOT WORK CORRECTLY.
.B 1;.I -7
46	^^A.EXE=A.SHR\\ DID NOT ALWAYS WORK CORRECTLY.
.B 1;.I-7
47	^THE EXPLICIT SPECIFICATION OF EXTENSIONS ON CONVERTING SAVE
FILES IS BOTHERSOME, THEREFORE THE FOLLOWING WAS DONE:
.B1
^CONVERSION OF SAVE FILES CAN BE DONE USING THE ^C SWITCH AND A BLANK INPUT
EXTENSION.  ^OLD SAVE FILE ARE FILES WITH EXTENSION ^^SHR HGH SAV\\ OR ^^LOW (OEX)\\.  ^NEW
SAVE FILES HAVE AN EXTENSION ^^EXE\\.  ^AS ^^LINK\\ PRODUCES OLD SAVE FILES
THE DEFAULT CONVERSION MODE IS FROM OLD TYPE SAVE FILES TO NEW TYPE SAVE FILES
ELSE AN EXPLICIT OUTPUT EXTENSION MUST BE USED TO FORCE THE CONVERSION TYPE.  ^NOTE
NO SCRATCH OUTPUT IS ACCEPTED.  ^EXAMPLES OF THE VARIOUS CONVERSION COMMANDS ARE:
.B 1;.LM 25;.TS 10,25;.I -22
1	^^A.EXE=A/C\\	^CONVERT OLD FORMAT SAVE FILE ^A TO ^^EXE\\ FORMAT.
.I -22
2	^^A=A/C\\	^IF ^A IS AN OLD SAVE FILE THEN CONVERT IT TO ^^EXE\\.  ^FORMAT
ELSE IF ^A IS AN ^^EXE\\ FORMAT FILE TEN TRANSFER IT TO THE OLD SAVE FILE FORMAT.
.I -22
3	^^A.OEX=A/C\\	^CONVERT ^^A.EXE\\ TO OLD SAVE FILE FORMAT.
.I -22
4	*=*/^C	^CONVERT ALL OLD SAVE FILES TO ^^EXE\\ FORMAT AND ALL
^^EXE\\ FILES FOR WHICH NO OLD SAVE FILE EXISTS.
.I -22
5	^^A:*=B:*/C\\	^IF ^^A EQL B\\ THEN AS (4) ELSE CONVERT ALL SAVE FILES.
.I -22
6	^^A:*.EXE=B:*/C\\	^CONVERT ALL OLD SAVE FORMAT FILES.
.I -22
7	^^A:*.OEX=B:*/C\\	^CONVERT ALL ^^EXE\\ FILES TO OLD SAVE FILE FORMAT.
.B 1;.LM 0
^IN CASE 2 A WARNING WILL BE GIVEN IF THE EXTENSION IMPLIED BY THE CONTENT OF
THE ^^EXE\\ FILE DIFFERS FROM THE SPECIFIED ONE ^^E.G.\\ ^^A.SHR=A/C\\ WHERE ^^A.HGH\\ WOULD BE GENERATED.
.B 1;.LM 7;.TS 7;.I -7
50	^CONVERSION OF ^^SHR\\ FILES TO ^^EXE\\ FILES WITHOUT A LOW
SEGMENT RESULTS IN ^^EXE\\ FILES, WHICH ON A RUN RESULT IN "#^^ILLEGAL MEMORY REFERENCE#"\\.
.B 1;.I -7
51	^CONVERSION OF AN ^^EXE\\ FILE TO A COMPRESSED FILE CAN CREATE A FILE,
WHICH GIVES THE ERROR MESSAGE "NOT A SAVE FILE" WHEN A GET OF THE SAVE FILE IS BEING DONE.
.B 1;.I -7
52	^FILES CREATED BY ^^FILEX\\ DO NOT CONTAIN THE CREATION TIME.
.B3.LM0
[^END OF <FLX17.DOC]