Trailing-Edge
-
PDP-10 Archives
-
BB-H580E-SB_1985
-
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-10.
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
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.
/NOCRLF
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
cr-lfs.
/MAXTEMP
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
path.
3. File extensions must be typed explicitly.
4. Switches must always follow file specifications to which
they apply.
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:
1. SORT-DOCUMENTATION
2. SORT-SOURCE
3. 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-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:
R BACKUP
TAPE MTA0:
REWIND
DENSITY 1600-BPI
RESTORE SORT.HLP
REWIND
SKIP 2
RESTORE SORT.EXE
REWIND
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:
SUBMIT BLDSRT
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:
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
To build only a Virtual memory FORTRAN SORT type:
SUBMIT SORT/TIME:0:20:00/TAG:FSORT
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
FORTRAN
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
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
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.
ERD,14-Dec-81,SPR:none
A:SRC SRTPRM.MAC,SRTSTA.MAC
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.
SRT4D.DOC Page 8
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
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.
SRT4D.DOC Page 9
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
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]