Trailing-Edge
-
PDP-10 Archives
-
BB-H506E-SM
-
sort/documentation/srt4d.doc
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).
September 1985
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
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.
SRT4D.DOC Page 2
SRT4D.DOC -- Changes from SORT V4C(467) to V4D(530).
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 embedded in a COBOL or
FORTRAN program.
This release, SORT V4D(530), contains all published edits up to and
including edit 530 and fully replaces SORT V4C.
1.2 Monitor
SORT runs under all supported monitors, and has been tested under
Release 6.1 of TOPS-20.
See section 4 for details of how to rebuild SORT.
1.3 Software Dependencies
SORT V4D requires release versions of MONSYM.UNV, MACSYM.UNV and, for
COBOL, MACREL.REL. These files are included on the tape.
The internal COBOL-74 SORT requires version 12A or later of the
COBOL-74 object time system, C74O12.EXE and 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-20 User's Guide, AA-4179B-TM
DECSYSTEM-20 SORT/MERGE User's Guide, AA-4186C-TM
COBOL-74 Language Manual AA-5059A-TK
FORTRAN Reference Manual, AA-4158B-TM
These may be found in Software Notebooks 1, 7, 8, and 9.
SRT4D.DOC Page 3
2.0 EXTERNAL CHANGES
The following switches were added in V4C. They are not documented.
/NOCRLF
This switch tells SORT that BOTH the input and the output files are
fixed size ASCII records containing no carriage control characters.
/AFTER-ADVANCING and /BEFORE-ADVANCING
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
cr-lfs.
/MAX-TEMP-FILES
This switch specifies the maximum number of temporary files that can
be used during the SORT or MERGE.
3.0 KNOWN BUGS AND DEFICIENCIES
.BR No known bugs or deficiencies.
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 DUMPER format and contains
the complete SORT/MERGE system. There are four save sets.
The save sets are:
1. SORT-DOCUMENTATION
2. SORT-BINARY
3. SORT-SOURCE
4. SORT-BUILD
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-BINARY 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, 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
following commands:
DUMPER
TAPE MTA0:
REWIND
DENSITY 1600-BPI
SKIP 1
RESTORE <*>SORT.EXE <SUBSYS>*.*.-1,-
<*>SORT.HLP <SUBSYS>*.*.-1
REWIND
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 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 stand-alone 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
If LIBOL.REL, LIBSHR.REL, FTDEFS.UNV and METUNV.UNV are in
COBOL-68-BUILD:, a COBOL-68 SORT will be built and inserted into
LIBO12.EXE and LIBOL.REL.
If C74LIB.REL, C74SHR.REL, FTDEFS.UNV and METUNV.UNV are in
COBOL-74-BUILD:, a COBOL-74 SORT will be built and inserted into
C74O12.EXE and C74LIB.REL.
If FORLIB.REL is in SORT-BUILD:, a FORTRAN SORT will be built and
inserted into FORLIB.REL.
To build only a COBOL-68 SORT type:
SUBMIT SORT/TIME:0:20:00/TAG:COBOL
To build only a COBOL-74 SORT type:
SUBMIT SORT/TIME:0:20:00/TAG:CBL74
To build only a FORTRAN SORT type:
SUBMIT SORT/TIME:0:20:00/TAG:FORTRA
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 1 SRTPRM Build SORT for a DECSYSTEM-20
FTDEBUG 0 SRTPRM Debugging aids and additional info
FTCOBOL 1 SRTCBL Build SORT for COBOL
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
SRTCMD.MAC The DECSYSTEM-20 command scanner
SRTJSS.MAC DECSYSTEM-20 specific code
SRTCER.MAC Standard error message routines
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:
FORSRT.MAC The FORTRAN interface to the stand-alone SORT.
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
GCS,24-Nov-81,SPR:10-31747
A:SRC SRTPRM.MAC,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.
GCS,9-Dec-81,SPR:10-31774
A:SRC SRTPRM.MAC,SRTSTA.MAC
474 Edit necessary when using FSORT with FORTRAN V6.
Change in initialization Procedure to set up stack
correctly for version 6 FORTRAN.
ERD,14-Dec-81,SPR:none
A:SRC SRTPRM.MAC,SRTSTA.MAC
SRT4D.DOC Page 7
475 ?PC out of bounds
Edit to disallow the /HELP switch when called from
FORTRAN programs.
ERD,15-Dec-81,SPR:10-31773
A:SRC SRTPRM.MAC,SRTSTA.MAC
476 TOPS20 FORTRAN SORT does not resolve the address of the
passed argument correctly since SORT now runs in section 5.
GCS,18-Jan-82,SPR:20-17008
A:SRC SRTPRM.MAC,SRTSTA.MAC,SRTCMD.MAC
477 If a FILOP. fails, the wrong error code is sometimes typed.
This occurs on TOPS-10 only.
GCS,18-Feb-82,SPR:10-32102
A:SRC SRTPRM.MAC,SRTUUO.MAC
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.
GCS,13-Apr-82,SPR:None
A:SRC SRTPRM.MAC,SRTSTA.MAC,SRTSCN.MAC,SRTJSS.MAC,SRTCER.MAC
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
GCS,19-May-82,SPR:20-17636
A:SRC SRTPRM.MAC,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
GCS,27-May-82,SPR:20-17679
A:SRC SRTPRM.MAC,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
GCS,24-Jun-82,SPR:10-32586
A:SRC SRTPRM.MAC,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.
Routine> COLEFS in SRTSCN.MAC
GCS,8-Jul-82,SPR:10-32622
A:SRC SRTPRM.MAC,SRTSCN.MAC
505 Modify the error message at VLDERR to give the full file
specification of the file that can't be written because
SRT4D.DOC Page 8
of the "quota exceeded or disk full" problem.
Routine> BADMAP in SRTJSS.MAC
GCS,20-Aug-82,SPR:20-18079
A:SRC SRTPRM.MAC,SRTJSS.MAC
506 Fix a bug which causes undeserved SCNDSI errors with
SCAN V7D.
Routine> USRKEY in SRTSCN.MAC
PY,13-Sep-82,SPR:10-32945
A:SRC SRTPRM.MAC,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
GCS,7-Oct-82,SPR:20-17867
A:SRC SRTPRM.MAC,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
GCS,25-Oct-82,SPR:10-32840
A:SRC SRTPRM.MAC,SRTSCN.MAC
511 Implement Unsigned Fortran Floating Point.
DMN,27-Oct-82,SPR:20-18055
A:SRC SRTPRM,SRTSTA,SRTCMP,SRTFLT,SRTCMD
512 Fix problem with specifing /COLLATE:FILE:filnam/switch.
Can cause strange SCAN error messages.
GCS,1-Nov-82,SPR:10-32847
A:SRC SRTPRM,SRTSCN
513 Define the EXTEND instruction with an opdef so that
MACRO built for KI's will assemble SORT.
GCS,15-Dec-82,SPR:10-33259
A:SRC SRTPRM
514 Fix Edit 511. An index AC was left off an instruction.
GCS,21-Jan-83,SPR:10-33446
A:SRC SRTPRM,SRTSTA
515 Fix FORTRAN callable SORT (not FSORT) so that an
indirect command file can be used on TOPS10.
DMN,27-Feb-83,SPR:10-33532
A:SRC SRTPRM,SRTFOR
516 Correct to edit 503 which was to fix FORTRAN
callable SORT goes virtual erroroneously.
DMN,22-JUN-83,SPR:10-33678
A:SRC SRTPRM,SRTUUO
517 Fix edit 506 which cleared a flag that was still needed.
DMN,22-JUN-83,SPR:10-33671
A:SRC SRTPRM,SRTSCN
SRT4D.DOC Page 9
520 Let temp files be written to an eratsz device.
RLF,14-NOV-83,SPR:10-34174
A:SRC SRTUUO
521 Print out correct file name with warning from /CHECK.
RLF,14-NOV-83,SPR:10-34264
A:SRC SRTSTA
522 Make PSH4T,POP4T external.
RLF,12-DEC-83,SPR:NONE
A:SRC SRTSTA
523 Fix PDL list overflow with an global stack pointer
KWS,26-Jun-84,SPR:20-20212
A:SRC SRTSTA
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.
KWS,7-Dec-84,SPR:10-34974
A:SRC SRTSTA,SRTCMD,SRTPRM
527 Fix the error message routine to print the error code
correctly.
KWS,7-Dec-84,SPR:NONE
A:SRC SORT
530 Fix autopatch bad delivery of 526.
KWS,18-APR-85,SPR:NONE
A:SRC SRTPRM,SRTCMD
6.0 SUGGESTIONS
None.
[End of SRT4C.DOC]