Google
 

Trailing-Edge - PDP-10 Archives - decuslib10-10 - 43,50520/info.stp
There is 1 other file named info.stp in the archive. Click here to see a list.
			WESTERN MICHIGAN UNIVERSITY
			===========================


	Contents of STP Version 4 Distribution Package (16-FEB-81)
	============================================== ===========

    The magtape contains:

      (a) This document of implimentation information(INFO.STP).
      (b) The write-up of STP, which is in RUNOFF format(STP4.RNO).
      (c) The write-up of STP, which is the output from RUNOFF(STP.DOC).
      (d) The compiled and SAVed program of STP (STP.SAV,STPK4.CHN),
          created on a KL10  processor with Virtual Memory.
      (e) The FOROTS library for the SAVed program(FOR531.SHR).
      (f) Sources for Version number four of STP.(STP??.STP)
      (g) Two dummy files used when loading STP with LINK OVERLAY
          (CHAINB.F4,SIZE.F4).
      (h) Code to allow the use of OPEN/CLOSE statements  with  F-40 V26
          (F40OPN.TXT).
      (i) Subroutines(FORWMU.MAC) that are needed by STP, should you
	  wish to load STAT PACK with a modified copy of your FORLIB.
      (j) The  documentation  for  the   WMU   subroutines   to   FOROTS
          (FORLIB.MAN).
      (k) A file of source  compares  that  must  be  made  to FOROTS 4B
          (FORLIB.CFC).
      (l) Two libraries used when re-loading STAT PACK depending on your
          configuration(FORLKA.REL and FORLKI.REL).
      (m) The command file which is used to compile STP (STPV4.COM).
      Note:  This file will be deleted automatically when used  by  F-40
          so make sure you keep another copy around.
      (n) The command files which are  used  to  load  STP  with  LOADER
          (LOAD??.CMD).(CHAINB switch must be on)
      (o) The command files which are used to load STP with  LINK-10  V2
          (LINK??.LNK).(Requires OVERLAY option)
      (p) The BATCH control files to load and SAVe STAT PACK depending
          on your configuration(.CTL extension).
      (q) Replacement source files for Decsystem-20(STP.D20,STP3.D20).
      (r) Additional source file for Decsystem-20(EXPUNG.D20).
      (s) Command files for compiling and loading on Decsystem-20
	  (STPCOM.D20,STPLNK.D20).
      (t) Experimental batch control file for Decsystem-20 loading
	  (LNKCTL.D20).
      (u) The command file that is used to test the  program  using  the
          test data bank (STTST.CMD).
      (v) A test data bank (STTST.BNK).
         (v.1) A control file to generate STTST.BNK(STTST.CCL).
         (v.2) The data file to make STTST.BNK(STTST.INP).
      (w) An output file from the command file to  be  used  to  compare
          answers from our KL10 using FILCOM(STTST.FIL).
      (x) The LOADER version 57 used to load STP with CHAINB(LOADER.SHR).
      (y) The experimental queueing routines for GALAXY(QUEWMU.MAC).
      (z) A dummy file used when loading STP(USAG.F4).
		How to put STAT PACK on your Decsystem 10 or 20
		===============================================

A) If you have a KI or KL processor, virtual memory, and use MPB, you
   may use the SAVed version on the distribution tape(STP.SAV, STPK4.CHN,
   and FOR531.SHR).

    Note 1: FOR531.SHR must be put on SYS:.
    Note 2: STAT PACK may be put on any area you chose, subject to the
	    following rules:
		If STP.SAV(or .EXE) is accessed from one of the ERSATZ
		devices: OLD:[1,3], SYS:[1,4], STD:[1,4], NEW:[1,5],
			 or one of the specific areas: [1,4] or [1,5],
		then the CHAIN file STPK4.CHN will be searched for in
		OVL: and failing that in NEW: & SYS:.
 
		If STP.SAV(or .EXE) is kept in an area other than those
		above, or is found via a LIB: search, then STPK4.CHN
		will only  be searched for in that same area.

B) STP is designed for a KL-10, MPB system, however, if you have a
   Decsystem-10 or DEcsystem-20 and are using GALAXY, see Appendix 2
   for instructions on using an experimental version of a GALAXY-
   compatable queueing routine.

C) If you do not wish to use the experimental queueing routine and have a
   Decsystem-20, the modifications below, supplied by "The Association
   of American Railroads" may be tried. Western Michigan University
   can assume no responibility for thier completeness or correctness.

   (1) Put The files with a .D20 extension on disk and follow the
       instructions in C) below for loading: F10/LINK/KL-20.
   (2) AAR notes that after STP is linked, the .HGH and .LOW files
       generated must be converted to the Decsystem-20 .EXE format by
       the use of the CNVRT program. The program EXPUNG is used to clean
       up temporary files generated by STP. In addition it appears that
       PRINT and ASSIG commands to STP give output to the same file.

D) If your configuration does not fit the conditions of A) above,
   you must compile and load STAT PACK. Use the table below to decide
   which load procedure to use and what control files to use. Put on
   disk the control, library, and load files and STPV4.COM, CHAINB.F4,
   S.REL and all files with a .STP extension(20).

If you have:				Use:

COMPILER   LOADER	CPU	VM	CONTROL FILE	LIBRARY		LOAD COMMAND FILE
-----------------------------------------------------------------------------------------
F40	   LOADER	KA	NO	LOD40A.CTL	FORLKA.REL	LOADKA.CMD
F40	   LOADER	KI/KL	NO	LOD40I.CTL	FORLKI.REL	LOADKI.CMD
F40	   LOADER	KI/KL	YES	LOD40V.CTL	FORLKI.REL	LOADKI.CMD
F10	   LOADER	KA	NO	LOD10A.CTL	FORLKA.REL	LOADKA.CMD
F10	   LOADER	KI/KL	NO	LOD10I.CTL	FORLKI.REL	LOADKI.CMD
F10	   LOADER	KI/KL	YES	LOD10V.CTL	FORLKI.REL	LOADKI.CMD
F10	   LINK		KA	NO	LNK10A.CTL	FORLKA.REL	LINKKA.LNK
F10	   LINK		KI/KL	NO	LNK10I.CTL	FORLKI.REL	LINKKI.LNK
F10	   LINK		KI/KL	YES	LNK10V.CTL	FORLKI.REL	LINKVM.LNK
F10	   LINK		KL-20	---	LNKCTL.D20	FORLKI.REL	STPLNK.D20
		Loading and Operating Notes
		===========================


1)  LOADER-CHAINB:

     STAT PACK is distributed with LOADER-CHAINB because STP is so large
     it must be overlayed, and we realized not everyone has LINK-10 with
     the OVERLAY feature. Appendix 1 details the changes required to use
     CHAINB with STP. Sometimes CHAINB cannot be used if any of the
     MACRO sources are compiled with MACRO v52 or later.

2)  LINK/OVERLAY:

     When using LINK-OVERLAY, an excessively large number of commands
     to STP may exhaust the LINK-OVERLAY scratch area and cause a fatal
     error. This could result in loss of the output file when using
     "ASSIGN" as well as loss of the in-core data set.

3)  Testing STAT PACK:

     When running STP with the test set of data, you must answer "NO" to
     the  first  question,  then  type  @STTST.CMD, after "WHICH COMMAND"
     later STP will ask "ENTER DATA".  The required data is as follows:

     1,2,3
     4,5,6
     7,8,9
     ^Z

     Then it should run by itself to the finish. Use FILCOM to compare
     the answer file against STTST.FIL.

4)  Data Limits:

     STP is initially set at 700 data points, which with the program is
     about 24k, and will grow to about 36k with 8000 data points. Since
     STP is dynamically allocated, the user may specify any data size up
     to cormax. However, it is not recommended that STP be allowed to
     "go virtual", since STP will work against itself for a virtual job.

5)  Undocumented Commands:

        DISCR  -  Discriminate Analysis (type help to first question)
        FRIED  -  Friedman Two-way Analysis of Variance
        SIGN   -  Sign Test
        SIZE   -  Gives the size of each overlay
        SAVE   -  Does the same thing as "STORE"
        SYS    -  Exit and save (without printing) "ASSIGN"ed output

    In addition. there are three new experimental commands:
    (USE WITH CAUTION)

	ITEMA	-  Item Analysis
	SHADE	-  Shade plotting
	LATIN	-  Latin Squares statistics

     Although they are not documented there  should  be  no  problem  in
     using them.
			APPENDIX 1
			----------

Modifications of LOADER to use CHAINB with STP:

The following file comparision is based on WMU System Modification
#610.5(December 3 1973) LOADER version 57(151).

FILE 1)  DSKC:LOADER.MAC  CREATED:  0000  01-JUN-1973
FILE 2)  DSKB:LOADER.MAC  CREATED:  0933  26-OCT-1973

**************
1)2	IFNDEF SPCHN,<SPCHN==0>
1)	IFNDEF DIDAL,<DIDAL==1>
****
2)2	IFNDEF SPCHN,<SPCHN==1>
2)	IFNDEF DIDAL,<DIDAL==1>
**************
1)22		CAIG	Q,.JBHDA	;IS THERE ANY CODE LOADED THERE?
1)		SETZB	Q,HVAL		;NO, CLEAR ALL INDICATIONS OF IT
****
2)22	;NOCUT+		S.M. #610.5	NDG/ 10-12-73
2)		CAIGE	Q,.JBHDA	;ID THERE ANY CODE LOADED THERE?
2)		SETZB	Q,HVAL		;NO, CLEAR ALL INDICATIONS OF IT
**************
1)66		SKIPL	VSW		;USER DOESN'T WANT REENT OTS?
1)		TRNE	F,NOHI!SEGFL!SEENHI	;USER SET SEGMENT OR HI CODE SEEN?
****
2)66	IFE L,<
2)		SKIPL	VSW		;USER DOESN'T WANT REENT OTS?
2)		TRNE	F,NOHI!SEGFL!SEENHI	;USER SET SEGMENT OR HI CODE SEEN?
**************
1)84	ALGBLK:	SKIPE	OWNLNG		;FIRST TIME THIS PROG?
1)		JRST	ALGB1		;NO, JUST CHAINED SYMBOL INFO
1)		PUSHJ P,RWORD		;READ 3RD WORD
****
2)84	; ALGBLK	SPR 10-11,416 (10-15-73)		NDG/ 10-26-73
2)	;		TWO LINES DELETED
2)	ALGBLK:
2)		PUSHJ P,RWORD		;READ 3RD WORD
**************

			APPENDIX 2
			----------


Using STP with GALAXY
---------------------

The following procedure uses an experimental set of routines called
QUEWMU.MAC to allow STP to enter requests into the PRINT queue in
the manner described in the STP write-up while operating on systems
using GALAXY.

Procedure:

1) Put the following universal files on the area used to load STP:

	MACTEN
	UUOSYM
	QSRMAC
	SBSMAC
	MONSYS	(if Decsystem-20)


2) Generate FORPRM.UNV

	.R MACRO
	*=FORPRM.KI
	*<^Z>


3) Compile QUEWMU.MAC

	.R MACRO
	*QUEWMU=TTY:,DSK:QUEWMU.MAC
	FTGALAXY=1
	<^Z>
	FTGALAXY=1
	<^Z>
	*<^C>

4) Fudge QUEWMU.REL into FORLKI.REL 

	.R MAKLIB
	*FORLKI.REL=FORLKI.REL/MAS:(PRINTS,QUEOUT,SUBMIT,-
	*MISC.,QUEUES),QUEWMU.REL/REP:(PRINTS,QUEOUT,SUBMIT,-
	*MISC.,QUEUES)
	*FORLKI=FORLKI/NOLOCALS/INDEX

5) Load STP with instructions in section (D) of "How to Put STAT PACK
    on your Decsystem 10 or 20"