README.md
Miami, Spring 1981 - RSX/IAS SIG tape

The following are contributions from:

A.R.A.P.
Box 2229
Princeton, NJ 08540
Contact: John Leonard (609) 452-2950

System: IAS VS3.0, 11/70, RP06 based

[360,1] - READM4.DOC

[360,200] - ARAP.OLB, needed for all following software
Only new source modules included, but library contains
all modules from previous tapes also.

[360,212] - IAS/VAXNET - This is a simple-minded virtual terminal
program with the ability to send/receive ASCII files
between two IAS systems, or an IAS and a VAX system, over
asynchonous lines (DZ11 like devices). This originally
appeared on the VAX SIG tapes and was modified to work on
IAS as the host system. Simple yet effective. Refer to
NETBLD.CMD to build the two programs that run on the local
and remote systems. See also VAXNET70.CMD. MEMO11.RNO
describes the steps needed to actually transfer files.

[360,213] - UND - This program finds undefined variables in FORTRAN
programs. It subtasks to the FORTRAN compiler and uses
a /LI:2 listing file. It will report undefined variables,
variables appearing in subroutine calls that are not
explicitly defined, etc. Refer to UNDEF2.RNO, UNDEF1.RNO and
UNDMN.FTN for further instructions. UNDTEST.FTN is an example
test file for UND and UNDTEST.LST is the resultant output.

[360,214] - C36 - conditional fortran pre-processor
C36 is used by ARAP to convert fortran source to both
IBM and CDC machines and is specific to our operations.
However, C36 also has the ability to conditionally
include or exclude lines of code by using a logical
definition file and IF-THEN-ELSE types of constructs within
the code to be converted. It is not a process which needs to
be run before every compile. Rather, it lends to maintaining
a base line version of a program on a development machine,
while allowing easy conditional conversion for specific
exportation to other machines which require different
coding algorithms in selected places.
Refer to C36.RNO for documentation and also C36MN.FTN.

[360,215] - DSM from spring 1980 SIG tape - only updated modules included.
A couple of bugs have been fixed pertaining to disk drive
size recognition and maximum number of uic's checking.

DSX - Also included on this uic is a somewhat modified
version of DSM which is used to associate a specific
file to a given disk cylinder/track/sector address. This is
useful for finding the files in which disk errors occur.
Refer to DSX.RNO for further description and use.

[360,230] - SFS fortran cross-referencer from Spring 1979 SIG tape.
Fixed to identify VIRTUAL statement.
Only modified modules included.

[360,245] - SPY from fall 1979 - only updated modules included.
Bug fixed - problems when real time tasks alter priority
to below 100.

[ARAP.RUNOFF] ARAP modified Triangle RUNOFF. ARAP has added a number of
features to RUNOFF to enable us to produce technical reports.
We required support for greek characters, extended sub/super
script capability, ability to produce very complex
mathematical equations etc. I was unable to put together a
formal contribution of ARAP RUNOFF in time, but would like to
point out some of our extensions to anyone interested.
I might add that we have successfully been using RUNOFF in
conjunction with a screen editor to produce reports on a
production basis. Some of the features include:

a) Support for Greek/Math character set. Output is produced
on a DIABLO 1640 in two passes. Lines up amazingly well.
b) Super/subscripts adjustable in 1/8 line increments. Can
set to super/sub 3/8 line instead of 1/2 and change
amount througout document as needed.
c) Line spacing adjustable to 1/8 line (.SP) and also
.BLANK can use 1/8 spacing. e.g. .BLANK 1+5/8
d) Overbar function, implemented similar to underline.
Adjusts to highest superscipt to be overscored.
e) Equation mode command. Allows reasonable description
of equations, set spacing around equation, sets line
spacing (to 1/8), allows '#' to be horizontal half-space
for aligning 1 character above 2 (a/bc) for example.
f) Justified output uses a horizontal half-space to fill.
g) Overstrike ability using backspace, justifies properly.
h) String substitution definitions. Similar to the
numeric substituion, but allows strings within the text
to be identified and substituted for.
e.g .SUB ARAP = 'Aeronautical Research Associates of P'
Any occurence of ARAP within text will be substituted.

Please call me if your are interested in using RUNOFF for
this sort of work. I will be happy to send an example of
output, send a tape etc.

Included are the README.DOC files from previous contributions to the SIG tapes.
This will be ARAP's last active participation in the IAS/RSX SIG, as we move
on to the VAX SIG. If anyone is interested in a tape containing all ARAP
contributions, contact John Leonard (609) 452-2950, at the above address.



SPRING 1979, New Orleans

The following is a description of files contributed by:

AERONAUTICAL RESEARCH ASSOCIATES of PRINCETON (A.R.A.P.)
Box 2229, 50 Washington Road
Princeton, N.J. 08540
(609) 452-2950

Any inquiries should be directed to John D. (Len) Leonard.

A.R.A.P. configuration
11/70, 320kw, TU16, 3 RP06's
FORTRAN IV-PLUS is the default compiler (FOR) and all .FTN
files are F4P code and should be compiled as such.
Currently running IAS VS 3.0

All of the following files are on [360,*]. Note that
ARAP.OLB is needed for most all task builds. Also, on
[360,205] RENAME.CMD must be executed to rename some of the
files from 6 letters to 6+ letters.


[360,200]ARAP - Contains ARAP.OLB and associated source for
routines contained in ARAP.OLB. These routines
are of general interest. ARAP.FTN is a conca-
tenated source file of all .FTN modules.


[360,205] Indirect MCR procedures and PDS command procedures.

BACKUP.CMD - Automation of PRESERVE and DSC disk-disk weekly
backup procedures, uses VOLID.

INITIAL.CMD - Initialize disk, uses LBN.

NEWUSER.CMD - Create new PDS user, see also NEWUSER.MCR.

TARGETGEN.CMD - Generate system on user packs from master
system pack.

and for fun listings -

TUIT.LST - Now there is no excuse.

PSU.LST - Keep your Computer room on the lighter side.


[360,210]FDUMP - File dump, produce OCTAL-ASCII-RAD50 listings
a'la IBM 360. See FDUMP.FTN for doc and
FDUMP.CMD to build.

[360,210]LBN - Logical Block Number. Assists in pack initial-
ization and tracking of bad block data. See
LBN.RNO and LBN.CMD for build. See also
INITIAL.CMD.

[360,210]RESET - Reset 'blocks used' characteristic for locked
and aborted files, e.g., 0/106 used/allocated.
See RESET.FTN for doc and RESET.CMD to build.

[360,210]VOLID - Change volume ID, used at A.R.A.P. to correct
volume ID's destroyed by DSC. See VOLID.FTN for
doc and VOLID.CMD for build.

[360,210]WHOMM - Who's on the tape drive!!? Will need slight
modification for devices other than MM0:. See
WHOMM.MAC for doc and WHOMM.CMD to build. Note
that IASWHO.MAC on object distribution of IAS
3.0 also reports mounted volumes.

[360,210]F4PRES- Files needed to build 4k F4P resident library
used at A.R.A.P. See F4PRES.CMD for doc and
build. See also MEMO2.RNO for a discussion of
resident libraries in light of SYSRES and
F4PRES.

[360,220]BAN - Create user banner. Allows user to specify
banner headings. Used mostly for deferred
printing. See BAN.RNO and BANBLD.CMD to compile
and link. See also BANTST.CMD, the banner test
program. SAMPLE.BAN is an example of BAN out-
put.


[360,230]SFS - Search Fortran Source. Fortran variable
cross-reference provides list of variable and
routine reference, total variables and text
listing of statements where referenced. Global
cross references for up to 100 routines. See
SFS.RNO and SFSBLD.CMD to build. SAMPLE.SFS is
an example SFS listing. TEST01.SFS and
TEST02.SFS are sample SFS runs.


[360,240]SSD - SSD consists of the program SSD and FORTRAN
callable AST routines. SSD allows pseudo-sense
switches and data to be sent to a FORTRAN task,
permitting run-time control of time-sharing
tasks. See SSD.DOC for more detail and
SSDBLD.CMD to build.

FALL 1979, San Diego

The following is a description of files contributed by:

AERONAUTICAL RESEARCH ASSOCIATES of PRINCETON (A.R.A.P.)
Box 2229, 50 Washington Road
Princeton, N.J. 08540
(609) 452-2950

Any inquiries should be directed to John D. (Len) Leonard.

A.R.A.P. configuration
11/70, 320kw, TU16, 3 RP06's
FORTRAN IV-PLUS is the default compiler (FOR) and all .FTN
files are F4P code and should be compiled as such.
Currently running IAS VS 3.0

All of the following files are on [360,*]. Note that
ARAP.OLB is needed for most all task builds.


[360,200]ARAP - Contains ARAP.OLB and associated source for
routines contained in ARAP.OLB. These routines
are of general interest. ARAP.FTN is a conca-
tenated source file of all .FTN modules.

This copy of ARAP.OLB supercedes the copy on the
New Orleans SIG tape.


[360,240]GETCPU- GETCPU is a FORTRAN callable function which re-
turns a timesharing tasks accumulated CPU time
in ticks. See GETCPU.BLD and GETCPU.DOC.
RSD1.MAC supercedes RSD1I.FTN from the New Orle-
ans SIG tape.


[360,245]SPY - SPY dynamically graphically displays timeshar-
ing task's CPU utilization on a terminal basis.
It is written in the spirit of DEMO and the dis-
plays available on VAX. Refer to SPY.DOC for
full documentation, SPYBLD.DOC and SPYBLD.CMD
for task build options.

CHICAGO, SPRING 1980 - RSX/IAS SIG TAPE
THE FOLLOWING ARE CONTRIBUTIONS FROM:

A.R.A.P.
BOX 2229
PRINCETON, NJ 08540
CONTACT: JOHN LEONARD (609) 452-2950

SYSTEM: IAS VS3.0, 11/70, RP06 BASED

[360,1] - README.1ST

[360,200] - ARAP.OLB, NEEDED FOR ALL FOLLOWING SOFTWARE
SOURCE FILES ARE ONES ADDED TO THIS VERSION OF
ARAP.OLB. REFER TO PREVIOUS 2 SIG TAPES FOR OTHER SOURCES.

[360,215] - DSM - DISK STORAGE MONITOR
DSM, NOT (NOTICE), AND A PDS PATCH SET UP A SYSTEM TO
SET DISK ALLOCATION LIMITS, CHECK THE LIMITS
AUTOMATICALLY, AND ENFORCE THE LIMITS BY WAY OF
LOGIN MESSAGES, PURGING FILES AND FINALLY, REVOKING
PRIVILEGES. DSM IS ABLE TO MAINTAIN A REQUIRED LEVEL
OF FREE DISK SPACE WITHOUT CONSTANT SYSTEM MANAGER
AGGRAVATION, ONCE THE ALLOCATION SPECS ARE DETERMINED.
SEE DSM.RNO/DSM.DOC AND MEMO8A AND 8B.

[360,216] - QX - EXTENDED QUEUE LISTING FEATURES
QX GIVES MORE DETAILED INFORMATION OF PRINT QUEUES.
SPECIFICALLY, CONCATENATED FILE QUEUE, LISTING OF
FILES SET PRINT DEFERRED AND PRINT TIME OF EACH FILE.
QXBLD.CMD WILL COMPILE AND LINK QX.TSK.
REFER TO QX.DOC FOR EXAMPLES AND SWITCHES.

[360,217] - KPS - KEYPUNCH SIMULATOR
THE PURPOSE OF THIS PROGRAM IS TO SIMULATE THE FUNCTIONS OF
THE KEYPUNCH USING A TERMINAL. KPS IS A VERY SIMPLE EDITOR
WITH THE ADDED SPECIAL FUNCTIONS OF KEYPUNCHES. THESE
FUNCTIONS INCLUDE THE USE OF 'PROGRAM CARDS' AND A 'DUP' KEY,
ALLOWING INPUT OF A FIXED FIELD NATURE WHERE KEYPUNCH
FUNCTIONS MAKE THE TYPING TASK EASIER.
SEE KPS.RNO/DOC. KPSBLD.CMD BUILDS KPS AND KPSRCV, A
RECOVERY TASK TO RECLAIM THE EDIT IF A CRASH OCCURS MID-EDIT.