Trailing-Edge
-
PDP-10 Archives
-
BB-Z759A-SM
-
documentation/srt5.doc
There are no other files named srt5.doc in the archive.
SRT5.DOC -- Changes from SORT V4C(467) to V5(517).
July 1983, July 1984
COPYRIGHT (C) 1983,1984 BY
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND 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. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY
TRANSFERRED.
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT
CORPORATION.
DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
SRT5.DOC Page 2
SRT5.DOC -- Changes from SORT V4C(467) to V5(517).
1.0 SUMMARY
1.1 Functions
SORT is the high performance sort/merge package for the DECSYSTEM-20.
SORT may be run as a stand-alone sort/merge, or called from a COBOL or
FORTRAN program.
This release, SORT V5(517), contains all published edits up to and
including edit 517 and fully replaces SORT V4C.
1.2 Monitor
SORT runs under monitor TOPS-20 V5.1 and later on KL Model B, and has
been tested under Release 5.1.
See SORTIN.MEM for details of how to rebuild SORT.
1.3 Software Dependencies
None.
1.4 Relevant Documentation
SORT is documented in the following manuals:
DECSYSTEM-20 User's Guide, AA-4179C-TM, AA-4179C-T1, AA-4179C-T2
DECSYSTEM-20 SORT/MERGE User's Guide, AA-M064A-TM
COBOL-74 Language Manual AA-5059B-TK
FORTRAN LANGUAGE Manual, AA-J127A-TK
These may be found in Software Notebooks 1, 16, 17, and 18.
SRT5.DOC Page 3
2.0 EXTERNAL CHANGES
There is now one and only one copy of SORT for stand-alone, COBOL or
FORTRAN use. The stand-alone SORT runs in section zero unless RMS
Version 2 files are being sorted, in that case it runs in section 1
with RMS in section 2.
The FORTRAN and COBOL SORT is the same EXE file running in the next
free section after section 1. A small part of the COBOL OTS then runs
in section 1.
RMS files can now be sorted on input and/or produced on output.
The sources of SORT have been split into a number of separately
compilable source modules. In general these are the same as the
previous modules which had to be compiled all at the same time. A few
routines were moved.
NOTE
Sorting of RMS files requires RMS
Version 2 because SORT assumes RMS is
running in a non-zero section. Please
refer to the RMS Version 2 DOC and BWR
files for additional information.
The sources of SORT consist of:
COPYRT.MAC The copyright
COPYRT.TXT The copyright text
FTDEFS.MAC The filetable definition
SORT.MAC The common algorithms
SRTCBL.MAC The interface for COBOL
SRTCER.MAC Standard error message routines
SRTCMD.MAC The DECSYSTEM-20 command scanner
SRTCMP.MAC The comparison generator
SRTFLT.MAC The floating point code
SRTFOR.MAC The interface for FORTRAN
SRTJSS.MAC DECSYSTEM-20 specific code
SRTPRM.MAC The common parameter definitions
SRTSTA.MAC The common stand-alone code
SORT.KEY The file for future use (autopatch)
3.0 KNOWN BUGS AND RESTRICTIONS
None.
SRT5.DOC Page 4
4.0 INSTALLATION INSTRUCTIONS
4.1 Contents of the SORT Distribution Tape.
For details of the combined COBOL/SORT tape see COBOL.INS.
The SORT only distribution tape is written in DUMPER format and
contains the complete SORT/MERGE system.
The save sets are:
1. SORT-DOCUMENTATION
2. SUBSYS
3. SORT-SOURCE
4. SORT-BUILD
5. FIELD-TEST (for field test distribution)
The SORT-DOCUMENTATION save set contains the following files:
SORT.BD -- directory of SUBSYS save set
SORT.SD -- directory of SORT-SOURCE save set
SORT.RD -- directory of SORT-BUILD save set
SORTIN.MEM -- the installation guide for SORT V5
SRT5.BWR -- the Beware file for SORT V5
SRT5.DOC -- the Doc file for SORT V5
The SUBSYS save set contains the files required to run SORT. These
files are normally kept on SYS:.
The SORT-SOURCE save set contains all the source files required to
build SORT.
The SORT-BUILD save set contains
the Rel, UNV files etc. from the final build.
The FIELD-TEST save set contains files required during field test.
SRT5.DOC Page 5
4.2 Instructions for Loading and Installing SORT
Mount the SORT or COBOL/SORT tape on logical MTA0: and type the
following commands:
DUMPER
TAPE MTA0:
REWIND
DENSITY 1600-BPI
SKIP 1
RESTORE <*>SORT.EXE (TO) <SUBSYS>*.*.-1,
<*>SORT.HLP (TO) <SUBSYS>*.*.-1
REWIND
4.3 Instructions for Building SORT
To simplify the build process, all logical names required have been
placed in a file called SORT.CMD. The user should examine this file
and make appropriate changes. The SORT command file SORT.CTL does a
TAKE of SORT.CMD to set up the logical name environment.
To generate SORT, load all of the SORT-SOURCE save set into
SORT-SOURCE, load SORT.CTL and SORT.CMD from the SORT-BUILD save set
into SORT-BUILD, modify SORT.CMD and type:
SUBMIT SORT/TIME:0:30:00
SRT5.DOC Page 6
5.0 INTERNAL CHANGES
The following edits were made to SORT v4C as a result of bugs found:
470 TOPS-10 only.
471 Edit to SORT 4B only, already in SORT 4C.
472 TOPS-10 only.
473 TOPS-10 only.
474 Mark the stack created by SORT with a "STOP!!" as expected by
Fortran v6.
475 TOPS-10 only.
476 SORT does not correctly load the address of the argument passed
by the Fortran caller when SORT is running in a non-zero section.
477 TOPS-10 only.
500 Fix illegal collating sequence problems.
501 Fix ill. mem. ref. caused by BLT 1 word too far.
502 Fix edit 457 to not give QUOTA EXCEEDED message to the operator.
503 TOPS-10 only.
504 TOPS-10 only.
505 Add the structure name to the QUOTA EXCEEDED message.
506 TOPS-10 only.
507 Make sure bit 35 is clear on ASCII files.
510 TOPS-10 only.
511 Implement Unsigned Fortran Floating Point.
512 TOPS-10 only.
513 TOPS-10 only.
514 Correct edit 511 to include index at USRFMT+13.
515 TOPS-10 only.
516 TOPS-10 only.
517 TOPS-10 only.
SRT5.DOC Page 7
6.0 SUGGESTIONS
None.
[End of SRT5.DOC]