There are 2 other files named srt4d.doc in the archive. Click here to see a list.
SRT4D.DOC -- Changes from SORT V4C(467) to V4D(530).
COPYRIGHT (C) 1985 BY
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.
ALL RIGHTS RESERVED
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
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT
DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
SRT4D.DOC Page 2
SRT4D.DOC -- Changes from SORT V4C(467) to V4D(530).
SORT is the high performance sort/merge package for the DECsystem-10.
SORT may be run as a stand-alone sort/merge, or embedded in a COBOL or
This release, SORT V4D(530), contains all published edits up to and
including edit 530 and fully replaces SORT V4C.
SORT runs under all supported monitors, and has been tested under
Tops-10 7.02 KL only.
See section 4 for details of how to rebuild SORT.
1.3 Software Dependencies
The internal COBOL-74 SORT requires version 12A or later of the
COBOL-74 object time system, C74LIB.REL, to reside on SYS:.
The internal FORTRAN SORT requires the FORTRAN library, FORLIB.REL, to
reside on SYS:.
1.4 Relevant Documentation
SORT is documented in the following manuals:
DECsystem-10 SORT/MERGE User's Guide, AA-0997D-TB
COBOL-74 Language Manual, AA-5059A-TK
DECsystem-10 FORTRAN Programmer's Reference Manual, AA-0944E-TB
These may be found in Software Notebooks 8, 9, 10, and 11.
SRT4D.DOC Page 3
2.0 EXTERNAL CHANGES
The following switches were added in V4C. They are not documented.
This switch tells SORT that BOTH the input and the output files are
fixed size ASCII records containing no carriage control characters.
/AFTER and /BEFORE
These switches tell SORT where the carriage-control characters go in
relation to the record. /AFTER is the normal way, /BEFORE is the
COBOL-74 compatible way. These switches affect output only as SORT
can read either format correctly and just ignore the extraneous
This switch specifies the maximum number of temporary files that can
be used during the SORT or MERGE.
3.0 KNOWN BUGS AND DEFICIENCIES
The following deficiencies are known:
1. SORT may give the message:
%SRTNCS Not enough core specified
when no /CORE switch or MEMORY SIZE clause was given. The sort should
proceed normally, however.
2. Though FORTRAN SORT's calling sequence is similar to stand-alone
SORT's, the following differences are known:
1. Continuation lines (in indirect files) are not allowed.
2. Indirect files must be on DSK: in the user's default
3. File extensions must be typed explicitly.
4. Switches must always follow file specifications to which
3. On VM systems, COBOL SORT destroys pages left around by MCS,
VMDDT, and the page fault handler when it reduces core after a sort.
The page fault handler is not affected too much, however, since it
will be brought in again if totally wiped out.
4. SORT and COBOL overlays do not always work together correctly.
SRT4D.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 distribution tape is written in BACKUP INTERCHANGE format and
contains the complete SORT/MERGE system. There are three save sets.
The save sets are:
The SORT-DOCUMENTATION save set contains the following files:
SORT.BD -- directory of SORT-BINARY save set
SORT.SD -- directory of SORT-SOURCE save set
SORT.RD -- directory of SORT-BUILD save set
SORT.HLP -- the HELP file for SORT
SRT4D.BWR -- the Beware file for SORT 4D
SRT4D.DOC -- the Doc file for SORT 4D
The SORT-SOURCE save set contains all the source files required to
The SORT-BUILD save set contains the Rel, Log, UNV files etc. from
the final build.
4.2 Instructions for Loading and Installing SORT
Mount the SORT or COBOL/SORT tape on logical MTA0: and type the
Then copy SORT.EXE to SYS: (or NEW:) and SORT.HLP to HLP:.
SRT4D.DOC Page 5
4.3 Instructions for Building SORT
Full building instructions for SORT can be found in SORT.CTL.
To simplify the build process all logical names required have been
placed in a file. If MIC were supported and worked under BATCH then
they would be in a MIC file SORT.MIC. However, this is not true so
that they are in a file called SORT.TEC. If BLDSRT.CTL is SUBMITTED
and the file SORT.TEC exists then BLDSRT runs TECO to modify SORT.CTL
by the contents of SORT.TEC to produce a new control file SORT.CTM
which it then SUBMITs, otherwise it just SUBMITs SORT.CTL. The user
should examine the file SORT.TEC and make appropriate changes.
To generate stand-alone SORT, load all of the SORT-SOURCE save set and
SORT.CTL and SORT.CMD from the SORT-BUILD save set into your
directory, modify SORT.TEC and type:
If LIBOL.REL, FTDEFS.UNV and METUNV.UNV are in your directory, a
COBOL-68 SORT will be built and inserted into LIBOL.REL.
If C74LIB.REL, FTDEFS.UNV and METUNV.UNV are in your directory, a
COBOL-74 SORT will be built and inserted into C74LIB.REL.
If FORLIB.REL is in your directory, a FORTRAN SORT will be built and
inserted into FORLIB.REL.
To build only a COBOL-68 SORT type:
To build only a COBOL-74 SORT type:
To build only a FORTRAN SORT type:
To build only a Virtual memory FORTRAN SORT type:
SRT4D.DOC Page 6
The following table contains the assembly switches, their default
value, location and intended use.
Assembly Default Defined Use when Switch has
Switch Value in module a non-zero value
FTOPS20 0 SRTPRM Build SORT for a DECSYSTEM-20
FTDEBUG 0 SRTPRM Debugging aids and additional info
FTCOBOL 1 SRTCBL Build SORT for COBOL
FTFORTRAN 0 SRTCBL Building COBOL, so turn off FORTRAN
FTFORTRAN 1 SRTFOR Build SORT for FORTRAN
FTCOBOL 0 SRTFOR Building FORTRAN, so turn off COBOL
FTVM 0 SRTPRM Build a Virtual Memory SORT for
5.0 INTERNAL CHANGES
The sources of SORT consist of:
SRTVER.MAC An optional file containing feature test switch settings.
SRTPRM.MAC The common parameter definitions
SRTSTA.MAC The common stand-alone code
SRTSCN.MAC The interface to SCAN
SRTUUO.MAC DECsystem-10 specific code
SRTCMP.MAC The comparison generator
SRTFLT.MAC The floating point code
SORT.MAC The common algorithms
In addition the COBOL SORT has:
SRTCBL.MAC The interface for COBOL
and the FORTRAN SORT has:
SRTCER.MAC Standard error message routines.
SRTFOR.MAC The non-V/M FORTRAN interface.
FORSRT.MAC The FORTRAN interface to the V/M FSORT.
The following edits were made to SORT as a result of bugs found:
472 Release core before returning to the calling program.
TOPS-10 COBOL and FORTRAN SORTs (except FSORT) do not
release the core they retained before returning to the
calling program. Make a CBC FUNCT. call for these cases.
Area Affected: CUTBAK in SORT.MAC
473 ?ILL MEM REF can occur when using FSORT.
SORT's data pages can fail to be created if the physical
core limit is reached. In this case, attempt to create
the page on disk. If this would exceed the users virtual
limit, give an error message.
SRT4D.DOC Page 7
474 Edit necessary when using FSORT with FORTRAN V6.
Change in initialization Procedure to set up stack
correctly for version 6 FORTRAN.
475 ?PC out of bounds
Edit to disallow the /HELP switch when called from
476 TOPS20 FORTRAN SORT does not resolve the address of the
passed argument correctly since SORT now runs in section 5.
477 If a FILOP. fails, the wrong error code is sometimes typed.
This occurs on TOPS-10 only.
500 Various errors in collating sequence code.
The first word of a TOPS-10 collating sequence file is
missing. Numeric literals in a file fail. Excess code on
TOPS-20. No test for duplicate characters in file.
501 Illegal memory reference while outputing to a blocked file.
A test to determine if a BLT is necessary to clear some
locations was erroneous.
Routine> CLRBLK in SORT.MAC
502 If the PMAP% fails to map pages to the output file because
the users disk quota is exceeded or the disk is full, then
make the error message fatal (but continuable) again.
Routine> BADMAP in SRTJSS.MAC
503 A TOPS-10 FORTRAN SORT can go virtual when it shouldn't.
FOROTS V6 allocates some area, data and stack, above the
OTS. Fix the way SORT calculates the memory used, so that
it will include this area.
Routine> DEFCOR in SRTUUO.MAC
504 If a long command is given in a FORTRAN SORT(FSORT) call
which specifies the /COLLATE:FILE:file switch, the error
"?SCNUOP Unmatched open parenthesis" can occur.
SRT4D.DOC Page 8
Routine> COLEFS in SRTSCN.MAC
505 Modify the error message at VLDERR to give the full file
specification of the file that can't be written because
of the "quota exceeded or disk full" problem.
Routine> BADMAP in SRTJSS.MAC
506 Fix a bug which causes undeserved SCNDSI errors with
Routine> USRKEY in SRTSCN.MAC
507 ASCII files can have some bit 35's on after SORTing.
Clear the buffer used for records when allocating it.
Routines> RFMBFP and FMTBFP in SRTJSS.MAC
510 On TOPS-10, SORT can create output files with strange
attributes. Clear some locations in the ENTER block
for the output file.
Routine> STOPB in SRTSCN.MAC
511 Implement Unsigned Fortran Floating Point.
512 Fix problem with specifing /COLLATE:FILE:filnam/switch.
Can cause strange SCAN error messages.
513 Define the EXTEND instruction with an opdef so that
MACRO built for KI's will assemble SORT.
514 Fix Edit 511. An index AC was left off an instruction.
515 Fix FORTRAN callable SORT (not FSORT) so that an
indirect command file can be used on TOPS10.
516 Correct to edit 503 which was to fix FORTRAN
callable SORT goes virtual erroroneously.
SRT4D.DOC Page 9
517 Fix edit 506 which cleared a flag that was still needed.
520 Let temp files be written to an eratsz device.
521 Print out correct file name with warning from /CHECK.
522 Make PSH4T,POP4T external.
523 Fix PDL list overflow with an global stack pointer
524 Not applicable to 4C
525 Not applicable to 4C
526 Fixed SORT to prevent FORARG from getting stepped on
and thus preventing an Illegal memory reference.
527 Fix the error message routine to print the error code
530 Fix autopatch bad delivery of 526.
[End of SRT4C.DOC]