This is the RSX/IAS SIG Symposium Tape from the 1981 Fall DECUS
meeting in Los Angeles. The tape contains material submitted by the user
community to the SIG at the Fall DECUS meeting.
The programs on this tape are from user submissions. The DECUS staff,
the RSX/IAS SIG staff, and DEC are all in relative ignorance of the
contents of the tapes. No warranty of any kind is implied in the
distribution of these tapes. The programs may or may not be well
documented, they may or may not work, they may even crash your system. If
you have a problem with the contents of the tape, contact the author of the
program. Do not contact DECUS, DEC, or the RSX/IAS SIG.
The tape contains approximately 36,000 blocks of software in 1900
files. Since this will fit on a single 2400 foot tape in 800 bpi BRU
format, it will be distributed as such, as an RK07 image, the smallest DEC
disk on which it will fit.
If you are a VAX site and, for whatever reason, cannot read the
contents of this tape (so graciously submitted by the hard-working RSX/IAS
SIG members), please contact Jim Neeland.
UIC account [300,1] contains several files of interest. The file
RSXF81.DIR contains a directory of the contents of the tape (BRU does not
produce nice directories). The file RSXF81TPE.DOC contains an abstract of
the contents of the tape by UIC. The file README.ALL contains a
concatenated list of all the README files on the collection. The file
SUBMIT.DOC contains the guidelines for submissions to the RSX/IAS sig tape
collection. This is must reading for everyone who desires to submit a
program to the SIG tape.
A copy of this letter appears in the file BEGINF81.TXT in the same
account. The file UICSETF81.CMD contains the UFD commands to create all
the needed UIC's on device XX:. Edit it to match your needs before using
BRU to extract the tape contents. Note that a partial extraction can be
achieved by only creating the desired UIC's.
The UIC account [300,2] contains the program that is used to copy this
and other tapes, BIGTPC. This is a new version of TPC with various new
features. See the .DOC file also in [300,2] for further information. The
source for this version has been supplied courtesy of Glen Everhart, UIC
[312,315] this tape. To use TPC with the distribution one needs a disk
with at least 38,000 blocks of free space, not necessarily contiguous.
To read in a copy of the master tape onto your disk, one enters the
following command:
RUN BIGTPC
TPC>DN:RSXF81.BRU=MT:
To make a copy of the tape for someone, one enters the following
command line:
RUN BIGTPC
TPC>MT:=DN:RSXF81.BRU
PAGE 2
The distribution is again being made through the SIG tree-structured
distribution system. A geographically oriented distribution scheme is
used, where each LUG makes a few copies of the tapes and sends them on to
other LUGS, which in turn makes a few copies of the tape and sends them on
to other LUGS, and so on. The SIG is relying on each node to contact the
next higher node for necessary tape-transfer arrangements. Since this is a
volunteer operation, sincere interest on the part of soon-to-be
participants is very helpful in assuring a timely distribution. Remember
since it is a volunteer operation, DECUS is NOT paying for postage or free
copies of magnetic tapes. Make arrangements so that this does not cost
anybody a lot of money or magnetic tapes. The Tape Copy tree will be
mailed in advance to all the nodes with two post cards included. The first
post card is to be mailed on receipt of the tree, to acknowledge continued
willingness and ability to participate. If there is some reason why a node
cannot participate in the distribution, please contact Jim Neeland
IMMEDIATELY. The second post card is to be returned when the Tape
Collection copy is received.
Now for a new project, we are in the beginning stages of compiling a
tape which contains the most popular programs on all past sig tapes. This
tape "Best of the RSX/IAS Sig Tapes" will be kept updated. The problem is
how do we determine the most popular programs. If you have taken a program
off the SIG tape and used it, write me (Jim Neeland) a letter and let me
know. This be a start anyway. Let me know about things that did not work
also. Some programs to start with would be TECO, SRD (which one ???),
RUNOFF (whose mods ? or no more mods ?), Ralph's INDEX, and Jim Downward's
KMSKIT (includes CCL). Write and let me know what other programs are being
used and WHERE YOU FOUND THEM. Tell me which tape and what uic.
Speaking of writing letters, if you use a program off the SIG tape,
take the time to write to the author and let him know. If you find a bug
or make an enhancement, write and let him know. Don't call (we all get too
many phone calls) and don't expect a bug fix, but a little positive
feedback can go a long way. Just think, we have over 230,000 blocks and
13,500 files. With a little positive feedback we will all have to get 6250
bpi tape drives. Anyway, my thanks to all the people who have submitted to
the sig tape. You are the ones who have made it the huge success it is.
The following people burned the midnight oil to create the 1981 Fall
RSX/IAS sig tape:
Ken Radford, Steve Lazarus, Philip Cannon, Glen Everhart, Bob Denny,
and myself.
Jim Neeland
RSX-IAS SIG Tape Copy Coordinator
Hughes Research Labs
3011 Malibu Canyon Rd.
Malibu, California 90265
(213) 456-6411 ext. 333
********************VD1:[5,5]README.1ST;2********************
********************VD1:[5,5]README.1ST;2********************
These are fixes to the C-runtime I/O library from the Structured-languages
tape, spring 1981 [5,5].
These changes are specifically for RSX-11M v3.2.
Ray Van Tassle
Motorola
1301 E. Algonquin Rd, rm 4135
Schaumburg, Ill
(312)-576-6017
FWILD - Properly handles wild-card with version 0 or -1.
FOPEN - Added block-mode reads. New options switch "b".
Use "locate-mode" when possible, for reading.
Fix bug in setting the VF$FIL bit.
GETC - Added block-mode read. Uses "locate-mode" when it
can for reading, instead of "move-mode", so it should
improve efficiency of reading.
FSEEK - Special code for block-mode.
TIATT - New module. Attaches LUN #1 (always TI:).
The files here are:
?.VGN - original file from SLANGSPR81[5,5].
?.CMD - Command file to update the VGN file.
?.MAC - The updated file
?.SLP - The self-locating SLP file to make the changes.
Elsewhere on this tape [310,105] are 2 modified C utilities:
DIR (revised from LC), a fast directory lister. (GETHDR.C reads
file headers in a non-kludgy way).
OD File dumper, which now works properly in block-mode.
********************VD1:[300,101]README.1ST;3********************
********************VD1:[300,101]README.1ST;3********************
This is mainly a re-release of RUNOFF. Some minor bugs have been fixed
from the last tape. This also includes 2 new switches:
/BT - to give book-style title lines (page numbers on alternate
sides of the page.
/SC - For Diablo/NEC spinwriters, to make "dark" shift
1/120 inch instead of overprinting.
NOTE:
It has been discovered that controll things (underscore, case shift,
etc) do not work properly or reliably in ".HEADER LEVEL's". There
is nothing that can be done without some major re-work, and I don't
know of anyone who has that kind of time (I certainly don't!).
To tell the truth, anyone willing to expend that much effort would
be better advised to re-write the whole thing, probably in C.
See the document for explanation of margin settings in
table-of-contents.
Ray Van Tassle
To install runoff: Type "@MAKRNO", then throw away the .TSK file
you don't want. You may want to edit the task-build file to
modify defaults.
At Fermilab, we have used these modifications without problems for
some time. If you have problems, call Daniel B. Curtis at
(312) 840-3927. The fixes for change bar were done by Dan Curtis
(no longer at Fermilab) The other stuff was done by Ray Van
Tassle, Motorola, (312)-576-6017
As part of my changes, I may have lost the command files that were
specific to RSTS. If so, sorry. RVT
********************VD1:[300,102]README.1ST;2********************
********************VD1:[300,102]README.1ST;2********************
This is some modifications to TECO version 36.
Ray Van Tassle
Motorola
1301 E. Algonquin Rd.
Room 4135
Schaumburg, Ill.
(312)-576-6017
I plan to support these changes as long as I can, so if there is a new
version of TECO, I will modify these mods correspondingly. The only ones
liable to cause anyone else problems are the patches to OBJ modules. I use
DISOBJ to find out where the patches go.
At any rate, if you have problems, call me.
It would really be nice if this stuff got put into an "official" TECO release.
To put them in, put this stuff in the UIC that has TECO, and do "@MAKE"
************ If you have a VT-100, try "TES" (TEC /SC) which uses
split-screen mode, to give VTEDIT-like full-screen editting, but normal
TECO commands, and not as slow as VTEDIT. It is very nice!!!
*******************************
This is some slight differences from the same set of stuff on the last tape.
They do the following:
1) On an EI command, if the device/UIC are omitted, it will
first look in the default device/UIC, and if not found, it will
then look in LB:[2,2].
We use this to keep a "library" UIC of handy TECO macros, including
a nifty TECO.TEC.
2) Some fixes to terminal I/O for RSX-11D and IAS.
3) When creating a file with an explicit version of ";1",
it will re-write it if it is already there. (I would prefer to
have a switch on the file-spec to specify /UP, but I didn't want to
add things to the external interface.
4) When doing a normal edit (EB), it creates the output file with
an initial allocation equal to the size of the input file. This
makes the file creation slightly faster.
5) Patch to SCREEN.OBJ and TECO.OBJ, to take better advantage
of "split-screen" mode.
The one in SCREEN will paint a blob for a space on a HAZELTINE (or
another CRT which doesn't have inverse video.
The one in TECO.OBJ turns off the automatic echoing of the current
text line on <LF> and <BS> if split-screen is on.
6) If invoked as MUN, TECO will lower it's priority after 30 seconds.
This will keep a long MUN (for example: MUN SEARCH) from screwing
up the other users.
7) Changed the "IMMEDIATE" mode operation slightly. This is
un-documented, but very handy. It lets you write a TECO macro to
get control when you use the alternate keypad, like the immediate
mode <LF> and <BS>.
This TECO macro is invoked by "n1,n2MA$$", where n1 & n2 tell
you which key was pressed.
I fixed it so that it would pass the entire 7-bit value to the macro
(if I want it stripped to the lower 5 bits I can do it in the
macro), and took out the echoing of the command.
8) To go along with this, I have a macro (KEYS.TES), which
has most of the useful functionality of VTEDIT, but which
is much, much faster and smaller. This works even on a tube (such
as a hazeltine) that doesn't have an alternate keypad, you just to
give it a double keystroke.
9) To go along with these, there is a TECO.TEC, which will load-up
KEYS, go into split-screen mode, and fly!
I fixed up CRTRUB.MAC, to add CRT support for a HAZELTINE 1500
(we have both VT-100's & HAZELTINES), and split-screen even works
on a tube that does not have it!!!!!!! (Albeit not as nice as on
a VT100).
10) The TECO.TEC supplied here set up these things, and if invoked
as TES, starts up in split screen mode, if as TEV, starts up
in VTEDIT mode. We keep this in LB:[2,2], so everyone gets started
with it, unless they over-ride it with their own TECO.TEC.
********************VD1:[300,111]README.1ST;1********************
********************VD1:[300,111]README.1ST;1********************
This UIC contains my paper to be given at the Fall 1981 DECUS symposium
in L.A., plus a lot of the programs and update files mentioned.
The paper is: RSX-11M Systems Operation. Using things from the RSX SIG
symposium tapes to improve the operation and usablility of your
11M system.
Ray Van Tassle
Motorola
1301 E. Algonquin Rd, rm 4135
Schaumburg, Ill
(312)-576-6017
********************VD1:[300,112]README.1ST;2********************
********************VD1:[300,112]README.1ST;2********************
This is the WHO from CHI SPRING 1980 DECUS [307,20], with some
minor fixes.
The *.VGN are the original files.
*.SLP are changes to the VGN.
*.MAC are the updates ones.
To build this, do @FIXWHO
or
MAC @WHOASM
TKB @WHOBLD
********************VD1:[300,113]README.1ST;2********************
********************VD1:[300,113]README.1ST;2********************
Ray Van Tassle
Motorola
1301 E. Algonquin Rd, rm 4135
Schaumburg, Ill
(312)-576-6017
These require my fixes for block-mode reads to the C runtime library.
DIR (revised from LC), a fast directory lister. (GETHDR.C reads
file headers in a non-kludgy way).
OD File dumper, which now works properly in block-mode.
GREP is from the SlangSPR81 [6,1]
For the benefit of those people who don't have C & don't want to put
it up, I have included TSK files of these 3 utilities.
Perhaps seeing them will persuade you to get & use C.
********************VD1:[300,120]README.1ST;1********************
********************VD1:[300,120]README.1ST;1********************
THIS UIC CONTAINS THE VS: DRIVER, CURRENT VERSION 2.04 (30-OCT-81 REVISION)
AND ASSOCIATED UTILITIES AND TEST PROGRAMS. THE VS: DRIVER PROVIDES A SYSTEM
OF NAMED QUEUES FOR INTER-TASK COMMUNICATIONS, AND CAN BE VIEWED AS AN
EXTENSION OF A "VARIABLE SEND-DATA" SERVICE. VS: VERSION 2.04 INCLUDES
SUPPORT FOR AST-ON-RECEIVE, SELECTIVE EXAMINE, SELECTIVE MESSAGE DELETE, AND
FLUSH QUEUE, WHICH VERSION 1 DID NOT HAVE.
IF YOU WANT SUPPORT (BUG FIXES, ETC.) FOR VS:, PLEASE CONTACT ME AT ONE OF THE
FOLLOWING ADDRESSES:
VIRTUAL ADDRESS (MY EMPLOYER):
JOHN OSUDAR
SCIENCE APPLICATIONS, INC.
1211 W. 22ND STREET
SUITE 901
OAK BROOK, IL 60521
PHYSICAL ADDRESS (WHERE I REALLY WORK):
JOHN OSUDAR
CHEMICAL ENGINEERING DIVISION
BUILDING 205, ROOM A-109
ARGONNE NATIONAL LABORATORY
9700 S. CASS AVENUE
ARGONNE, IL 60439
LOGICAL ADDRESS (BUSINESS MAIL TO MY HOME):
JOHN OSUDAR
P. O. BOX 1451
HOMEWOOD, IL 60430
IF YOU'RE REALLY DESPERATE, YOU CAN EVEN CALL ME AT ARGONNE; MY OFFICE
PHONE IS (312)972-7294.
JOHN OSUDAR
********************VD1:[300,121]README.1ST;1********************
********************VD1:[300,121]README.1ST;1********************
THIS UIC CONTAINS A SERIES OF FORTRAN CALLABLE SUBROUTINES
DESIGNED TO ALLOW THE USER TO UTILIZE THE INTERNAL CHARACTER-
ISTICS OF THE VT-100 FAMILY OF TERMINALS. SINCE THE ORIGINAL
PURPOSE OF THIS LIBRARY WAS TO SUPPORT A VT-105 TERMINAL,
SOME OF THE ROUTINES ARE SPECIFIC FOR THAT TYPE TERMINAL.
THESE ROUTINES WERE WRITTEN FOR RSX-11M, AND THE FULL
DUPLEX TERMINAL DRIVER. EXTREME CARE SHOULD BE TAKEN TO
INSURE THAT THE LOGICAL UNIT TO WHICH THESE ROUTINES ARE
TO ACT UPON, IS IN FACT A TERMINAL. UNPREDICTABLE RESULTS
WILL OCCUR IF THE OUTPUT IS REDIRECTED TO A DEVICE OTHER
THAN A TERMINAL. FOR AN EXPLAINATION OF THIS SEE THE
FULL DUPLEX TERMINAL DRIVER SECTION 2.17.3.
WRITTEN BY KEN ROLLER
RESEARCH COMPUTER SERVICES
G.D. SEARLE
P.O. BOX 5110
CHICAGO, ILL. 60680
THE FOLLOWING IS A SUMMARY OR THE ROUTINES:
BUFFER - SET THE BUFFER SIZE
VTANS - SET THE TERMINAL TO THE ANSI STD MODE
( NOTE: ALL ROUTINES EXPECT THE TERMINAL TO BE IN THIS MODE)
VTBRT - SET THE BACKGROUND TO BRIGHT
VTCLR - CLEAR THE SCREEN OF ALL GRAPHICS AND TEXT (VT-105 SPECIFIC)
VTCMV - MOVE THE CURSOR TO THE REQUESTED POSITION
VTDRK - SET THE BACKGROUND TO DARK
VTDTX - DISPLAY TEST AT REQUESTED POSITION, AND WITH REQUESTED
ATRIBUTES
VTELN - ERASE ALL OR PART OF A SPECIFIED LINE
VTESC - ERASE ALL OR PART OF THE SCREEN
VTGOF - RETURN TERMINAL TO TEXT MODE (VT-105 SPECIFIC)
VTGON - PUT THE TERMINAL INTO THE GRAPHICS MODE (VT-105 SPECIFIC,
AND VT-125 TO VT-105 EMULATION MODE)
VTHGT - ERASE A PAIR OF LINES AND SET THEM TO EITHER SINGLE OR
DOUBLE HEIGHT
VTHME - RETURN THE CURSOR TO THE "HOME" POSITION (UPPER LEFT)
VTJMP - SET THE TERMINAL TO THE "JUMP" SCROLL MODE
VTLED - CONTROL THE LED DISPLAY ON THE KEYBOARD
VTRCR - RESTORE THE CURSOR AND GRAPHIC RENDITION (VT-105 SPECIFIC)
VTROL - SET THE SCROLL AREA ON THE TERMINAL
VTSCR - SAVE THE CURSOR AND GRAPHIC RENDITION (VT-105 SPECIFIC)
VTSGC - ENABLE OR DISABLE THE SPECIAL GRAPHICS CHARACTER SET
VTSRL - SET THE TERMINAL TO THE "SMOOTH" SCROLL MODE
VTWDT - SET A LINE TO EITHER SINGLE OR DOUBLE WIDTH
VTWHO - QUERIES THE TERMINAL AS TO ITS TYPE AND OPTIONS AND
RETURNS THE INFO TO CALLING ROUTINE
VT52M - SET THE TERMINAL TO THE VT-52 MODE
VT080 - SET THE TERMINAL TO 80 COLUMN MODE
VT132 - SET THE TERMINAL TO 132 COLUMN MODE (ASSUMES A.V.O.)
VTLIB.CMD IS A COMMAND FILE TO COMPILE AND BUILD THE VT LIBRARY.
ADDITIONALLY, THERE ARE SEVERAL EXAMPLES OF THE USE OF THESE
ROUTINES.
PROGRAM TREE WILL PRODUCE A CHRISTMAS TREE AND BLINK THE LIGHTS
TO ONE OF THREE STATES. THIS PROGRAM IS BEST RUN FROM A HIGH
BAUD RATE TERMINAL. (@ 4800 RUN TIME ~APROX 2 MIN)
PROGRAM LED WILL TURN THE LED DISPLAY ON AND OFF WITH SEVERAL
PATTERNS
PROGRAM CUTE IS CUTE!
END OF DOCUMENT
********************VD1:[300,123]README.1ST;1********************
********************VD1:[300,123]README.1ST;1********************
UIC [300,123] contains Multitasker articles that I have
written under the heading of "From the Wizzards Book of RSX
MAGIC". These articles contain code of general use and
therefor, I have put them in computer readable form.
The uic contains the following files:
1. README.1ST -- this file.
2. WIZ1.DOC -- article about sending nonstandard ASTs
to tasks
3. WIZ2.DOC -- article about an error logger.
If you have questions or comments, contact me.
Thanks
Daniel B. Curtis
Science Applications, Inc.
1121 W. 22nd St.
Suite 901
Oak Brook, IL 60521
(312) 655-5960
********************VD1:[300,126]README.1ST;2********************
********************VD1:[300,126]README.1ST;2********************
The Archive System has been used by our company for over a
year and has been found to be a very clean and efficient system.
There are no known bugs.
This system was written to run on an IAS3.1 Operating System
with SRD and SORT-11 utilities. It is written in Fortran.
DO NOT USE FORTRAN 77
The Fortran 4 plus compiler should be used and not Fortran 77.
As of the date this program is being submittd we just received
our Fortran 77 compiler and this program dos not work on it
properly. We did not find out why yet. The first obvious
problem is that number of days since last archive is not
being calculated correctly under Fortran 77 which may indicate
other serious problems elsewhere not yet discovered.
The following files are given. Detail documentation can be
found in the the Rno file. Logic flowchart of Dayarc and its
routines also available if you write and request it.
README.1ST - This file
ARCBLD.CMD - Command file to build Archive.
ARCHIVE.RNO - Archive Documentation
HEDARC.FTN - List Archive heading, starts Dayarc.
DAYARC.FTN - Daily storing of files on tape.
LSTARC.FTN - List files stored on tape.
RSTARC.FTN - Create Bis file to restore files from
tape to disk.
ASCARC.FTN - Create Bis files to save and compress
Archive tapes.
ARCLIB.FTN - Subroutines used in the Archive programs
Please feel free to direct any questions to:
Steve Citko or Felicia Redic
233 N. Michigan
Engineering 28th fl.
Chicago, IL 60601
(312) 565-1600 ext. 2309 or 2739
If there are any poblems or enhancements desired also feel
free to let us know, and if they are not too much work, we
will be glad to make them and make sure they are included
on the next Sig tape so that all can benefit.
********************VD1:[300,130]README.1ST;1********************
********************VD1:[300,130]README.1ST;1********************
Requirements:
This version of pinochle is a 4-player partnership game
written in PASCAL. Although the Swedish Pascal Compiler
was used, the only "non-standard" Pascal code was the LOOP
-END in the main routine.
Description:
The program has a competitive bid routine and has a fairly
good play routine (it's easy to lose). The game has two
features which are quite useful. For any prompt (bid or
play), a single question mark typed will cause your current
hand and the declared trump to be displayed. A double
question mark will cause the computer to play your current
turn.
The program has two flaws (some people find them useful
which is why they will probably never be fixed). One
problem is that whenever you are depleted of a suit and
that suit was led, you do not have to trump it. This has
the advantage that if your partner is going to win the
trick, you can give your partner a pointer. The other
problem is that if trump was led, you do not have to go
over the previous card. This has the advantage of giving
your opponents your low trump and using your higher trump
cards later. For either of the above problems mentioned,
if the computer plays your turn, it will play "correctly".
GOOD LUCK!!!!!!!
Any suggestions or comments refer to:
Stephen Dover
2942 MAcArthur Blvd.
Norhtbrook, Ill. 60062
(312) 272-9555
********************VD1:[300,131]README.DOC;1********************
********************VD1:[300,131]README.DOC;1********************
MTREK FOR RSX-11M USERS
---------------------------
Requirements:
RSX-11M V3.2 (should work on V3.1)
Memory requirements are approximate:
(built with resident libraries)
Common 3.5K words
Driver 6K words
Robots 3.5K words
Player 9.5K words
Description:
This version of MTREK was modified to run under RSX-11M on
a PDP 11/60 with 128K memory limit (the game can also run on
smaller systems 11/23, 11/34, etc. with less memory). Because of
the memory limit, the number of available player ships was reduced
from 8 to 4 and the robots may use ships 1-6. Also the taskbuild
files contain a reference to our fortran resident library, you will
have to change the name (usually F4PRES).
With these changes, the MTREK game is capable of running
without checkpointing or shuffling occurring. It might be noted
that checkpointing and shuffling degrades the game horribly.
How to create MTREK:
@BUILD ! assemble all required modules
Put LEDFORD.STB & .TSK in LB:[1,1]
How to start up MTREK:
@SETPAR ! Remove current partitions and
install LEDFORD common partition,
driver and robots programs. This
command file should be edited to
match the configuration of your
system.
RUN MTREKINI ! Run initialization program.
RUN ROBOT ! Set up robots.
RUN MTR ! Start driver task.
@GAMETIME ! Install player program.
@KILLTREK ! Abort and remove MTREK ( does not
abort or remove spawned versions
of tasks). Also sets partition
back to normal.
Have fun and good luck!!!!!!!!!
Any comments or suggestions refer to:
Stephen Dover
2942 MacArthur Blvd.
Northbrook, Ill. 60062
(312) 272-9555
********************VD1:[300,131]README.1ST;1********************
********************VD1:[300,131]README.1ST;1********************
MULTI-TREK is a game similar to traditional Star-Trek games
except that it involves several players (currently up to 6), who
play against each other rather than against imaginary Klingons,
Romulans or whatever. The MULTI-TREK universe consists of a 80
by 80 matrix, of which an approximate 20 by 20 matrix of each
player's immediate area is displayed and continuously updated at
their terminal. MULTI-TREK was originally submitted to the New
Orleans collection, then to the 1979 San Diego collection with
the addition of robot ships. This version has significant en-
hancements and improvements, most notably the addition of energy
nets, an improved screen display, much better input-output (any
terminal with clear screen and cursor positioning may be used at
speeds from 1200 baud on up), use of default ship and direction
with most commands ("L" (locate command) sets the default dir-
ection), more competitive scoring, smarter robot ships, commands
can be stored in the typeahead buffer, commands with values can
be typed as one command (i.e. C 3, W 4, L 1, etc), and fewer
bugs. Complete instructions for starting and playing MULTI-TREK
are in the file MTREK.DOC.
The game consists of a driver task (MTREKD), a player task
(PLAYER) for each terminal, and a shared global common area for
inter-task communication. This version runs on RSX-11M V3.2,
however, it should run under any system with shared global
areas and rudimentary task switching or time-sharing. Real-time
systems without time-sharing may have to play with priorities to
insure that the driver task gets sufficient CPU time and that
all players get an equal amount of time.
This version of MULTI-TREK was written using a Fortran IV+
compiler (i.e. uses ENTRY points)
Requirements:
Unsolicited input AST attach (RDAST.MAC).
Full-duplex terminal typeahead buffer.
Get terminal characteristics (TERMINAL.FTN).
NOTE: If your system does not support SET /SPEED
(i.e. 11/23, etc.), modify the code in
TERMINAL.FTN in subroutine GTCHAR that
requests speed information (CHARS(1) & CHARS(2)).
MTREK will work properly with any terminal with clear screen
and cursor positioning. The source code is set up to drive
ADM3-A's (unfinished), VT100's (in VT52 mode), VT52's and ISC's.
If you are using different terminals, you should modify the
files TERMINAL.FTN and RDAST.MAC to drive your terminal.
Modifications should be straight-forward as the code is commented
on where to change it.
To build MTREK, (also look at readme.doc) do
@BUILD
Notes:
A problem exists when a player types very fast and the driver
places the shot one on top of the other (torpedo hit torpedo) so
the player does not shoot anything past the first square.
A future enhancement is to reduce the AST processing of each
character by reading the typeahead buffer. But I currently do not
have the time to make the modification right now. Maybe someday.
Send comments, suggestions, etc. to:
Stephen Dover
MCC Powers
2942 MacArthur Blvd.
Northbrook, Il. 60062
(312) 272-9555
********************VD1:[300,132]README.1ST;1********************
********************VD1:[300,132]README.1ST;1********************
This directory contains the following programs:
DSP.FTN - Converts input format to output format.
Currently supported formats are:
BYTE REAL*4 ASCII
INTEGER*2 REAL*8 RAD50
INTEGER*4 OCTAL
FCB.MAC - Prints out F11ACP file control blocks (open
file information) of a disk device.
Updated output format from Spring '81 source.
LUT.MAC - Prints out the logical unit table of a running
task including open file information.
Updated output format from Spring '81 source.
SPQ.MAC - Prints out the spool queue OR the receive
queue of ANY task.
All the above sources (except DSP.FTN) can be built all at once or
selectively using the DOALL.CMD file.
********************VD1:[301,62]README.1ST;2********************
********************VD1:[301,62]README.1ST;2********************
[301,062] account contents
VAL a terminal I/O package
This directory contains a set of terminal input and output routines
which provide the writer of application programs with facilities such as
defaults, range checking and an interface to a command language system.
The routines are FORTRAN or MACRO callable and require 11M V3.2 or higher.
It is intended that by the use of this package programs may be given more
power for very little effort and users may be provided with a more
forgiving interface than is obtained with FORTRAN input. The use of these
routines is also required if the CLONE command language described in the
UIC [301,63] is to be used.
VAL provides the following basic features:
1. Free format input. Values are type converted as required and may
be presented multiply on a line. Values are accepted in exponent
form (ex. 1.65E3).
2. Output formatting in a single statement. The combination of the
format string with the argument list simplifies writing and
reading programs.
3. A default value may be specified in an input request and will be
returned if the reply is CR or ';'.
4. Range limits may be specified for any value requested. If the
reply is out of range an error message is printed and the
question is re-posed. If ? is replied to any question the
details of the type and range of the item required will be
printed.
5. Replying to any question with CTRL-Z causes a user specified
abort routine to be called. The programmer then has the choice
of closing files and exiting, performing some special function or
ignoring the interruption.
6. The prompt is included in the input call. This permits a
question to be interrupted (by a range error for example) and the
question to be re-posed on return.
7. Input and output calls may be easily issued from assembly code
programs and routines.
8. All input and output is under user control. It is thus simple to
interface to some form of command language and provide extensive
task control features. The current implementation supports the
CLONE command language. The special characters @ and ESCAPE
invoke the CLONE processor. See the CLONE users guide for
further details of the CLONE system.
See README.2ND for installation details.
Dave Plummer
Division of Biophysics, Department of Radiology
UCLA Center for the Health Sciences
405 Hilgard Avenue, Los angeles, CA 90024 USA.
(213) 825 8113
********************VD1:[301,62]README.2ND;2********************
********************VD1:[301,62]README.2ND;2********************
VAL INSTALLATION
The command file VALBLD will assemble the complete VAL system and
place the resulting modules in a library named UTYLIB.OLB. For
general use of the system this library should be copied to LB:[1,1].
Invoke this file as follows:
@VALBLD ALL
The VAL routine START creates a dynamic region for intertask
communication. This region is created in partition VALPAR which must
thus exist on the system prior to use of the VAL routines. For test
purposes the module VALSUB may be edited to change the partition name
to GEN. Otherwise create a system controled partition named VALPAR of
128. words for each terminal which may use VAL simultainiously.
The following files should be consulted for further information.
1. VAL.RNO The complete VAL documantation
2. VALTST.FTN A test program for the system
3. The CLONE system documentation also released on the Fall SIG
tape.
********************VD1:[301,63]README.1ST;1********************
********************VD1:[301,63]README.1ST;1********************
[301,063] account contents
CLONE command language system
CLONE is a multi-user interpretive command language system for
RSX11M V3.2 which enables user written tasks to be executed under a
control program stored in a file or entered in 'immediate mode' at the
terminal. CLONE was initially developed for the control of programs in
medical image processing, but is of use in all applications where
automatic or semi-automatic control of programs can save time and
increase reliability.
CLONE has a high-level block structured syntax which is readily
accepted by novice users but which provides a full range of language
capabilities and thus permits sophisticated programming.
CLONE (and other similar command languages) give the following
advantages:
1. Less operator intervention is required in a process controlled
by CLONE thus the probability of error is greatly reduced.
2. CLONE may be used to group all the questions for an operation at
one point. This means that the operator does not need to remain
by the terminal during long processing operations and may
perform other tasks.
3. CLONE enables a precise sequence of operations to be defined.
Thus a protocol may be executed many times in exactly the same
manner. This enables experiments to be performed more exactly,
provides a written record of previous protocols and provides a
formal method of defining a protocol.
Unlike system orientated command languages (indirect MCR in RSX),
CLONE is designed to communicate with all programs in an applications
package. This requires that all programs which are to take advantage of
CLONE use a special set of utility routines for terminal input. These
routines are described fully in the document: VAL TERMINAL I/O PACKAGE;
they provide a general purpose terminal interface for applications tasks
whether they use CLONE or not. The VAL package appears on the Fall 81
SIG tape in [301,62]. See README.2ND for CLONE installation details.
Dave Plummer
Division of Biophysics, Department of Radiology
UCLA Center for the Health Sciences
405 Hilgard Avenue, Los angeles, CA 90024 USA.
(213) 825 8113
********************VD1:[301,63]README.2ND;1********************
********************VD1:[301,63]README.2ND;1********************
CLONE installation
The CLONE system is built and installed by the command:
@CLONEBLD ALL
This command file will assemble all modules and build the three tasks
which comprise the CLONE system. These tasks are:
1. CLONE the command language processor/interpreter itself
2. ...CL1 the MCR interface command. This task is installed
from file CL1.TSK
3. CL1... the terminal input task. This task is installed from
file CL1IN.TSK
CL1... normally installs in partition VALPAR. If this partition has
not been created or is not large enough the task may be installed in
GEN. However as it is not checkpointable during input it is
preferable to run CL1... in its own partition or FIX it. The size of
this task is 2100(8) bytes.
When CLONE has build successfully issue the command:
CL1 @CLONETEST
********************VD1:[301,64]README.1ST;1********************
********************VD1:[301,64]README.1ST;1********************
[301,064] - ERNMBR - ERROR-LOG ERROR-COUNT DISPLAY FOR M & M+
SUBMITTED BY: JIM NEELAND
HUGHES RESEARCH LABS
3011 MALIBU CANYON RD.
MALIBU, CA 90265
PURPOSE: AN INSTALLED (PRIVILEGED) TASK TO DISPLAY CURRENT
ERROR COUNT (& WARN IF ERRORLOGGING OFF)
ESPECIALLY DESIRABLE WHEN USING MAGTAPE TO WATCH
FOR SOFT ERRORS.
COMMENTS: A RATHER DUMB BUT USEFUL LITTLE UTILITY.
********************VD1:[302,212]README.1ST;2********************
********************VD1:[302,212]README.1ST;2********************
FORTRAN SYMBOLIC DEBUGGING TOOL (SDT)
SDT is different from most FORTRAN symbolic debugging tools currently
available for the PDP-11 for the following reasons:
1. It steps through a program by FORTRAN statements and can display
each statement at the time it is executed.
2. It supports a "split screen" format for CRT terminals. SDT I/O
will be above the dashed line and regular program I/O below it.
3. It maintains breakpoint traps in the overlay loading mechanism (if
used) and will set traps, as required, as different overlays are
loaded.
4. It consists of two basic modules which communicate via
send/receive directives:
1. A small module, 'LIMPIT', approximately 1KW in length, that is
part of the user task being debugged.
2. The separate program, DEBUG, that gets requested by LIMPIT.
DEBUG performs all table generation, file I/O, command parsing
and communications with the terminal.
This allows SDT to handle large tasks that are near their 32K
address limit.
SDT was written for IAS, but should be fairly easily modified for
RSX-11M or M+. It has the option of using CRT screen formatting. The
original code is for Beehive terminals, but all of the cursor positioning
code is in the module POSITN.MAC and is well commented.
When Task-building DEBUG, several warning errors (4 of them) will
occur. Ignore them - they are due to the same module being in different
overlays.
If you have any comments, bug fixes, enhancements or whatever, please
let me know.....
Scott Leatham
The Boeing Company
Seattle, Washington
(206) 237-6363
********************VD1:[305,302]README.1ST;1********************
********************VD1:[305,302]README.1ST;1********************
DECUS RUNOFF - VERSION M02.4
This release of DECUS RUNOFF is compatible with the
previous text processing SIG's version M02. Several
enhancements and fixes have been made. Please read the
release notes in RNOM24.DOC first, then follow the
directions in the manual RUNOFF.DOC for installation of this
version. The RSX-11M/M+ installation has changed completely
(for the better/easier).
Bob Denny
01-Dec-81
Submitted by:
Bob Denny
Creative System Design Co.
3452 E. Foothill Blvd. Suite 601
Pasadena, CA 91107
(213) 792-9474
RUNOFF:
Yet another RUNOFF??? YES! This is the "standard" RNO, with
RT-11 support and an overhauled hyphenation system. No bells
and whistles, BUT... it's the version that supports the "raw
text" emitted by Dan Dill's "TEXT" mathematical typesetting
pre-processor. He and I have been working to get a baseline
for all DEC operating systems including RT. It's going into
the DECUS library now.
For more information on Dan Dill's mathematical manuscript
pre-processor, see the Multi-Tasker October, 1981 edition.
********************VD1:[307,20]README.1ST;14********************
********************VD1:[307,20]README.1ST;14********************
U. S. Geological Survey Submissions
1981 Fall DECUS Symposium, Los Angeles, California
Directory: [307,20]
Our submissions this year, as opposed to previous years, is more
system oriented, towards the goal of maximizing system performance. (We
have submitted many "toys" in the past; try any of the 1980 SIG tapes.)
Most of these submissions are related to some of the topics
discussed in the RSX-11M-PLUS Performance Session, and with some
exceptions, the submissions are RSX-11M-PLUS dependent. With some time
and experimentation, most everything here can be made to work on
RSX-11M.
Please note that with RSX-11M-PLUS V2.0 coming out shortly, some of
our submissions (e.g., the .COR files for MCR and SGNMAS) will have to be
adjusted, thrown out, or whatever. We would be happy to provide updates
for the new release (no guarantees, you realize!); feel free to write
us at the address below.
Our submissions are modularized. The directory contains three files
initially:
README.1ST -- You are reading this now!
USGS.CMD -- Overall command file for unloading modules
USGS.ULB -- Universal library containing ALL the
submissions, including "nested" .ULB libraries
When you invoke USGS.CMD, you will be asked whether you want
each submission unloaded from the universal library.
In particular, our submissions are:
I. FCPMU1 -- Multi-user F11ACP
-------------------------------
If you've heard rumors, and didn't believe it, here it is: multi-user
F11ACP. Check the benchmarks in the Multitasker, and check your memory
requirements. If you want to give it a crack, all the files are
here....it's really easy (easier than on 11M). All that is involved is
to redefine the PSECTions for F11ACP by assembling a dummy MACRO file
and rebuilding F11ACP with a different build file.
II. BLKIO -- Fast Universal Fortran I/O
-----------------------------------------
Routines providing (very) fast Fortran block I/O to either normal or
virtual arrays. (VERY applicable for 11M systems) Routines provided
use direct IO.RVB and IO.WVB QIO's to and from Fortran arrays. We had
another version using standard Fortran I/O (transportable!), but we
seem to have misplaced it somewhere. Get in touch with us if you need it.
III. STREAM -- USGS Local Configuration Command and Batch Files
----------------------------------------------------------------
What puts a RSX-11M-PLUS system together? Do you spend a lot of time
with VMR? One of DEC's great ideas was the .ENABLE/.DISABLE QUIET
directive in INDirect (AT.). That means your STARTUP.CMD file can
be as long as you want, and you don't have to have any of it printed!
We leave SYSVMR.CMD alone, and change STARTUP.CMD whenever a minor
configuration chage occurs. Check our STARTUP.CMD files for ideas.
Don't worry....sometimes we get confused trying to read it also.
Our local program STTY may come in handy. With it, you can do as many
SET /WHATEVER commands to a single terminal that you can fit on a line.
It's included here, also.
A special command file, REASSIGN.CMD, performs REAssign commands on
the tasks which need work files (TKB, F4P, LBR, MAC). By reassigning
the LUN's for the work files, you can balance out the load on your disks.
Batch streams are like any other resource on a system....they must be
properly managed. Without complicating things, you can encourage use
of the batch streams from your CPU-heavy customers by opening up the
number of processors at night, and then closing them down when the
daytime load begins. Take a glance at our configuration files for ideas.
IV. CSH -- Checkpoint Space Handler and TKTN Bug Fix
--------------------------------------------------------
Here's our Checkpoint Space Handler, a tool which will show you what's
on your checkpoint files and will force deallocation of a checkpoint
file by spawning ACS and unstopping/restopping checkpointed tasks.
(NOTE: It doesn't work yet on 11M. Volunteers?)
If you like CSH, you may want to apply the correction file to TKTN
pretty quick. Otherwise, when TKTN is called to deactivate a checkpoint
file, and that file is not first in line, TKTN will hang your system.
V. MCR -- The Non-overlaid MCR dispatcher + a bug fix + extra features
------------------------------------------------------------------------
Two mods in particular: patches so that you can un-overlay the
dispatcher (unsupported by DEC -- who knows why???), a fix for
continuation lines (will probably be published by DEC), and some changes
so that your catchall task (if you have one) will get a crack at the
command WHENEVER MCR can't swallow it (also, why didn't DEC do this?).
VI. SYSGEN -- Correction to SYSGEN Subcommand file SGNMAS.CMD
---------------------------------------------------------------
If you want to generate a configuration with multi-access disk drives on
your RH70's, you'd better apply this .COR file to SGNMAS.CMD, or you'll
risk a crash!
VII. VERSATEC - RSX-11M-PLUS Line Printer Driver Including Versatec Support
---------------------------------------------------------------------------
A Versatec DMA LP driver for RSX-11M-PLUS. This is the driver that Larry
Baker has advertised in the Multitasker. Now you can have it without
writing away for it!
VIII. NOTES -- Larry Baker's notes on Fortran, perfomance, and tapes
--------------------------------------------------------------------
Why not? These are free notes, some of which you may find useful. Taken
from several sessions at the Fall '81 Symposium.
IX. FINALLY -- Who are we, where are we?
----------------------------------------
Please write us if there are any questions or problems associated with
this kit. Please do not call - we don't have a secretary, and we really
can't commit ourselves to handling phone inquiries (sorry!). If you've
come up with enhancements, we'd really like to hear about them!
Larry Baker
Gary Maxwell
U. S. Geological Survey
345 Middlefield Road M/S 77
Menlo Park, California USA 94025
********************VD1:[307,22]README.1ST;1********************
********************VD1:[307,22]README.1ST;1********************
THIS DIRECTORY, [307,22] CONTAINS ALL THE PROGRAMS DESCRIBED IN
A TALK TITLED "RECOVERING FROM DISK DESASTERS"
YOU SHOULD READ THE FILE "DISK.DOC" BEFORE YOU ATTEMPT TO
USE ANY OF THESE PROGRAMS. DISK.DOC IS A RUNOFF OUTPUT OF THE TEXT
FROM THE TALK, TO BE GIVEN ON DECEMBER 10TH AT THE FALL 1981
DECUS SYMPOSIUM. ALSO TO BE PUBLISHED IN THE PROCEEDINGS.
********************VD1:[307,36]README.1ST;1********************
********************VD1:[307,36]README.1ST;1********************
Fall 1981 DECUS RSX/IAS SIG Tape Submission
Joseph S. Sventek
Computer Science & Mathematics Department
Lawrence Berkeley Laboratory
Berkeley, CA 94720
This submission [307,36] consists of three parts:
1. drgtk.cor, hello.cor, sprovfdt.cor, homdir.mac, home.doc
These files permit corrections to an RSX-11M v.3.2 system
which allow a user's home directory to be found, even for
priveleged users who have performed a set /uic to another
uic. Consult the note `home.doc' for complete information.
2. acp.doc, fcpco1bld.cmd, fcpco1bld.odl, fcpmu.mac,
fcpmubld.cmd, fcpmubld.odl
These files are identical to those published in the October
1981 Multi-tasker for building a multi-user F11ACP for
RSX-11M. Consult the paper `acp.doc' for more information.
3. The rest of the files in this UIC are command files for
building FCSRES versions of many of the RSX utilities, as
well as some modified build files for the utilities w/o
FCSRES. The FCSRES files require the logical device
assignments OU: for the task images and MP: for the maps,
expect to find the corresponding ODL files in [1,23], place
the map in [1,33] and the task image in [1,53]. The file
`fcsres.doc' can be consulted for more information.
********************VD1:[307,100]README.TXT;1********************
********************VD1:[307,100]README.TXT;1********************
VDX - Virtual Disk Package
This is semi-weird, so bear with me. This package enables you to create
a disk on a part of another disk. The virtual disk is a contiguious file
of any size on the real disk. The virtual disk driver adds the starting
logical block of the file to any IO.WLB and IO.RLB requests issued to
it and passes the I/O packet on to the real disk driver. The virtual disk
(file) is INIed, MOUnted, and used like any other disk.
The program AVD assigns a file to a virtual disk unit and optionally can
create a file. The format of its commands are:
>AVD VDn:=file[/sw]
/CR:n Create file of "n" blocks
/RK Create file of 4800 blocks
/RO Access file in readonly mode
The program DVD deassigns the file. Its command form is simply >DVD VDn:
The package is very useful for separating projects from each other and
avioding UIC and filename conflicts.
MAINTENENCE NOTES
The command file 'VDXGEN.CMD' assembles and builds VDX. Before using
VDXGEN, check the location of the system's RSXMC.MAC against where
'VDXASM.CMD' expects to find it. VDXASM may need to be changed.
Also, decide how many VD: units you want, and set the symbol 'V$$D11'
in 'VDPRE.MAC' accordingly.
This stuff works correctly on both 11M and 11M+ systems. The code is
conditionally assembled based on the symbol 'R$$MPL' in RSXMC.MAC, so
make sure the RSXMC for the target system is used.
********************VD1:[307,100]README.1ST;1********************
********************VD1:[307,100]README.1ST;1********************
README.1ST---
This directory contains three separate sets of files from NASA/Ames
Research Center:
TAT
This program allows convenient manipulation of certain
fields of the task header (ie. taskname, priority, partition,
etc.) that can also be done at install time. This is
especially convenient if tasks are not left installed, and
it is inconvenient or impossible to rebuild.
SVD, VD:, etc.
This is mostly the same old virtual disk software, but has
been modified to run on M or M+. Also included is SVD, which
displays the filename of each virtual disk file which is
assigned to a VD:
CALC
This is DECUS CALC modified to be compiled by FOR for systems
with only EIS hardware.
********************VD1:[307,101]README.1ST;1********************
********************VD1:[307,101]README.1ST;1********************
INSTRUCTIONS FOR *STARFLEET* PACKAGE
====================================
The program STARFLEET was written by Trevor Sorensen for use on the
RSX-11M(+) Operating System. STARFLEET is a fairly standard Star Trek-type
program, although more sophisticated than most. However, one feature that
sets it apart from most Star Trek games is the incorporation of a
comprehensive Service Record and associated features. Each player is kept
on file. A new recruit starts out as a Cadet in Star Fleet Academy (Rank 1)
and eventually works his way up to full Admiral (Rank 10). Awards are given
along the way for outstanding missions, and if a certain minimum standard
is met for a given rank, then the player is promoted to the next rank. There
is also a Star Fleet Post Office (SFPO) for mail service between players;
the Star Fleet News to keep players abreast of happenings, etc.; and the
program allows each player to view his own Service Record, promotion history,
etc. These features are described in more detail in STARFLEET.SFA.
The program is written in FORTRAN IV-PLUS, and is set up to be installed
on UIC [200,200]. If this needs be changed, the following files will have
to be edited (search for all 200,200's):
MAIN.FTN MESS.FTN
NEWG1.FTN SFCMD.FTN
NEWG4.FTN
NEWG4A.FTN
NEWG4B.FTN
NEWG4C.FTN
HUMOR.FTN
FINI.FTN
PROM.FTN
Use the command file STREK.CMD to compile the source files (STREKP.CMD will
compile with listings). Use the following to taskbuild:
TKB
TKB>@STREK.TKB
If players will be running the program from other accounts, the data files
will have to have the privilege reset to allow them proper access.
The instructions for running the program are contained in STARFLEET.INS and
UPDATE.INS. Additional information is in STARFLEET.SFA.
The utility program to maintain the data files, etc. is contained in
SFCMD.FTN. The program to write the day-message is in MESS.FTN. For both of
these programs, the current password is "SFHQ". For running STARFLEET itself,
the password for the manager (FLEET ADMIRAL) is "TEST". This can be changed
in the subroutine SIR in the file MAIN.FTN.
A comprehensive manual exists for setting up and maintaing the STARFLEET
program. It is called "STAR FLEET COMMAND OPERATIONS AND MANAGEMENT MANUAL".
A copy of it can be obtained from the author by writing to:
Dr. Trevor Sorensen
McDonnell-Douglas Technical Services Co.,
16441 Space Center Blvd.
Houston, TX 77058
If you have any problems with the program, contact the author.
********************VD1:[307,105]README.TOO;2********************
********************VD1:[307,105]README.TOO;2********************
Notes on the Dual-Ported File-11 ACP Nov 81
The Dual-Ported Files-11 system enclosed here was not
included on a previous DECUS tape (although I mailed a copy
to anyone who asked for it) because my company made
occasional noises about trying to sell support for it. Since
it was developed for NASA, it is in the public domain and
can't be sold itself. This version is for RSX-11M version
3.2, it will soon be sort of obsolete. That is, unless no
code changes are made to F11ACP for RSX version 4.0.
Judging from past experience, (they changed the code between
3.1 and 3.2), F11ACP will undergo enough changes to make the
enclosed package obsolete.
The enclosed code is useless without the source to the
3.2 F11ACP, which is only available if you purchase a source
license. (The 3.1 version was easier to distribute because
the F11ACP source was included in the standard distribution
kit.) I can't give out the modified DEC written routines,
only SLP files to modify them, so you need the DEC source
for SLP to modify.
I hope by giving this software wider distribution
somebody else might pick up the ball and do the RSX 4.0
conversion. If you want to try, tell me, call or write, my
address is below. I will probably want it and I may be able
to help you with questions that come up. There's also the
chance that more than one person will want to do it, maybe
the work can be shared, so call me if you don't want to
duplicate efforts. I may not be able to do the conversion
myself, NASA may not be spending very much for contract
programmers next year (you know, budget cuts).
This code has been in daily use at NASA/Ames Research
for a few years now without any major problems. There may
be a few quirks. Occasionally unexplained things happen
such as after being mounted for a week with no down time,
the slave processor has trouble accessing the disk. But
dismounting the disk on the slave side, and remounting
it usually clears up any problems. But we haven't
corrupted a disk because of this software since the
debugging days (almost two years for the RSX 3.2 version).
Note that this code does nothing at the driver level to
implement dual-porting. A SLP file for the 3.2 DB driver
(RP04, RP06) (the one we use) is included as an example. I
also did a driver mod for DM's (RK06, RK07), but it worked
so poorly that I am not including it. I blame the RK06/7 hardware
design, the hardware people can blame me if they want, but I
don't recommend those disks for simultaneous dual-porting.
I haven't tried any of the other disks, but a glance at the RM03
documentation says it ought to work as well as the RP06.
Dan McCoy
(415) 965-6134
c/o Informatics Inc.
1121 San Antonio Road
Palo Alto, California, 94303
********************VD1:[307,105]README.1ST;1********************
********************VD1:[307,105]README.1ST;1********************
May 80
These files comprise the Dual-Ported Files-11 ACP (DPACP);
a modified version of F11ACP to support dual-ported hardware,
written by Daniel McCoy of Informatics Inc. on a contract to NASA.
A description of the individual files follows.
Documentation:
DPACP.RNO Design documentation for the software
and installation information.
PAPER.RNO A paper submitted to DECUS Fall 79
describing the development of the software
DPACP source and build files:
DPA.CMD Command file to build the ACP
COR.CMD Command file to run the SLP files
DPRE.MAC Macro prefix file for DPACP and ACPAUX
NTDAT.MAC DPACP source
NTSUBS.MAC " "
RQIO.MAC " "
ACCESS.COR SLP to turn F11ACP source from 11M V3.2
CLACC.COR into DPACP source for dual-porting.
CLCRE.COR " "
CLDAC.COR " "
CLNUP.COR " "
CRFIL.COR " "
DEACC.COR " "
DISPAT.COR " "
DLFIL.COR " "
DLMRK.COR " "
DIRBUF.COR " "
ENTNM.COR " "
EXTEN.COR " "
F11PRE.COR " "
FNDNM.COR " "
RMVNM.COR " "
TRUNC.COR " "
Auxiliary task (ACPAUX) source and build files:
AUX.CMD Command file to build the auxiliary task.
AUXMN.MAC ACPAUX source
AUXERR.MAC " "
AUXDAT.MAC " "
AUXINI.MAC " "
AUXIO.MAC " "
AUXDIN.MAC " "
********************VD1:[311,131]README.1ST;2********************
********************VD1:[311,131]README.1ST;2********************
This directory contains a copy of the slides for the
talk RSX11M Device Commons presented at the 1981 Fall DECUS
U. S. Symposium in Los Angeles. Also included are command
and source files which illustrate the use of RSX11M device
commons.
The talk was presented by James F. Harrison, MP-1, MS
828, Los Alamos National Laboratory, Los Alamos, NM 87545
(505) 667-5688 or (505) 667-5241.
********************VD1:[312,315]README.1ST;2********************
********************VD1:[312,315]README.1ST;2********************
Fall 1981 [312,315] Collection
There are several different programs here:
DISASM - from the RSX11D version from the DECUS library of a few
years back, but with the task readin section altered to
handle RSX11M task images. The disassembler reads and
displays disassemblies of task images. Some new code for
improving the readability of output files is included as
well. Note that DDT may be used as a symbolic patcher
in assembly language for task images on disk in the event
this tool points up some areas where change is wanted.
Outputs from DISASM are not directly compatible with
MACRO-11, though they may of course be edited.
CAM - another task disassembler from the Amsterdam DECUS tapes
(a concatinated file). Simpler to use, less features...
BASH11M - A program that will patch an RSX11M or RSX11M+ system
to allow tasks to enter a mode where they are run in
User mode with previous mode Kernel. (Can also restore the
system to normal). Only programs where initial PS is set
this way, or that bash the PSW on the stack during AST or
SST processing are so affected. This allows the MTPI/MFPI
or MTPD/MFPD instructions to access all of kernel space
including the I/O page, even for a nonprivileged task. Note
that if the initial PS is set to previous kernel via ZAP
of disk image after a task is installed, all RSX or IAS systems
run in previous kernel mode for awhile. However, SST or AST
processing can alter this. The patch ensures this state can
continue, or be entered from SST/AST. (In RSX11M+ even unpatched,
you can enter previous super mode by bashing a PS on the
stack in an AST.) A routine to enter previous kernel mode
is provided too.
Normal system operation is unaffected by these patches
and can continue indefinitely with them in place. For data
gathering activities, this access to I/O page can be
useful.
The package does no more to destroy system security than
installing a common in the I/O page does (since explicit PS
access can also get into this mode), but makes it easier to
access kernel structures and to use HOLs for privileged
tasks.
ALTWND - A subroutine providing access, on a system patched by
BASH11M, to anywhere in memory. This is somewhat specialized
and is designed to allow access for brief periods to buffers
"somewhere" without losing address space.
CSIOPS - A CSI parser skeleton in MACRO that gets a command line,
parses it, opens files, and returns with files open. Useful as
a skeleton for MACRO applications (with related routines in
GETSTR and GTLIN) where a command line parser is desired that
will do all the file opening overhead for you. Does not
have logic for wildcards, but can handle multiple input and
output files. Will need to be edited for any given application
however.
DDT22 - A revised DDT, with ability to work from another task or within
a task. Includes new logic to decompose internal symbols in
.STB files having them, and to pick them out by module name.
Also comes with a new FDTSYM that uses its method of output
of module name to disambiguate FORTRAN symbols for its symbol
table file output (3rd output) that DDT uses.
DDTKNL and DDTMU are the other parts of the package, for the
2 task DDT, and the DDTBLD file is updated and improved with
a few other improvements.
To use this feature with something real, a version of
FDTSYM (the FDT pre-processor) has been included that
will generate module names before the global symbol
records it creates. To access a symbol within a particular
module, set MDLCTL to -1 in DDT and fill in the 2 word
area named MODULE within DDT (using $UV if needed to
address DDT space, then $UM to address target space)
with the RAD50 representation of the module name
desired ("$'rad' enters "rad" in RAD50 at the open
location, for instance). Then the symbols will not
be displayed unless they are in the named module. Setting
MDLCTL to 1 only selects internal symbols this way, and
setting it 0 performs no module selection.
FDTSYM - A revised version of FDTSYM, the preprocessor for FDT,
which can create .STB files for use with DDT that have the
module names preserved for dis-ambiguation by DDT as
described above.
FLTIBM and IBMFLT - A pair of routines (.MAC for PDP11, .MAR for VAX)
which are FORTRAN callable to convert IBM to PDP11 floating
point (single precision) numbers or PDP11 to IBM. They are
valid FORTRAN functions, though they will work from assembler
also.
XMITR and ITTOUR - Two routines to update the version of XMITR submitted
in [312,315] in Spring 81. These remove a couple of extra
waits for significant event that slowed file transmission,
without turning XMITR again into a CPU hog.
FPEM - A new release of the RSX11M floating point emulator adapted from
the Los Alamos original for RSX11D. Differs from the old one
only in that it can use STOP instead of SUSEND, so can be run
with high priority in RSX11S systems.
This emulator does NOT require a sysgen and indeed assumes
RSX does not know about floating point. It must be immovable in
memory, which means fixing it AND placing it in a dedicated
partition or at the BOTTOM of GEN (to avoid movement by shuffling).
To use with F4P, you will have to replace F4PEIS in your
runtime system, as RSX will not give floating ASTs to any tasks
unless it thinks there is floating point. Tasks must be built with
the /FP switch, and RSX must NOT execute any floating point code.
If RSX executes F.P. code, the system crashes! So generate for
no FPU unless you have the hardware, and use this if you don't.
DSO and TRN - These tasks (DiSOwn and Task ReName) operate on all tasks
running at the TI: of the caller. TRN just renames all tasks
to unique names (guaranteed not to have embedded spaces in them
so they can be aborted from the console, a useful feature if
you use the modified MCR dispatcher for 11M+ in the Spring
81 tape) and leaves them at the console. This allows one to
run multiple copies of MAC, F4P, TKB, etc., without change
to RSX. It works on M or M+. Assemble and build as a normal
privileged task for each. DSO will also change names (though it
will assign different names from TRN), but it moves all tasks
except itself to CO: so you can log off without aborting any
disowned tasks. This will leave copies of AT. or PIN unable
to run any more tasks, of course, but normal tasks will work
fine (and the COLOG program can even log the task output!)
These programs are normally built with a 64 word
stack and priority 70; checkpointable if desired (I have them
checkpointable). They need SUPERMAC to assemble correctly;
see previous RSX SIG tapes for SUPERMAC. You can figure out
how to make straight MACRO easily though -- an exercise for
the reader...
FFL - This version handles label records up to 20 bytes long and
permits you to ignore tape errors. This is to read copies of
FLX tapes produced at installations incapable of making 14
byte label records (e.g. the Structured Languages SIG's).
LISTRS - This new version of LST, the multi-column listing utility
adds a switch to permit output to be right shifted on the page
by up to 31 columns, to give a right margin to it.
BIGTPC.DOC - Documentation for BIGTPC (and a version merging Phil
Stephenson's corrections to TPC with the other versions)
as suggested by Phil Cannon in Spring 81.
[312,316] PLOTA
PLOTA is a plot package to plot histograms (or more primitive
objects) on either HP 4 or 8 color plotters and/or Printronix
printers with the aid of PLXY11 (available separately from DEC).
Calls are very simple and permit linear or log plots,
with numerous options, of positive integers. Scales, colors, etc.,
are all user settable. A runtime assigmnent can determine whether
the plot goes to Printronix (LXY11) printer (in B&W) or to
the HP color plotter. Compatible device independent calls are
provided.
Glenn C. Everhart
********************VD1:[312,316]README.1ST;1********************
********************VD1:[312,316]README.1ST;1********************
** EDITORS NOTE **
This UIC is documented in [312,315]
********************VD1:[312,317]README.1ST;1********************
********************VD1:[312,317]README.1ST;1********************
TREAD/TWRITE SUBROUTINES
TREAD/TWRITE SUBROUTINES
INSTALLATION GUIDE AND RELEASE NOTES
VERSION 3.02A
AUTHOR: FRANK J. MANION
CHI COMPUTER HORIZONS INC.
1050 KINGS HIGHWAY NORTH
CHERRY HILL, N.J. 08034
(609)-779-0911
TREAD/TWRITE SUBROUTINES PAGE 2
1.0 PREPARING FOR INSTALLATION
To install the TREAD/TWRITE subroutine system you should first log
in to your computer under any account. Then simply use FLX to copy
all files on the distribution tape to your account.
Before you attempt to install the subroutines, the macro assembler
and the librarian program should be INStalled on your system.
2.0 INSTALLATION
To install the TREAD/TWRITE system, YOU MUST RUN THE INDIRECT COM-
MAND FILE "TRWGEN". This file will automatically create an assembly
prefix file used in the assembly of the TREAD/TWRITE system. This
prefix file is not present on the distribution tape, hence you must
run the command file. To run the file, simply type "@TRWGEN". I sug-
gest that you run the file once with the /NOMCR switch to familiarize
yourself with the command file before you actually try to install the
subroutines. The command file is self documenting and needs no furth-
er explaination here. Plase note that all files created by the ins-
tallation process take the account that you are currently logged in to
as the default input and output account (i.e. files are searched for
and created under the current account and no other).
3.0 DISTRIBUTION FILES
The following is a list of files found on the distribution tape.
TREAD.MAC is the source code for the TREAD/TWRITE subroutine sys-
tem.
TREAD.DOC is the users guide to the subroutine system. It should
be printed and read thoroughly before you attempt to use the routines.
The entire manual up to and including appendix a is of intrest to any-
one using the routines. Appendix b to the end of the manual are of
intrest to the advanced user/programmer primarily.
TREAD.RNO is a copy of the users guide (TREAD.DOC) in RUNOFF for-
mat.
TREAD/TWRITE SUBROUTINES PAGE 3
ASTOEB.MAC is the ASCII to EBCDIC translation subroutine used by
the TREAD system.
EBTOAS.MAC is the EBCDIC to ASCII translation subroutine used by
the TREAD system.
TRWGEN.CMD is the MCR indirect command file used to create the as-
sembly prefix file TREADPRAM.MAC, and to assemble the TREAD system.
TREADPARM.MAC is created by the file TRWGEN.CMD. This is the as-
sembly prefix file. This file is not on the distribution tape, but is
created only by running TRWGEN.
README.1ST is this file.
README.RNO is the run-off version of this file.
COPYMT.FTN is a FORTRAN program which uses the TREAD/TWRITE system
to copy magnetic tapes written in IBM RECFM=FB format (all tapes read
and written by TREAD/TWRITE are in this format). The program allows
users to specify nearly all options possible (i.e. file number, la-
beled or unlabeled, density, etc.) for magnetic tape input and output.
Two tape drives are needed to run the program. The program COPYMT can
copy any such tape up to one containing input blocks of data about
22000 bytes in size. The program is rather self explanatory, and it
is also a fair example of how to use the subroutines.
MAKBUF.MAC is a macro subroutine needed by COPYMT.
4.0 COMPATIBILITY WITH IAS/RSX11D
The TREAD/TWRITE system was written for an RSX11M system. I have
been unable to test it on an IAS or 11D system, but I assume it would
work on those systems with little or no modification.
5.0 GENERATING THE TASK "COPYMT"
To compile and link the task COPYMT, do the following:
1. FOR COPYMT,LP=COPYMT/NOSN
2. MAC MAKBUF,LP=MAKBUF
3. TKB MAKBUF/CP,LP=COPYMT,MAKBUF,LB:[1,1]SYSLIB/LB:$SHORT
TREAD/TWRITE SUBROUTINES PAGE 4
4. TKB OPTIONS: UNITS=3,ACTFIL=1,MAXBUF=80,ASG=TI:3
********************VD1:[314,1]README.1ST;2********************
********************VD1:[314,1]README.1ST;2********************
**** SUMMARY OF CHANGES FOR VERSION 23 OF RSX RATFOR:
THIS RATFOR IS SUPPORTED BY THE STRUCTURED LANGUAGES WORKING GROUP OF
THE RSX SIG.
BUGS FIXED:
# PCN #118, 22 JUN 81, FIX BUGS RE OPEN & CLOSE IFDEF/IFNOTDEFS
CHANGES,FEATURES:
# PCN #112, 20 JUN 81, ADD <CR> TO END OF SPAWN CMD LINE TO GET > BACK.
# PCN #113, 20 JUN 81, CHANGE REAL TO I*4 IN 'DAYS'. DELETE 'REALCODE'SYMBOL
# PCN #114, 21 JUN 81, REPLACE STRGET WITH GETIN TO SPEED UP INPUT IN GETLIN
# PCN #115, 21 JUN 81, REPLACE STRGET WITH GETIN IN DUMPIT & DMPIDX
# PCN #116, 21 JUN 81, DELETE CPRTLN FROM DEFLST AND USE LOCAL BUFFER INSTEAD
# PCN #117, 21 JUN 81, FIX LISTING OF PROCESSOR FEATURE KEYWORDS TO ALLOW LOWER CASE
# pcn #119, 11 JUL 81, DELETE SYMBOL 'OPENCLOSE' & USE OF CALL ASSIGN,FDBSET
# PCN #120, 12 JUL 81, CHANGE GTOK TO ALLOW PERIODS (DECIMAL POINTS) TO BE
PART OF TOKENS, NOT SEPERATE TOKENS. THIS ALLOWS
PERIODS TO BE USED AS PART OF SYMBOLIC CONSTANTS
AND DEFINITIONS.ALSO, RAD50 TASK NAMES (/6R...PIP)
NO LONGER NEED BE PROTECTED WITH %.
# PCN #121, 12 JUL 81, ALLOW " AND ' AS PART OF THE FILE SPECIFICATION FOR
INCLUDEs IN ORDER TO BE COMPATIBLE WITH OTHER VERSIONS
OF RATFOR FROM THE UNIX WORLD.
# PCN #122, 3 AUG 81, IF UNABLE TO FIND AN INCLUDE FILE, REPORT IT'S NAME TO USER
# PCN #123, 3 AUG 81, TRUNCATE FULL LINE COMMENTS AT COL 72 SO FORTRAN IV
DOES NOT GET UPSET WITH LINES > 72 COL.
NEW ROUTINES:
An alternate and faster version of STRPUT is included as a seperate file
which you can use to replace the standard strput in STRLIB if you want another
6% overall speed improvement. Read the comments in STRPUT.RAT.
CLOSE subroutine is added as an interface the the operating system's
file close mechanism. CALL CLOSE now calls this subroutine instead of
the RSX CLOSE routine directly.
OPNIN & OPNOUT are provided with versions of the OPEN statement
that implements BIG BUFFERING for RSX systems that support it (M+ by
default supports it, M if you build it that way). You must also change
TKBRATFOR.CMD to allow 15 extra FCS buffers (this adds 8kb to your task
size). Big buffering speeds up the pre-processor by 7-8% (on RP06s).
The new symbol DISK_BLOCKSIZE is defined in RATRSX and used in OPNIN &
OPNOUT. If you want big buffering, define it as > 512. If not, define
it as 512 to get regular buffering. It must be defined as something.
See the I/O Operations Manual, Chapter 2.
QUICK BUILD INSTRUCTIONS:
(SEE BLDRATFOR.CMD, A RSX11/M INDIRECT COMMAND FILE THAT DOES THE WHOLE
THING, FOR MORE INFO).
SEQUENCE IS THE SAME FOR BOTH RSX11/M AND /D BUT A COMMAND FILE THAT DOES IT
ALL IS AVAILABLE FOR /M.
COMMAND FILES SUPPLIED ARE FOR FORTRAN IV V2, BUT ONLY MINOR MODS ARE NEEDED
FOR F4P; SEE F4PRATFOR.CMD AS A SAMPLE.
COMMAND FILES ASSUME A DUMMY DEVICE NAMED XX0:. ASSIGN THIS WHEREVER YOU
WANT BEFORE BUILDING.
THE FIRST TIME, RATFOR IS BUILT FROM THE .FTN FILES ON THIS TAPE, AFTER THAT,
WITH A WORKING VERSION OF RATFOR, YOU CAN RATFOR THE .RAT FILES TO CONFIGURE
THINGS THE WAY YOU WANT IT.
FIRST TIME YOU BUILD RATFOR--
MOVE EVERYTING ON THIS TAPE INTO UIC OF YOUR CHOICE.
GIVE MCR THE FOLLOWING-
FOR @FORRATFOR OR F4P @F4PRATFOR
FOR @FORSTRLIB
LBR @LBRRATFOR
LBR @LBRSTRLIB
TKB @TKBRATFOR
INS RATFOR
AFTER THE FIRST TIME--
ADD :
RAT @RATRATFOR
BEFORE THE FIRST LINE ABOVE.
EDIT TKBRATFOR.CMD FOR RESIDENT LIBRARIES OF YOUR CHOICE.
IF YOU HAVE PROBLEMS, CALL
DAVID P SYKES
Brown Boveri Compuguard
4709 Baum Blvd
Pittsburgh, PA 15213
(412) 622-6200
GOOD LUCK
********************VD1:[315,100]README.1ST;1********************
********************VD1:[315,100]README.1ST;1********************
This directory contains a number of utilities and subroutines
which are likely to be of interest to a substantial proportion
of the RSX/IAS community. The submission is oriented towards
IAS, but much of the software will run on RSX-11M or RSX-11D
with minimal to no changes. Where possible, software restricted
to IAS is noted as such in the below list. The major submissions
in the directory are:
Complete programs
ADDBAD - Adds bad blocks to the bad block file (BADBLK.SYS) without
requiring volume re-initialization.
AFT - Prints all of the file names on a volume modified after
a specified date. This was originally written when we
had a disk hardware problem and wanted to recover as
many files as we could from a rather corrupted disk.
ASG - This task will reassign the logical unit numbers of a
task image without requiring the user to re-taskbuild
with different ASG directives in the command file.
ASN - This IAS-only task implements assignable logical devices
for IAS similar to the VAX/VMS ASSIGN command or the
RSX-11M ASN command.
BLK - Locates the file which has a specific physical block
allocated. Useful when there is a block showing up as
bad in the error log which can be removed from circulation
by moving the file and running 'ADDBAD' on the block.
CANALL - This IAS/RSX-11D only task will cancel all of the copies
of a multi-user task on all terminals in the system.
COMP - Compares two files on a block-by-block basis rather than
the line-by-line basis used by CMP.
COR - This is an IAS/RSX-11D package to take postmortem task
dumps in a manner similar to the postmortem system dump
provided by CDA. It also uses a patch to .TKTN. with a
subroutine named DMPCOR. This is the same program which
was submitted to an earlier DECUS tape, updated to run
under IAS V3.1 to use the new Executive data structures
properly.
CPY - Copies files 63 blocks at a time for a faster transfer
than PIP provides.
DAC - Sums up the disk space used by each UIC on the disk.
DELFID - Removes a file by file ID even if the file has a bad file
header. This allows such files to be deleted without
having to ZAP the INDEXF.SYS file manually or running DSC.
DUMPCORE - An IAS/RSX-11D task which will dump the memory of a
running task. This was originally written by Ray French,
and the current version is modified to be able to run with
the "COR" package noted above.
DVL - An IAS/RSX-11D only task to display device information.
EXEMCR - An RSX-11D only task to execute an MCR command line.
FIL - A utility which tries to reconstruct locked files.
FRG - Prints out disk space fragmentation information.
This is a corrected and enhanced version of the FRG
which was on the DECUS tape some time ago.
GREP - A utility for locating search patterns within a group
of files. This is a much enhanced version of the GREP
which appeared in an earlier DECUS tape.
IRF - This IAS/RSX-11D task will attempt to gracefully exit
a task which has an I/O rundown failure.
MCM - This IAS-only task sets the terminal into real MCR mode
(not the MCR mode in PDS).
MCX - This IAS-only task is a companion task to MCM to return
the terminal to DCL.
MUNG - This IAS-only task is a companion task to the ASN task
mentioned above.
PRECIS - This is an enhanced DMP-like utility which produces a
more useable listing.
READTAPE - This allows fast reading of magnetic tape by using
large buffers and multi-buffering the drive. The full
benefit of this is probably not felt under RSX-11M, but
would be under systems supporting multi-buffering (IAS,
RSX-11D, and RSX-11M/PLUS (?))
SPW - This IAS-only task will monitor the progress of the
despooler in printing your file.
STAT - This IAS-only task uses the CRT to produce a bar graph
detailing system usage.
STF - This IAS/RSX-11D task is an MCR command line stuffer task.
SUPERWHO - This IAS-only task displays system users on the CRT.
TAPEIMAGE - This task allows disk images to be moved between
non-ANSI magtapes, files, and Foreign disk volumes.
TAPUTL - Installed with various names, this task will allow the
user to manipulate a non-ANSI magtape by rewinding it,
spacing forward, backward, etc.
TMR - This IAS-only task will time the execution of a target
task and print out a summary of where it is spending
its time for performance improvement or monitoring.
TPC - A task to copy magnetic tapes, EOF marks and all.
This is a corrected and enhanced version of the TPC
which has appeared in the DECUS library before.
TRANSLATE - RT-11 supports ANSI magtape but it produces a format
which isn't palatable to RSX/IAS systems. This program
will convert a file transferred from an RT-11 magtape
into something useful on a Files-11 system.
UNDELETE - This task will undelete a file under certain restrictions.
USP - This IAS-only task will unspool a line printer without
requiring that the SP0: device be dismounted.
UTX - This IAS-only task is a modification of the same task
which appeared on an earlier DECUS tape to use the screen
formatting package.
VOL - This allows modification of disk volume names and other
characteristics.
WHO - This IAS-only task is an enhanced version of a program
submitted to an earlier DECUS tape to display terminal
usage.
Subroutine library
BIOMAC - This is a set of structured programming macros.
CTLIMP - This subroutine sets a file to carriage control implied
for the FOR compiler.
DELETE - This subroutine will delete a file from a Fortran program
compiled with the FOR compiler.
DIRDL - This executes a directive with retries on nonexistant pool
space. It is used by many of the above tasks.
MTYPE - This subroutine returns the machine type. It is currently
written for IAS but modifying it to run on RSX-11M should
be trivial. It is used by some of the above tasks.
NOLOCK - This subroutine will notify FCS not to lock a file on
abnormal termination of a program compiled with the FOR
compiler.
PRFCS - This subroutine prints the FCS or DSW error code for an
error. It is used by many of the above tasks.
PRTIME - This subroutine returns a character string giving the
current date and time. It is used by many of the above
tasks.
RFILN - This subroutine will read the characteristics of a file and
obtain its name, which it returns as a string. It is used
by many of the above tasks.
SCRPKG - This is a screen formatting package which allows terminal-
independent screen addressing. It is patterned after the
package on the VAX and on a package on the PDP-11 which
requires that the calling program be written in PL/I. This
will work with almost any language, and is used by some of
the above tasks.
SPOOL - This is a subroutine to spool a file to the printer from a
program compiled with the FOR compiler.
PRINT - This is a subroutine which makes printing readable output
from an assembler subroutine or program less painful. It
takes care of all conversion problems and calling the
appropriate QI/O system services.
YMPRINT - This is the macro which sets up the call to the PRINT
subroutine.
********************VD1:[315,111]README.1ST;1********************
********************VD1:[315,111]README.1ST;1********************
Triangle RUNOFF
This is a copy of the version of RUNOFF as modified by the Triangle
LUG (primarily Jon Berntsen and Henry Tumblin). Note that it has
been much modified from the original DECUS RUNOFF, and includes
many new features, including the ability to include files within
a RUNOFF document. The code quality has been somewhat improved
(including removal of all self-modifying code, so it can be built
with a sharable pure area on those systems supporting that feature
-- e. g., RSX-11D, IAS, and RSX-11M/PLUS).
This version has been distributed to many sites but has never been
put on a DECUS tape. It is rumored to work properly on just about
any DEC PDP-11 type operating system, including VAX/VMS and RSTS,
though I don't think it will run under RT-11. Command files are
provided to create an executable version of the program; anyone
doing this should edit the file RNPRE.MAC beforehand to specify
things like machine type and operating system. The current version
is dated August 1980, and has not had major enhancements since that
date although there have been many bug fixes.
This is not officially supported by the Triangle LUG although there
are a number of sites interested in the program and we would be
interested in hearing about any bugs which anyone encounters, but
make no commitments to fixing any of them. Send any bugs or new
features to
Jon H. Berntsen, Ph. D.
Project Engineer
Rockwell International
800 Eastowne Drive Suite 200
Chapel Hill, North Carolina 27514
There are some task images provided in this directory; these
will run correctly under RSX-11M V3.2, so rebuilding may not be
necessary for this system. Since they were created at the
Rockwell site, they probably reference FCSRES, so if your system
does not use FCSRES they will not run and you will have to build
the program again anyway.
Good luck.
Bruce C. Wright
********************VD1:[330,1]README.;1********************
********************VD1:[330,1]README.;1********************
T H E B E S T O F I C R
= = = = = = = = = = = =
Bob Stodola
Bill Cael
Bill Wood
This tape contains release 2 of "The Best of ICR", a selection of
useful programs from the Institute For Cancer Research. The tape is in
DOS format at 800 BPI. Each UIC contains a README.1ST file; you can
copy these files to disk by saying,
MCR FLX SY:=MM0:[*,*]README.1ST/DO
Almost all of the programs have been revised in one way or another
since the last release to fix bugs or add capability. Following are
some random notes:
1. The bug in the RSX subtasking subroutine, RUNSYSRSX, which was
distributed on the Spring 1981 RSX/IAS sig tape has been fixed.
This means that programs that do subtasking such as CPL,
SRDCMD, and TRU should work now on RSX systems.
2. Most of the programs may be linked with a resident library to
make the tasks smaller.
3. When building the programs, be sure to read each one into its
own UIC to avoid file name conflicts (for instance RATFIV's
IO.RAT is different than LIST's IO.RAT).
4. When building FDT on RSX systems, be sure to uncomment the line
in FDT.MAC which defines RSX11M.
5. On IAS, programs which do subtasking (TRU, CPL, SRDCMD, and
LIST when using SRD to select files) require subtasking privi-
leges, and XEQ requires the chain privilege.
6. [330,3]CPL will run on RSX or IAS systems; however the build
command file is for IAS and must be modified for RSX, which
should be straightforward.
7. The version of SRD on [330,5] has been substantially debugged
since the last release and has none of the horrible SRD bugs
mentioned on SIG tapes and at the Fall 1981 convention. When
building SRD, ignore the task builder diagnostics.
8. BURSTF now handles files with characters in columns 73-80.
Page 2
A short description of each program on the tape follows:
[330,1]: LIST - LIST is like the TYPE and GREP commands only
better. LIST's simplest use is to display lines from a file a
screen at a time, however it has sophisticated string search-
ing, can be positioned randomly in the file, and can write por-
tions of the file to disk. In addition, LIST can use SRD to
select multiple files, making it easy to do such chores as
searching through a group of files for a particular string or
variable. Useable on RSX or IAS.
[330,2]: FDT - Number one on the RSX and IAS menus was a Fortan
symbolic debugger. Here it is! RSX or IAS.
[330,3]: CPL - CPL compiles modules in any language if the source
has been changed since the last compilation. It handles
multi-pass compilers, including RATFIV, Swedish and NBS Pascal,
and Whitesmith's C, as well as single-pass compilers such as
F4P, BASIC+2, and MACRO. A must for software developers. RSX
or IAS.
[330,4]: SRDCMD - SRDCMD is a flexible command line generator which
spawns SRD to select files, then writes command lines con-
structed from specified text and the device, uic, name, exten-
sion, and version fields of the selected file names. RSX or
IAS.
[330,5]: SRD - An enhanced version of SRD including more powerfull
file string matching, selection by file revision date, and sto-
rage allocation summary. RSX or IAS.
[330,6]: TAPE - TAPE reads and writes tapes in a variety of for-
mats, including blocked ASCII, blocked EBCDIC, and DEC-10 copy
format. RSX or IAS.
[330,10]: BURSTF - BURSTF bursts Fortran subroutines, functions,
main programs, and block datas from a file and writes them to
individual files. RSX or IAS.
[330,11]: RESEQ - RESEQ resequences the statement labels in a For-
tran program. RSX or IAS.
[330,12]: TRU - TRU truncates files, but does not access the file
if it doesn't need truncation. This is a must when using BRU
for incremental backup, as BRU would copy all files which had
been truncated with PIP, even if the file hadn't needed trunca-
tion. RSX or IAS.
[330,13]: XEQ - XEQ runs programs. It maintains a global common
area which contains, for each user, a list of directories to
search when XEQ trys to run a program. Never again will you
have to type XX0:[100,222] when running XX0:[100,222]FOO! In
addition, XEQ can pass a command line to the program it in-
vokes, whether or not the program is installed. IAS only.
Page 3
[330,14]: SCHEDULE - SCHEDULE will invoke MCR command lines at
scheduled times during the week. The list of commands and
times is maintained in a file. IAS but easily modified for
RSX.
[330,14]: GAME - GAME uses SCHEDULE to restrict game playing to
specified times. IAS and RSX (see SCHEDULE).
[330,14]: RUNNL - RUNNL is a companion program to SCHEDULE and
GAME. It will run a task on the pseudo device NL. IAS only.
[330,15]: RATFIV Version 2 - an enhanced and debugged version of
the Software Tools Group's Ratfor compiler, Ratfiv features op-
tional Fortran 77 output, the SWITCH and STRING statements, a
powerful macro processor with macro argument capability, condi-
tional compilation, output of string literals as quoted strings
(necessary for OPEN statements, etc.) or optionally as holler-
ith strings, and specification of FORMATs within READ, WRITE,
ENCODE, and DECODE statements. RSX or IAS.
[330,16] (IAS): MTREK - The best Star Trek ever, this is a
multi-terminal real-time all out war game, replete with torpe-
does, tractor beams, anti-matter, etc. This program was origi-
nally written at Boeing; we have enhanced and debugged it.
Terminals with clear screen and cursor positioning are all
that's required. IAS or VAX, but you could modify it for RSX.
We would like to hear of any problems or comments you have.
Robert K. Stodola, Bill Cael, and William P. Wood, Jr.
Computer Center
The Institute for Cancer Research
7701 Burholme Ave.
Phila., Pa. 19111
(215) 728 2760
********************VD1:[330,1]README.1ST;1********************
********************VD1:[330,1]README.1ST;1********************
LIST File Listing Utility
=========================
LIST is like the TYPE and Unix GREP commands only better. LIST's
simplest use is to display lines from a file at the terminal, usually
a screen at a time. It has sophisticated string searching and can
write out portions of files to disk. File names to be listed may have
wild card characters in them, making it easy to do such chores as
looking through a group of files for a particular string or variable.
Finally, LIST can be positioned randomly in a file using line (record)
numbers.
LIST is very fast, as it uses a macro interface to the file sys-
tem to read and write files; in addition it buffers the disk address
of every 100 lines to simulate random access on the file.
LIST is available for VAX VMS systems and RSX/IAS systems. The
VAX VMS version runs in native mode. There is no help file for VAX
VMS yet, however a comprehensive user manual, LIST.DOC, is included in
both distributions. The VAX VMS version also includes a command file,
MAKELIST.COM, which uses LIST to rewrite a carriagecontrol NONE file
as a carriagecontrol LIST file, and a command file, SEARCH.COM, which
uses LIST to search through files for a given string.
On RSX/IAS systems, SRD is used to select wild card file names.
The routine which gets file names from SRD is called FNDFIL.FTN; if
for some reason SRD doesn't work with LIST (if your SRD has a differ-
ent output file format from our SRD, for instance) then modify this
file. If you would rather use PIP than SRD, there is a file called
PIPFIL.RAT (and also PIPFIL.FTN) which contains the FNDFIL subroutine,
but for PIP. A help file is included (LIST.HLP) and should be placed
on LB:[1,2].
LIST is written almost entirely in Ratfiv; on RSX/IAS systems,
the .FTN files are included, however the Ratfiv compiler is also in-
cluded on this tape, and should be very simple to build. On VAX VMS
systems, LIST's .EXE file is included, as is the Ratfiv source and the
Ratfiv compiler.
To build LIST for VAX VMS, say
@BUILD
To build LIST for IAS, say
@IASBUILD
To build LIST for RSX-11M, say
@RSXBUILD
Page 2
To build LIST for IAS multi-user systems use IASBUILD.CMD, but substi-
tute the object code produced by RUNSYMU.FTN for that produced by RUN-
SYSIAS.MAC in the file IASTKB.CMD.
Send comments, problems, etc. to:
William P. Wood, Jr.
Computer Center
Intstitute For Cancer Research
7701 Burholme Ave.
Philadelphia, PA. 19111
(215) 728 2760
********************VD1:[330,2]README.1ST;1********************
********************VD1:[330,2]README.1ST;1********************
F D T
=====
This UIC contains the ICR FORTRAN IV Plus Symbolic debugger. It
is designed for IAS, but should also work under RSX-11M if you uncomment
the line which defines RSX11M in FDT.MAC. Please read FDTEXP.DOC for more
information.
If you have problems, corrections or comments please contact:
Robert K. Stodola
Computer Center
The Institute for Cancer Research
7701 Burholme Ave.
Philadelphia, PA 19111
215 728-2760
********************VD1:[330,3]README.1ST;1********************
********************VD1:[330,3]README.1ST;1********************
CPL
---
CPL is a utility which compiles your programs in a compiler independent
manner. It alleviates the headache of having to remember the syntax quirks
of all the compilers on your system. CPL also aids in the maintenance of
programs consisting of many modules since it compiles files based on the
dates of the source and object files and maintains a user library.
Features include:
The same command line syntax is used for all compilers.
CPL selects the compiler to use based on filename extension.
CPL will only compile a given file if the source file post-dates
the object file.
User library maintenance. CPL will replace in the users library
only those files on a command line which were actually compiled.
Multiple pass compilations are done with a single command line.
Implementation of prefix files in a compiler independent manner.
Compilers supported in the current implementation:
FORTRAN 4 PLUS
MACRO
BASIC PLUS 2
RATFOR
NBS PASCAL
SWEDISH PASCAL
WHITESMITHS C
Refer questions to:
William F. Cael (215)-728-2760
Institute For Cancer Research
7701 Burholme Ave.
Phila., Pa. 19111
********************VD1:[330,4]README.1ST;1********************
********************VD1:[330,4]README.1ST;1********************
SRD command line generator
==========================
SRDCMD generates command lines which contain file names selected
by SRD (or PIP - see below). For example, the following SRDCMD com-
mand generates command lines to copy all files created today to UIC
[6,120]; the command lines are written to the file T.CMD:
SRDCMD> *.*/DA COPY 'N'E [6,120]*.* >T
The string 'N'E specifies that the name and extension of each file
name be expanded at that point in the command line. Version, UIC, and
device information can also be placed anywhere in the command line.
For further information, see SRDCMD.DOC.
The routine which gets file names from SRD is called FNDFIL.FTN;
if for some reason SRDCMD doesn't work correctly (if your SRD has a
different output file format from our SRD, for instance) then modify
this file. Another alternative is to build the version of SRD includ-
ed on this tape, which is an enhanced and debugged version. If you
would rather use PIP than SRD, there is a file called PIPFIL.RAT (and
also PIPFIL.FTN) which contains the FNDFIL subroutine, but for PIP.
SRDCMD is written almost entirely in Ratfiv; the .FTN files are
included, however the Ratfiv compiler is also included on this tape,
and should be very simple to build. (See README.1ST on the Ratfiv
compiler directory.)
To build SRDCMD for IAS, say
@IASBUILD
To build SRDCMD for RSX-11M, say
@RSXBUILD
To build SRDCMD for IAS multi-user systems, use IASBUILD.CMD, but sub-
stitute the object code produced by RUNSYMU.FTN for that produced by
RUNSYSIAS.MAC in the file IAS.TKB.
Send comments, problems, etc. to:
William Wood
Computer Center
Intstitute For Cancer Research
7701 Burholme Ave.
Philadelphia, PA. 19111
(215) 728 2760
********************VD1:[330,5]README.1ST;1********************
********************VD1:[330,5]README.1ST;1********************
SRD
----
This is an enhanced version of SRD.
Enhancements include:
1. The selection string wild character '*' will match any
string or the null string.
A*B.* will match AB., AAB.FTN etc.
2. A /RV[:date] switch which will select files by revision date.
It may be combined with /BE, /AF.
3. A /SU switch which will give a storage allocation summary
for files selected.
4. A /OW[:selectionstring] switch which will select files by
owner. The selection string syntax is the same as file
selection strings. The wild characters '?','*' may be used.
/OW:[2??,1*] will match [200 thru 277,1],
[200 thru 277,10 thru 17],
[200 thru 277,100 thru 177].
5. The haunting directory write back bug has been fixed.
6. The /NE switch now applies to all other selection criteria
not just /SE.
Building SRD:
For RSX11M delete the definition of IAS in SRDPRE.MAC
and edit the command files.
Also you may build an overlaid version (saves about 2k) by editting
SRDBLD.CMD to include SRD.ODL (ignore task builder diagnostics).
@SRDEXP
Direct questions to:
William F. Cael (215)-728-2760
Institute For Cancer Research
7701 Burholme Ave.
Phila., Pa. 19111
********************VD1:[330,6]README.1ST;1********************
********************VD1:[330,6]README.1ST;1********************
TAPE instructions.
------------------
Tape is designed to run under version 3.00 of IAS on a PDP-11/70. On an
IAS system it may be linked using the command file EXPORT.CMD. This program
has not been tested on an RSX-11M system, but should require little or no
modification. The command file RSXBLD.CMD may build TAPE correctly under
RSX-11M, but this also has not been tested. Note that the build files assume
that the FORTRAN-IV Plus library is in the system library. Begin by copying
all files to the system disk. NOTE: QIOSYS.FTN MUST BE PUT ON [1,1] AND
ALL OTHER FILES ON [22,11] TO COMPILE CORRECTLY.
One known bug exists: the number of lines read or written is an integer*2
variable, so it will report the incorrect number of lines if the file is
larger than 32767 lines. The file should be read/written correctly, however.
If you have problems, corrections or comments please contact:
Robert K. Stodola
Computer Center
The Institute for Cancer Research
7701 Burholme Ave.
Philadelphia, PA 19111
215 728-2760
********************VD1:[330,10]README.1ST;1********************
********************VD1:[330,10]README.1ST;1********************
BURSTF
BURSTF bursts the subroutines, functions, programs, and
block datas in a FORTRAN source file into their own
individual files.
To build Burstf, do
@BUILD
Documentation is in the file BURSTF.DOC.
Send comments, problems, etc. to:
William P. Wood, Jr.
Institute For Cancer Research
7701 Burholme Ave.
Philadelphia, PA. 19111
(215) 728 2760
********************VD1:[330,11]README.1ST;1********************
********************VD1:[330,11]README.1ST;1********************
RESEQUENCE
==========
This program resequences statement numbers in FORTRAN IV-PLUS
programs. See RESEQ.DOC for more detail.
********************VD1:[330,12]README.1ST;1********************
********************VD1:[330,12]README.1ST;1********************
TRU
===
TRU truncates files. Though PIP will also truncate files, PIP will
change the revision date on all files specified, even if they did not
require truncation. This will cause an incremental backup program (such as
BRU) to needlessly backup files which have not been changed. TRU first
ascertains whether or not a file requires truncation before invoking
PIP to actually do the truncation.
NOTE: THIS PROGRAM REQUIRES THAT A SCRATCH DIRECTORY LB:[12,1]
BE AVAILABLE TO ALL USERS.
This program runs under IAS v3.0. To use under RSX-11M, replace
the object runsys.obj with the object produced by runsysrsx.ftn.
To use under multi-user IAS systems, replace the object
runsys.obj with the object produced by runsymu.ftn.
********************VD1:[330,13]README.1ST;1********************
********************VD1:[330,13]README.1ST;1********************
XEQ
===
XEQ is like the RUN command, except that it will search
one or more directories to find the program you wish to run,
and then chain to that program. You may tell XEQ which
directories to search; once you have done so, you need not
do it ever again unless you wish to change the search
directories. For example, if LB:[100,100] was in my search
path, I would only have to type:
XEQ PROGRAM
to run LB:[100,100]PROGRAM, even if my default directory was
not LB:[100,100].
XEQ is also able to pass a command line to the program
it invokes. This feature is very useful for users who don't
have the privilege to install tasks, as it allows them to
pass command lines to their programs from the terminal, or,
most importantly, when the program is executing in a command
file. Also, pool space is saved by XEQing programs rather
than installing them. Uninstalled programs can be stored on
a common task UIC and XEQ'ed when needed provided the UIC is
in your search path.
XEQ's list of search directories is maintained for each
user in an installed global common area, XEQCOM. Currently
there is room for up to 256 users and 380 search directories
in XEQCOM, which is about 8K words long. The common area
may be enlarged or decreased by modifying the symbolic
parameters in XEQCOM.COM.
XEQ needs to be able to find out who is running XEQ to
look up the correct search path. A program, WHOIST, is
included on this directory which is mapped to IASCOM.
WHOIST waits in a swapable stop state until it gets a
request for a user's name from XEQ through the WHOZON
subroutine.
The three parts of XEQ (XEQ itself, XEQCOM global
common, and .WHO.) may all be built by saying @BUILD. You
will probably want to move XEQ and WHOIST to your system
task directory and XEQCOM to your shared library directory
after building them.
A test program, ECHO, is built by the BUILD file to
test XEQ. ECHO echoes command lines. In order to receive a
command line from XEQ, a program such as ECHO must be linked
with a routine, RECCML, which is included on this directory.
RECCML's calling sequence is like the calling sequence for
GETMCR. However ECHO illustrates the use of a more general
Page 2
routine, GCMD, which attempts to get a command line first
from MCR using GETMCR, then, failing that, from XEQ using
RECCML, and failing that, from the terminal, using a
user-specified prompt. Thus programs which use GCMD can get
their command lines from MCR if they are installed, as well
as from XEQ or the terminal. You should look at ECHO.RAT if
you want to use GCMD. GCMD is located in the support
library, and it's source is in GETARG.RAT.
The file XEQ.HLP is a user help file which should go in
your system help file. It explains how to tell XEQ your
search path. One command is not described in XEQ.HLP; this
is the /PEEK command, which causes XEQ to print the name of
each user, his/her search path, and the index of that user
in XEQCOM. The output from /PEEK may be redirected to a
file if FILE is specified after /PEEK, for instance:
XEQ/PEEK PATH.LST
XEQ is IAS specific.
To build XEQ, do
@BUILD
Documentation is in the file "XEQ.HLP". Note that users of
XEQ must have the privilege to chain to another task.
Send comments, problems, etc. to:
William Wood
Institute For Cancer Research
7701 Burholme Ave.
Philadelphia, PA. 19111
(215) 728 2760
********************VD1:[330,14]README.1ST;1********************
********************VD1:[330,14]README.1ST;1********************
This UIC has three programs for IAS.
The GAMe command allows a common interface to games. Used in
conjuction with the SCHEDULE program, it also allows the system manager to
restrict game playing to specified hours.
See GAME.DOC for more information.
RUNNL is a program which will spawn a task on the privileged TI of
device NL0. In order to use, you must have included this device in your
SYSGEN command file, though it need not have any device handler associated
with it. RUNNL handles all task scheduling requests sequentially, and
will not schedule a second task until the first has exitted. Where possible,
therefore, tasks which may take more than several seconds should be started
by spawning ...RUN with a command line to run the desired task.
See RUNNL.DOC for more information.
The program SCHEDULE allows a system manager to schedule tasks to
be run at specified times and days. For example, you may schedule a
timesharing parameter be changed each weekday at 08:00, and again at 18:00
on weekdays, or that a file be printed each saturday at 20:00, etc.
See SCHEDULE.DOC for more information.
TO BUILD PROGRAMS:
@BUILD
WHEN BRINGING UP SYSTEM, SET DEFAULT TO THIS UIC AND EXECUTE:
@SUP
********************VD1:[330,15]README.1ST;1********************
********************VD1:[330,15]README.1ST;1********************
Ratfiv Version 2
Ratfiv is a structured Fortran preprocessor providing
SWITCH, IF - ELSE, WHILE, FOR, DO, REPEAT - UNTIL, STRING,
and BREAK and NEXT constructs. Also supported are INCLUDE
files, DEFINE for symbolic constants and macros with
arguments, conditional compilation, formats in read, write,
encode, and decode statements, use of >, <, etc. instead of
.GT., .LT., etc, and the RETURN VALUE construct in
functions.
Ratfiv was developed from the Ratfor compiler
distributed by Lawrence Berkley Labs; versions are
available for VAX VMS and RSX/IAS systems. The major
enhancements in Ratfiv are:
1. Ability to specify a format statement inside READ,
WRITE, ENCODE, and DECODE statements;
2. Consistent line continuation using the underline
character;
3. Production of properly indented upper case Fortran
code with comments passed through;
4. Optional output of Fortran 77 code with the /F77
switch;
5. Addition of a /SYMBOLS switch to the command line
to optionally read the SYMBOLS file;
6. Output of quoted strings or optionally hollerith
strings (quoted string output allows Ratfiv to be
used with DEC Fortran OPEN statements, the Fortran
77 CHARACTER data type, etc.);
7. Evaluated and unevaluated arguments in macros;
8. Correct line number reporting;
9. Exit with error status if an error occurs during
compilation;
10. Use of character constants in case labels;
11. Numerous bug fixes;
12. Comprehensive documentation;
13. Ratfiv keywords need not appear at the beginning of
a source line in order to be recognized.
Page 2
This version of Ratfiv may be used if you want to
compile the Ratfiv source to the other programs written in
Ratfiv on this tape.
Version 2 of Ratfiv has a few enhancements, bug fixes,
and changes since Version 1. The enhancements are:
1. The documentation has been revised, particularly
the section on defining macros;
2. Hollerith strings may be optionally outputted
instead of quoted strings;
3. The initialization and increment parts of FOR loops
may have more than one statement in them;
4. Macro definitions may have commas in them;
5. Arguments to the _len and _include macros may have
commas in them;
6. The special macro arguments $& and %& are replaced
by ALL the arguments passed to the macro;
7. Octal constants may be inserted in STRING
variables;
8. The number of special escaped characters in the
STRING statement has been increased and these
characters may also be used with the CASE
statement;
9. Quoted strings are consistent in that double and
single quoted strings may both have double or
single quotes in them, even in the STRING and CASE
statements;
10. Macros may be defined which emulate the _ifdef,
_ifndef, _enddef, and _elsedef macros (see the file
RATFOR.SYM for an example of this);
11. Some unused CONTINUE statements in the Fortran
output have been eliminated.
A few changes were made that could cause incompatibility
with Version 1. I am sorry for these changes, but they were
necessary for my peace of mind. I expect this version to be
pretty stable. The changes are:
1. The dot (.) character is not allowed in macro names
anymore. This change was made because it could
Page 3
cause problems when a macro name appeared next to a
valid dot character, as in "if (status.eq.EOF)".
2. The BREAK statement may not be used to break from a
SWITCH statement anymore. This change was made for
compatibility with Ratfor preprocessors and to make
BREAK consistent with the NEXT statement. It was a
bad idea in the first place to have BREAK break
from a SWITCH statement.
3. Brackets ([]) have no special meaning within macro
definitions anymore. The use of brackets in macros
was too obscure to justify them. In any case there
was little need for them.
4. The NEWLINE character was changed from
carriage-return to line feed for compatibility with
Ratfor preprocessors.
Some of the bug fixes are (there weren't too many bugs):
1. include statements insert their input into the
input stream correctly when they appear in a macro;
2. Error line number reporting is REALLY correct this
time;
3. Literal Fortran code is allowed in macros.
The file "RATFOR.SYM" contains some macro definitions
which, if placed at the front of the Software Tools
"SYMBOLS." file, make Ratfiv largely compatible with the
latest (Spring 1981 VAX sig tape) version of Software Tools
Ratfor available from Joe Sventek. I have compiled about 15
thousand lines of his code with Ratfiv; the only problem
was that some variables named "string" ("string" is a Ratfiv
keyword) had to be renamed. Software Tools Ratfor code
should be compiled with Ratfiv's "/SYMBOLS" switch, and with
Ratfiv's "/HOLLERITH" switch for compatibility on the VAX.
This is the only place where the "/HOLLERITH" switch has
been needed so far. Note that shortening of long names is
not available in Ratfiv; I have not checked whether long
names are used in the RSX/IAS version of the Software Tools.
Also, the "$(" and "$)" brackets for use with macros are not
available in Ratfiv; there seems to be little use for them
in Ratfiv.
Page 4
I expect that Ratfiv will be fairly stable from now on,
although it's possible I will add enhancements. I am
interested in hearing about and fixing bugs, however.
To build Ratfiv, do
@BUILD
Documentation is in the file RATFIV.DOC.
The "@BUILD" file builds Ratfiv and also Macro, which
is just the macro preprocessor portion of Ratfiv. Input
passes through the macro processor unchanged except that
macros are expanded. There is no documentation for Macro,
however the form of the command line is like Ratfiv's and
the macros are the same, except that "define" isn't
available; use "_macro" instead.
There is a system-wide file called "SYMBOLS." which can
be read by specifying "/SYMBOLS" on the Ratfiv command line
(see the section, "USING RATFIV" in "RATFIV.DOC"). The
default location of this file may be changed by changing the
define for "USER$BIN" in the "SYMBOLS." file and rebuilding
the compiler from scratch. Most people won't need this
file, however, so you can just leave it on the directory
where Ratfiv is located, since Ratfiv first checks the
default directory for the "SYMBOLS." file before looking for
the system-wide file.
If you are using the FOR compiler instead of F4P on a
PDP11, be sure to compile the Fortran sources with the -SN
switch. Ignore the errors in IO.FTN; they are in modules
which aren't used by Ratfiv. You will also have to change
the RATFIV.TKB file as follows:
1. Delete the MAXBUF=512 option.
2. Change ACTFIL=8 to ACTFIL=7
3. Change UNITS=10 to UNITS=9
These changes reduce the number of file inclusion levels
allowed by Ratfiv by one, but the task would be too large
otherwise. If the task is still too large, you can reduce
ACTFIL to 6 and UNITS to 8, but don't reduce them any more
as then you will not be able to include any files.
Page 5
After reducing the number of file inclusion levels,
then after successfully building Ratfiv you should change
the define for NFILES in the file "MACSYM." to reflect the
changes (i.e subtract 1 or 2 from the defined value of
NFILES), and then rebuild the compiler from scratch.
Send comments, problems, etc. to:
William P. Wood, Jr.
Institute For Cancer Research
7701 Burholme Ave.
Philadelphia, PA. 19111
(215) 728 2760
********************VD1:[330,16]README.1ST;1********************
********************VD1:[330,16]README.1ST;1********************
MULTI-TREK is a game similar to traditional Star-Trek games
except that it involves several players (currently up to 8), who
play against each other in real time rather than against
imaginary Klingons, Romulans or whatever. The MULTI-TREK
universe consists of a 100 by 100 matrix, of which an approximate
20 by 20 matrix of each player's immediate area is displayed and
continuously updated at their terminal. MULTI-TREK was
originally submitted to the New Orleans RSX/IAS sig tape, then to
the 1979 San Diego RSX/IAS sig tape with the addition of robot
ships. Since then it has been recoded in RATFIV and has
significant enhancements and improvements, most notably the
addition of energy nets, an improved screen display, much better
input-output (any terminal with clear screen and cursor
positioning may be used at speeds from 1200 baud on up), use of
default ship and direction with most commands ("L" sets the
default direction), more competitive scoring, smarter robot
ships, and fewer bugs. This version was submitted to the Spring
1981 VAX and RSX/IAS tapes, and is being resubmitted to the Fall
1981 tapes with some slight improvements. Complete instructions
for starting and playing MULTI-TREK are in the file MTREK.DOC.
The game consists of a driver task (MTREKD), a player task
(MTREK) for each terminal, and a shared global common area for
inter-task communication. This version runs on VAX VMS, however,
it should run under any system with shared global areas and
rudimentary task switching or time-sharing. Real-time systems
without time-sharing may have to play with priorities to insure
that the driver task gets sufficient CPU time and that all
players get an equal amount of time.
MULTI-TREK was written with a structured Fortran called
RATFIV. The IAS version contains all of the Fortran produced by
RATFIV, as well as the RATFIV source (file type .RAT). The VAX
VMS version does not include the .FOR files, however the RATFIV
compiler is included on both distribution tapes.
MTREK will work properly with any terminal with clear screen
and cursor positioning. The source code is set up to drive
ADM3-A's or VT100's. If you are using different terminals, you
should modify the file "TERMINAL.RAT" (you could modify
"TERMINAL.FTN") to drive your terminal. Modification should be
straight-forward as the code is commented on where to change it.
To build MTREK, do
@BUILD
The VAX VMS version places the common area, LEDFOR, on
SYS$SHARE and installs it /WRITE/SHARE. It also puts MTREK.EXE,
the player task, and MTREKD.EXE, the universe manager task, on
SYS$SYSTEM, and installs MTREK.EXE with DETACH and ACNT
privileges, so that anyone can start up MTREKD as a detached
process (only one copy of MTREKD runs at a time, however).
Page 2
After building MTREK, first run MTREKINI. Then, on VAX VMS
systems, say MCR MTREK and you are off and running. On IAS
systems, the universe manager MTREKD must be started by hand
before MTREK is run. You can run MTREKD on a dedicated terminal
or install it and run it /REAL.
Send comments, problems, etc. to:
William Wood
Computer Center
Intstitute For Cancer Research
7701 Burholme Ave.
Philadelphia, PA. 19111
(215) 728 2760
********************VD1:[332,60]README.1ST;1********************
********************VD1:[332,60]README.1ST;1********************
UIC: unknown
FILES: CCL.MAC FIXUP.MAC LOOKUP.MAC CCL.CMD DRSPW.SLP
CCL.HLP NEW.HLP SYSCCL.CCL
SYS: RSX-11M V3.2 (4.0?)
This is a complete revision of CCL a program originally written
by R. J. Kirkman and revised by J. Downward. The original may be found complete
with documentation on the KMS FUSION UIC [344,*] on the Fall '79.
and both '80 DECUS tapes. In addition an SLP file to patch the RSX-11M V3.2
exec. is necessary. This patch comes compliments of G. Thompson [307,21] from
the Fall '80 DECUS tape. It had 1 missing line which I inserted. The patch
may not be necessary for V4.0 users if the preliminary information about
the new flavor of spawning is correct.
The extra features added to CCL are foreward GOTO event multitasking
with event flag synchronization and parsing of statements by dividing
the parameters into before/after "=" segments. The addition of many extra
error messages, and a few debug features made an almost complete simulation
of DCL possible. Since DEC is now supporting DCL you may not need this,
but V3.2 users can use it. In addition a .CCL file with illustrations
of the new features is supplied. As well as a CCL.HLP file. In particular
the DCL form of FOR and LINK commands are supported and they may be intermixed
freely with the MCR command form. That is either FOR [/sw1/sw2...] filename
or FOR file1,file2=file3/sw1/sw2... may be used. A help file NEW.HLP
is included to detail the syntax generated by CCL.
This version has been at use at Bonner Lab at Rice University for
a while and should be quite bug free. If you need help or want a little
more information on it you may get me at. Bonner Nuclear Lab, Rice Univ.,
Box 1892, Houston Tx, 77001 or by phone (713) 527-4018.
John Clement.
********************VD1:[332,100]README.1ST;1********************
********************VD1:[332,100]README.1ST;1********************
>CONTRIBUTION FROM HOUSTON AREA RSX/IAS LUG
WILLIAM D. BURTON, JR.
TEXAS RESEARCH INSTITUTE OF MENTAL SCIENCES
1300 MOURSUND
HOUSTON, TEXAS 77030
(713) 797-1976 EXT 501
THIS SUBMISSION CONTAINS REVISED VERSIONS OF PROGRAMS WHICH
APPEARED ON THE RSX/IAS SYMPOSIUM TAPE FROM MIAMI, SPRING, 1981
DSCDIR - FORTRAN PROGRAM TO PRODUCE A DIRECTORY OF THE CONTENTS OF
DSC (DISK SAVE AND COMPRESS) TAPES.
NOW ALLOWS 1600 BPI TAPE, DOES NOT CHOKE ON .DIR FILES WHICH
ARE EMPTY.
HAS RUN UNDER BOTH RSX-11M (3.0 OR LATER) AND IAS
FILES: DSCDIR.FTN, DSCDIR.CMD, DSCDIR.DOC
DSCCPY - FORTRAN PROGRAM TO RESTORE JUST A FEW FILES FROM A DSC TAPE
WITHOUT RESTORING THE ENTIRE VOLUME.
GENERAL USER-ORIENTED FIXES.
HAS RUN UNDER BOTH RSX-11M (3.0 OR LATER) AND IAS
FILES: DSCCPY.FTN, DSCFTN.FTN, DSCMAC.MAC, DSCCPY.CMD, DSCCPY.DOC
DSCTAP.TXT - DESCRIBES FORMAT OF DSC-PRODUCED TAPES.
********************VD1:[336,300]README.1ST;1********************
********************VD1:[336,300]README.1ST;1********************
This is RSX Network Mail, a midnite hack done to provide communications
between RSX Systems and to communicate with VMS Mail.
RSX Mail and VMS Mail are collectively called Mail-11.
Unlike the VMS version, RSX Mail-11 requires DECNET, even for local
mail delivery.
This file is called README.TXT on the DECUS tape to correspond with
normal DECUS practices. The remainder of the files are all contained
in MAIL.ULB, a universal library. Inside that library this file is
known as "MAIRLS" or "MAIL.RLS."
These programs are written primarily in FORTRAN and BASIC-Plus II.
Task images are provided so that they can be used at sites without
licenses for these language products.
For those users who have the compilers, you are welcome to make your
own modifications. The programs could use much additional human
engineering; they are provided on an as is basis to DECUS. No SPRs,
inquiries, or complaints, please.
Mail Sender Mail Reader Help files Mail Server (Network Object)
NETSND.FTN MAIL.CMD UNSSEND.HLP MAILSRV.B2S
NETSND.OBJ MAIL.FTN UNSMAIL.HLP MAILRSX.B2S
NETSND.CMD MAIL.OBJ MAILARC.B2S
GINUAB.MAC MPT.MAC Mail Notify MAILSRV.OBJ
GINUAB.OBJ MPT.OBJ MAINOT.FTN MAILSRV.ODL
MAINOT.OBJ MAILSRV.CMD
MAINOT.CMD
*****NOTE: Due to ongoing development on our system, some UICs for
Language OTSs in some command files may have to be altered.
Configuration Options:
1) RSX Group format - all incoming mail is placed in LB:[1,7]uic.TXT
The Mail Reader is used to check for and read mail.
*** THIS IS THE RECOMMENDED FORMAT. ***
2) ARC Mail Format - all incoming mail is placed in LB:[1,7]uic.TXT
Use Alberta Research Council Mail to check for and read mail.
*** OBSOLETE, YOU PROBABLY DON'T WANT TO USE. ***
3) First RSX format - incoming mail is placed in individual MAIL.TXT
files in each user's own directory. Mail is read by processing
the individual files with standard RSX utilities or with an indirect
command file reader, NOT SUPPLIED HERE.
*** OBSOLETE, YOU PROBABLY DON'T WANT TO USE. ***
Choosing your configuration:
The MAILSRV.OBJ in the ULB will be in RSX Group Format. To compile mail
you get option 3 by simply compiling MAILSRV.B2S; you get the other options
by APPENDING (with the BP2 compiler) either MAILARC.B2S or MAILRSX.B2S
before compiling.
For example, to compile RSX Group Format (the normal configuration):
RUN $BASIC2
OLD MAILSRV
APPEND MAILRSX
COMPILE
^Z
Building Mail:
Unless you want to modify Mail, you should not have to build it. The
four task images in the Universal Library will run on any machine which
has EIS. (Due to the use of F4P, EIS is a minimum requirement for Mail.)
You should be able to skip reading the rest of this section, and go on
to "Installing Mail"
The four .CMD files provided contain enough information to enable building
the four programs. Be sure and use MAILSRV.ODL and .CMD, and not a file
produced by the BP2 compiler.
The Fortran-IV-Plus code does not generate FPP instructions; thus it may
be used on any machine which has EIS (most PDP-11s have EIS). If you do
not have floating point, check local procedures for using F4P.
Installing Mail:
Simply install the four Tasks.
Also issue the command: NCP SET OBJ 27 NAM MAL$$$ USE DEF VER OFF COP 20
Creating the Routing File and the Forwarding/Filter File:
1. LB:[1,2]MAILNODE.DAT is the routing file and contains lines of the form:
nodename poor::mans::routing::to::nodename::
e.g.
ARK BABEL::GALAXY::STAR::VAX4::ARK::
If you wish, you may initially create a null file:
PIP LB:[1,2]MAILNODE.DAT=NL:
2. LB:[1,2]MAILUSER.DAT is the Forwarding/Filter File and has lines like:
localname->nodename::nodefurther::distantname
localalias->localnameoraccount
localname->(Error message)
e.g.
LUSER->CORRECT::NODE::LUSER
SYSTEMMANAGER->WATSON
SMITH->(Smith - Send to J_SMITH or G_SMITH or B_SMITH)
B_SMITH->B_SMITH
J WILSON->[231,277]
M PORTER->M_PORTER
COMMENT LINE
(Any line which does not contain "->" is a comment.)
A SPACE AFTER THE INITIAL MEANS THAT IT IS OPTIONAL. AN UNDERSCORE
MAKES IT REQUIRED.
An optional feature (called ABSOLUTE filter) requires that all users who
will receive mail on this node be entered in the Filter File. An entry
of the form NAME->NAME is sufficient if no translation is required. To
activate this feature, a line BEGINNING with "->" (in column one) is
placed at the END of the Filter file. This line contains the message to
be returned to the person trying to send mail.
e.g.
-> does not read mail on THSNOD
The user's name, followed by the message will be returned as an error.
I STRONGLY RECOMMEND USING THE ABSOLUTE FILTER, SO THAT OTHER USERS
DON'T SEND MAIL TO PEOPLE WHO HAVE ACCOUNTS ON YOUR SYSTEM, BUT DON'T
USE YOUR SYSTEM OFTEN ENOUGH TO CHECK FOR MAIL.
Mail Notification has now been documented in the help files. Users turn it
on for a particular terminal by typing MAIL ? NOTIFY and turn it off by
typing MAIL ? NONOTIFY. The system must take care of shutting it off when
a user signs off; this is currently done for RSX-11M-PLUS systems with a
file in LB:[1,10]LOGOUT.CMD which contains a MAIL ? NONOTIFY command. For
RSX-11M systems, the BYE program must be rebuilt using the "USER Subroutine"
provided. See BYEMAI.MAC and your own system's BYEBLD.CMD. Note that
the RSX group intends to implement a "MAIL Subroutine" similar to the
"USER Subroutine" which will eventually replace both methods.
The ? command may be qualified with a /BRIEF. This speeds up checking for
mail.
Your startup procedure should issue a PIP LB:[1,7]LOGDATA.DAT;*/DE in order
to delete old notification information. It may also be desirable to issue
a MAIL ? NONOTIFY after the delete; this will assure that the owner of the
file is SYSTEM rather than the first user who types MAI ? NOTIFY.
NOTES ON THE MAIL READER:
I wrote this very quickly (2 1/2 days) and intend to do some additional
work on it. In particular:
The READ command will eventually be modified to accept a file
name. (Currently you must switch to a file you have filed mail
into with the DIRECTORY command).
Mail will be modified so that it doesn't exit when you try to
read an empty Mailbox, allowing you to issue another command.
The format of the "POSTOFFICE" will be changed so that Mail is
aware of what you have read, so that it can begin with new mail.
For now, users may file mail in other mailboxes to get it out of
the postoffice.
Some of these features may be provided on future RSX-Sig Tapes, but no
promise of future versions of this submission are implied.
********************VD1:[337,30]README.1ST;1********************
********************VD1:[337,30]README.1ST;1********************
THIS IS THE LATEST VERSION OF THE SFGL70 GENERAL PURPOSE FORTRAN
CALLABLE GRAPHICS PACKAGE THAT HAS BEEN DISTRIBUTED THE LAST 2 YEARS. A FEW
MINOR BUGS HAVE BEEN ELIMINATED SINCE THE LAST VERSION. IT RUNS UNDER RSX11M
& IAS. I HAVE ALSO SUBMITTED A VERSION THAT RUNS UNDER RT-11 TO THE RT11 SIG
TAPE. MANY PEOPLE THROUGHOUT THE WORLD HAVE BEEN USING IT SUCCESSFULLY FOR
THE LAST 2 YEARS. IT'S SMALL(1.5 KW) & FAST. IT SUPPORTS TEKTRONIX 4006,
4010,4014 & 4025 TERMINALS. IT ALSO SUPPORTS VT100'S THAT HAVE THE RETRO GRAPHICS
UPGRADE. IF YOU HAVE ANY PROBLEMS GETTING IT TO WORK PLEASE
CONTACT ME AT:
KEN DEMERS
UNITED TECHNOLOGIES RESEARCH CENTER
ROBOTICS LABORATORY
EAST HARTFORD, CONNECTICUT 06108
203 727-7527 OR 7240
THANKS
KEN
********************VD1:[343,1]README.1ST;1********************
********************VD1:[343,1]README.1ST;1********************
Submitted by: Robert Nance
Johnson Controls Inc., Special Systems Operation
9550 Ridgehaven Ct.
San Diego, CA 92123
Description: Probe is a system performance measuring tool. It indicates the
amount of time being spent in interrupt processing, kernel space processing,
user space processing, and null time. In addition, it provides some subroutine
time histogramming for an adjustable number of (FORTRAN usually) tasks by
taking advantage of the exit traceback information provided by the OTS. It is
intended for use on a CRT, and is presently set for a VT100.
System reqts: During Probe's execution, I found that Probe introduces about
5% overhead in CPU time. If it is changed to update the screen less often,
this will be lessened. Its size is adjustable, it is set up for about 2KW.
It is driven by system clock interrupts, and can easily be changed to be
compatible with any such interrupt. It uses memory management hardware address
directly - It should not be too difficult to change it if, for some reason,
its use on systems without this hardware. In its present configuration it uses
one global event flag.
Documentation: PROBE.DOC describes the output format and some uses,
and the source is well commented (I hope).
Status: A possibly dangerous tool in the hands of fiddlers. If aborted
when not in stasis mode it will leave some of the pool space permenently
allocated. It is run at extremely high priority to prevent races, as it pokes
around in the pool space and the memory management hardware to retrieve the
subroutine histogramming information.
Desired enhancements: The ability to better pick which tasks are
histogrammed. Data buffering storage changable based on task size extension at
install time.
Support: The author welcomes comments & suggestions, but does not
want complaints, although will be interested in fixes to eliminate same. I do
not yet know for certain how compatible it will be with RSX v4.0 or the new
Fortran, but will myself make any necessary conversions, and will share any
such changes, if any, when they are available.
********************VD1:[343,10]README.1ST;1********************
********************VD1:[343,10]README.1ST;1********************
ONVOLUME
The ONVolume routine allows a priviledged user to discover which TI's are
mounted to non-public devices. The syntax of ONV is
ONV DDn: To display one device
ONV DD: To display all DD:
ONV /ALL To display all mountable units in the system.
To build ONV:
MAC ONVOL,LS:LP=LB:[1,1]EXEMC/ML,[11,10]RSXMC,SY:<UIC>ONVOL
TKB ONVOL/CP/PR,MP:LP=LB:[1,54]RSX11M.STB,SY:<UIC>ONVOL
********************VD1:[343,11]README.1ST;1********************
********************VD1:[343,11]README.1ST;1********************
The DYL utility is used to load a bootable task image onto a floppy in
either RX01 or RX02 format. The loader will write the bootstrap block
for an RX01 in single density format or an RX02 in dual density format.
It will not, however, write for an RX02 in single density format. If
the target diskette is not at the user-specified density, DYL will
format the floppy to the proper density before loading. The syntax of
the DYL utility is:
DYL DYn:/Density=Taskimage[/-WB]
Where:
DYn: is either DY0: or DY1:
/Density is /SGL for RX01 or /DBL for RX02 format
/-WB is an optional switch to disable writing the Boot Block.
In order to taskbuild a program for use with the DYL program, use the
following format:
>TKB
TKB>TASK/-MM/-HD,MAP=OBJECT
TKB>/
ENTER OPTIONS:
TKB>STACK=0
TKB>PAR=LSIPAR:stadd:size ! Stadd is the start address in octal
TKB>//
********************VD1:[343,12]README.1ST;1********************
********************VD1:[343,12]README.1ST;1********************
UNDELETE
Originally written by Richard Kirkman and appeared in July 1981 Decus
RSX11M SIG newsletter, THE MULTI-TASKER.
The function of this program is to attempt to recover a recently deleted
file.
The program will accept a command line with input and output disks (which
must be different) and an input UIC. It will then scan the input disk
indexfile for all deleted files with that UIC. Will print error message
(warning) if search of bitmap shows that a file block has been reused.
Will use IO.RLB from privledged task to read all blocks of the file and
then create new file in owners UIC on output device.
This program will only succeed in recovering a file, if the file header
has not been reused. It's optimum use would be when a single user
accidentally deletes a file and immediately stops all writing to the
volume, to avoid loosing either the file header or any of the other
blocks belonging to the deleted file.
COMMANDLINE FORMAT: "UND>DO:=DI:[grp,mbr]"
Where DO: is the output device, DI: is the input device
and the output and input devices are not the same.
OUTPUTS:
Places the undeleted file into the users current UIC on
the output device.
Build instructions:
MAC UNDEL,LS:LP=UNDEL
TKB>UNDEL/CP/PR:0,MP:LP=UNDEL
TKB>/
TKB>STACK=64
TKB>TASK=...UND
TKB>PRI=100
TKB>UIC=[1,1]
TKB>//
********************VD1:[343,13]README.1ST;1********************
********************VD1:[343,13]README.1ST;1********************
The downline loader downloads the absolute loader to an LSI from
the PDP 11/35 through a user specified TT line. The program then
sends a task image to the absolute loader.
To run the downline loader:
The LSI must first be able to accept an ODT command, This can be done
by halting the LSI, then restarting it.
Run the downline loader from the console.
The downline loader will prompt for the TT line to the LSI, the
downline loader sends the microcode load command to the LSI then
downloads the absolute loader to the LSI.
Once the absolute loader is in the LSI, the downline loader prompts for
the task to be loaded to the LSI, (The task to be loaded must not have a
header) where the downline loader will send the proper information for
loading the task to the absolute loader.
To compile and build the downline loader:
MAC LOAD,LS:LP=LB:[1,1]EXEMC/ML,LOAD
TKB LOAD,MP:LP=LOAD
********************VD1:[343,14]README.1ST;1********************
********************VD1:[343,14]README.1ST;1********************
KILLER - RSX-11M JOB KILLER
PROGRAM DESCRIPTION - Task issues a BYE command against a user
logged on the terminal given in the command line to KILLER.
This action, in effect, 'kills' that user.
LIST OF FILES -
KILLER.MAC ;Main program and build information
This task will allow the privileged user (or any user logged in at TT0:)
to log off any logged-in user. The method is to run BYE at the targeted
user's TI:. KILLER will temporarily redirect CO: to TI: so the logout
message furnished by BYE will be displayed for confirmation.
The command line format to KILLER is as follows:
KIL TTxx ;where xx is the target tty unit number (octal).
BUILD INSTRUCTIONS:
>MAC KILLER=LB:[1,1]EXEMC/ML,LB:[200,200]RSXMC/PA:1,SY:'<UIC>'KILLER
>TKB KILLER/PR=KILLER,LB:[1,54]RSX11M.STB
>/
>TASK=...KIL
>STACK=64
>UNITS=1
>//
********************VD1:[343,21]README.1ST;1********************
********************VD1:[343,21]README.1ST;1********************
SUBMITTED BY:
PAUL D. CLAYTON
REPUBLIC MANAGEMENT SYSTEMS
ONE NESHAMINY INTERPLEX, SUITE 306
TREVOSE, PA. 19044
THIS AN UPDATED VERSION OF THE FORTH PUT ONTO THE FALL '80 RSX/IAS
SIG TAPE. IT IS NOT MEANT AS A OFFICAL RELEASE OF FORTH AND I AM ** NOT **
A MEMBER OF THE FORTH INTEREST GROUP OR DEVELOPMENT TEAM. IT IS MEANT
SOLEY AS AN ENHANCED VERSION PROVIDING A BETTER TOOL FOR GENERAL USE AND
USER ACCEPTENCE.
THERE IS ADDITIONAL DOCUMENTATION IN THE SOURCE LISTING WHICH SHOULD BE
CONSULTED ALONG WITH THIS DOCUMENT.
THIS SYSTEM IS MODIFIED TO RUN UNDER IAS V3.0. NO TESTING HAS BEEN DONE
UNDER RSX-11M(+) OR THE OTHER SYSTEMS. IN OTHER WORDS, IF YOU DON'T HAVE
IAS YOU ARE ON YOUR OWN.
MODIFIED BY
PAUL D. CLAYTON
REPUBLIC MANAGEMENT SYSTEMS
ONE NESHAMINY INTERPLEX,SUITE 306
TREVOSE, PA. 19044
THE FOLLOWING MODS WERE DONE:
MODS SHOWN AS +M001 ARE FOR:
COMMAND - BIKEY
ADD IN THE CAPABILITY TO RECIEVE THE TRUE BINARY VALUE OF
A TYPED CHARACTER, INCLUDING ALL CONTROL CHAR.
***WARNING: CONTROL-C HAS NO MEANING WHEN THIS
FUNCTION IS ON.
COMMAND: -BIKEY
RETURNS THE TERMINAL HANDLER TO NORMAL FOR RECOGINIZING ALL
CONTROL CODES. THIS IS THE INVERSE OF BIKEY.
COMMAND: ALTPAD
ENABLES THE ALTERNATE KEYPAD ON THE VT100 TO SEND ESCAPE
SEQUENCES BACK TO FORTH. THE NORMAL MANNER IS FOR
THE ALTERNATE KEYPAD TO SEND NUMERICAL VALUES.
COMMAND: -ALTPAD
RETURNS THE ALTERNATE KEYPAD TO NUMERICAL USE. THIS IS THE I
INVERSE OF THE ALTPAD COMMAND.
COMMAND: TRKEY
RETURNS ONE (1) AND ONLY ONE CHARACTER PER COMMAND USE. THIS
IS USEFUL WHEN ALTPAD IS BEING USED OR IN AN EDITOR
AND ALL YOU WANT IS ONE CHARACTER AT A TIME. CARRIAGE
RETURN IS NOT NEEDED TO RECIEVE THE DATA AS IT IS
WHEN YOU USE THE KEY COMMAND.
MODS SHOWN AS +M002
COMMAND: LP
DIRECTS ALL OUTPUT NORMALLY SENT TO THE CRT TO GO TO A DISK
FILE CALLED 'FORTHLP.LST' WICH IS AUTOMATICALLY
SPOOLED AND DELETED WHEN YOU EXIT FROM FORTH.
COMMAND: TERM
REDIRECTS ALL OUTPUT TO GO TO THE CRT FROM THE TIME THE
COMMAND IS USED. THE LP AND TERM COMMANDS CAN BE
USED INTERCHANGABLEY AS OFTEN AS YOU WANT.
ADDITIONS TO THE SCREENS IN FORTH.DAT
A FULL SCREEN EDITOR HAS BEEN INCLUDED IN THE SCREENS WHICH WAS
FOUND IN DOCTOR DOBB'S JOURNAL AND ENTERED BY TERRY BOSSERT
OF RMS. THE EDITOR IS AUTOMATICALLY LOADED IF YOU TYPE
'1 LOAD'. IT IS ALWAYS BEST TO HAVE THE EDITOR LOADED
FOR QUICK EDITING AND ALSO THE COMMANDS '\' AND
SCREENMOVE ARE DEFINED IN THE EDITOR SCREENS.
THE FILE FORTH.IDX CONTAINS THE INDEXS OF THE SCREENS CURRENTLY
DEFINED IN FORTH.DAT. THE EDITOR IS VERY WELL COMMENTED
AND A GOOD EXAMPLE OF FORTH PROCEDURES.
KNOWN PROBLEMS:
EVERY ONCE IN A WHILE THE SYSTEM WILL ABORT WITH A SEGMENT
FAULT. WHO KNOWS WHY, DON'T ASK ME. THE FORTH.DAT FILE
FDB CODE HAS BEEN MODIFIED TO LEAVE THE FILE UNLOCKED IN
THE EVENT OF TASK ABORT.
END OF ADDITIONS BY PAUL D. CLAYTON AND CREW
********************VD1:[343,22]README.1ST;1********************
********************VD1:[343,22]README.1ST;1********************
SUBMITTED BY:
PAUL D. CLAYTON
REPUBLIC MANAGEMENT SYSTEMS
ONE NESHAMINY INTERPLEX, SUITE 306
TREVOSE, PA. 19044
THESE ROUTINES LABELED 'SCREEN' WILL PLACE DATA AT USER SPECIFIED PLACES ON
TERMINAL SCREENS FOR BOTH VT100 AND VT52 TERMINALS. THE FILE 'SCREEN.DOC'
IS A REFERANCE TO THE ROUTINES AND THEIR CAPABILITIES. THEY ARE USED
ON A PDP 11/70 UNDER IAS. VER3.0 WITH NO PROBLEMS ENCOUNTERED. THEIR USE
UNDER ANY OTHER OPERATING SYSTEM IS NOT ASSURED, THE SELECTION OF TERMINAL
CHARACTICS TO USE MAY BE DIFFERENT BETWEEN OPERATING SYSTEMS.
*** USER BEWARE OF OPERATING SYSTEM DIFFERENCES.!!!!
THE ROUTINES LABELED 'SIMTAP' ARE FOR AN 'EMULATED' TAPE DRIVE
ON DISK VOLUMES. THE FILE LABELED 'SIMTAP.DOC' CONTAINS ALL THE INFORMATION
NEEDED TO USE THESE ROUTINES TO THEIR FULLEST.
********************VD1:[343,23]README.1ST;1********************
********************VD1:[343,23]README.1ST;1********************
SUBMITTED BY:
PAUL D. CLAYTON
REPUBLIC MANAGEMENT SYSTEMS
ONE NESHAMINY INTERPLEX, SUITE 306
TREVOSE, PA. 19044
THIS PROGRAM WILL READ, WRITE AND LIST THE DIRECTORY OF A RT-11
FORMAT MAG-TAPE ON AN IAS OPERATING SYSTEM. THE TAPE VOLUME BLOCK IS CHECKED
TO MAKE SURE THE TAPE WAS GENERATED ON AN RT-11 SYSTEM. THE TAPE ITSELF MUST
BE MOUNTED WITH FOREIGN CHAR. AND ATTACHABLE. THE IAS COMMAND TO DO THIS
IS:
PDS> MOU/FOR MM0: RT
THE PROGRAM IS DESIGNED AS A 'BULK' READ/WRITE. INDIVIDUAL FILES
CAN NOT BE PICKED OFF. YOU WILL GET ANY FILES IT FINDS ON THE TAPE. WHEN
WRITING TAPES, THE PROGRAM LOOKS FOR A FILE 'RT.DAT' AND EXPECTS TO FIND
THE FILE SPECIFICATIONS (WITHOUT DEVICE OR UIC) FOR THE FILES TO BE WRITTEN
TO THE TAPE. IN OTHER WORDS, RT.DAT CAN ONLY CONTAIN FILE NAMES AND
EXTENSIONS!!!
THE COMMANDS THE PROGRAM WILL ACCEPT ARE AS FOLLOWS.
1. INPUT FROM TAPE:
RT/IN[:DEV]<QUALIFIERS>
QUALIFIERS ARE:
/PE
2. OUTPUT TO TAPE:
RT/OUT[:DEV]<QUALIFIERS>
QUALIFIERS ARE:
/PE
3. DIRECTORY OF TAPE:
RT/DI[:DEV]<QUALIFIERS>
QUALIFIERS ARE:
/PE
/LP
NOTE: LP = USED IF THE OUTPUT IS TO GO TO THE LINE PRINTER ALSO.
PE = USED IF THE TAPE IS 1600 BPI
DEV = MM OR MT DEVICES AND UNITS 0 TO 7 (IE. MM0)
YOU CAN EXIT FROM THE PROGRAM BY ENTERING CONTROL-Z TO THE
'RT>' PROMPT.
THIS PROGRAM HAS NOT BEEN TESTED ON ANY OTHER OPERATING SYSTEM
AND AS SUCH, IS NOT GARUARENTEED TO WORK ON ANYTHING OTHER THAN IAS. THE
DEVELOPMENT OPERATING SYSTEM WAS IAS V3.0 AND FORTRAN IV-PLUS.
TO BUILD THE PROGRAM ENTER '@BUILD' IN DCL MODE.
********************VD1:[343,25]README.1ST;1********************
********************VD1:[343,25]README.1ST;1********************
SUBMITTED BY:
PAUL D. CLAYTON
DATA MANAGEMENT SIG NEWSLETTER EDITOR
REPUBLIC MANAGEMENT SYSTEMS
ONE NESHAMINY INTERPLEX, SUITE 306
TREVOSE, PA. 19044
THIS ACCOUNT CONTAINS ALL THE NEWSLETTER ARTICLES THAT I AM MAINTAINING
ON A WORD PROCESSING SYSTEM. IT IS A 'FIRST' BECAUSE NO OTHER SIG TODATE HAS
INCLUDED ITS MAIN ARTICLES TO THE SIG TAPES FOR ADDITIONAL DISTRIBUTATION.
ALL THE ".DMS" FILES ARE IN LINE PRINTER LISTING FORMAT, (NOT RUNOFF)
FOR DIRECTING TO A LINE PRINTER FOR ADDITIONAL COPIES WHICH CAN BE SENT TO ALL
THE PEOPLE THAT WOULD FIND THEM EDUCATIONAL. I WILL MAKE EVERY ATTEMPT TO
CONTINUE THIS PRACTICE IN THE FUTURE.
NOTE: THE FILE SEQ100.DMS IS A MASTER INDEX TO THE ARTICLES IN THE DMS
NESLETTER SINCE I TOOK IT OVER IN MIAMI '81. THE KEY TO FINDING THE ARTICLES
YOU WANT IS TO TAKE THE SEQUENCE NUMBER FROM THE INDEX (EXCLUDING PERIODS),
PUT 'SEQ' IN FRONT AND FILE EXTENSION OF 'DMS' TO GET THE FILE YOU WANT.
IF YOU HAVE ANY IDEAS FOR FUTURE ARTICLES, PAST ARTICLES, PROBLEMS,
HINTS, ETC. PLEASE GIVE ME A CALL AT (215) 441-2708.
********************VD1:[343,26]README.1ST;1********************
********************VD1:[343,26]README.1ST;1********************
Submitted By:
Ken Tibesar
3M Center
St. Paul Minnesota
The following are a set of routines that allow the interface of OMSI Pascal
Ver. 1.2 to RMS-11. It is a comprhensive set of tools. The routines are
adaptable to OMSI Pascal Ver. 2.0 with minor changes (which must be
done by yourself). The author (3M Corp.) respectfully holds the option
to be rude to anyone calling on the phone. The documentation in the
Runoff file is complete and should answer all questions. It is not
known if these routines will work with NBS or Swedish Pascal as
distributed by the Structured Languages SIG.
A directory of the files are as listed below.
1) Installation Guide.
PRMINS.DOC
2) RSX Library Build Command File
PRMPAS.CMD
3) PRM Internal Structures
PRMCON.PAS
RMSCON.PAS
PRMTYP.PAS
RMSTYP.PAS
FAB.PAS
RAB.PAS
4) PRM User Records and Calls
PRMCAL.PAS
PRMPRE.PAS
5) PRM Source Code in SLIP Format
PRMCLO.SRC
PRMCRE.SRC
PRMDEL.SRC
PRMFRE.SRC
PRMKEY.SRC
PRMOPE.SRC
PRMRET.SRC
PRMSTO.SRC
RMSINI.SRC
6) PRM Documentation
PRMPAS.RNO
7) Example #1
PRMEXA.PAS
PRMEXA.ODL
PRMEXA.CMD
8) Example #2
CREIDX.PAS
CREIDX.CMD
CREIDX.ODL
9) RSX Command File to Transfer Files
PRMXFR.CMD
********************VD1:[343,31]README.1ST;4********************
********************VD1:[343,31]README.1ST;4********************
Editor's note: UIC references are changed here ONLY to reflect SIG tape
assignments - all other documentation is unchanged. Conversions are:
[150,n] ==> [343,3n] e.g. [150,] ==> [343,34]
***** Roadmap to the 3M Fall 1981 DECUS Contribution *****
This set of UICs contains the 3M Fall 1981 DECUS
contributions. We are pleased to present (1) an IFTRAN
precompiler for structured FORTRAN, (2) some useful patches to
RSX-11M-Plus HELLO, (3) the world premiere of 3M's first VT100
film.
IFTRAN - UICs [343,31], [343,32], [343,33]
We are pleased to present a new precompiler for structured
FORTRAN, which is called IFTRAN. The source files for this
precompiler will be found in UICs [343,32] and [343,33].
Documentation in RUNOFF format and a README.1ST file will be
found in UIC [343,31].
Anyone wanting to build this precompiler should note that
(1) It was written in FOR, not F4P, and no attempt has been made
to make it compatible with F4P, (2) If you build it with
THReaded code, it will run slower than sin, (3) MACRO
subroutines are available to the bold user who wants it to run
faster.
This precompiler (in a different incarnation) has been used
extensively at the University of Wisconsin in a teaching
environment, so while the principal code is assuredly
(relatively) bug-free, no such guarantee is made for the RSX
command line parsing routines or system calls. In particular,
the command line parsing is very rough ... but it works.
This set of files has also been released to the DECUS
Program Library under DECUS number 11-481, "An IFTRAN
Precompiler for PDP-11 FORTRAN".
M-Plus HELLO patches - UIC [343,34]
In this UIC we have included a SLP file to rebuild
RSX-11M-Plus HELFSL with some useful enhancements. These are
(1) A customized login header, (2) Strikeover masking for logins
of the form Name/Password, and (3) Printing of file
LB:[1,2]NOLOG.TXT for login attempts when logins are disabled.
These patches were adapted from Jim Downward's patches to
RSX-11M V3.2 HELLO. They have been submitted to DEC for
possible future inclusion, but if you want 'em, you'd better get
them here and not wait for DEC to officially support them.
Note that we didn't remove our custom headers or custom
strikeover mask in HELLO.SLP; it will be necessary for you to
edit the file and include your own.
This SLP file is current to Autopatch D of RSX-11M-Plus.
We have been using it for five months now and have encountered
no problems with it.
Film - UIC [343,35]
For those who have VT100 compatible terminals, we proudly
premiere the first ES and T film production, GONZO.FLM, in UIC
[343,35]. Inspired by the antics of new users on our system who
innocently try to debug their privileged programs which map over
the Exec (often without benefit of $SWSTK), we hope that
everyone enjoys it. Run at 9600 baud, please.
Bruce R. Mitchell
Michael J. Lynch
3M Company
Engineering Systems and Technology
Computer Control Technology Section
Building 518-1
3M Center
Saint Paul, Minnesota
55144
********************VD1:[343,31]README.2ND;1********************
********************VD1:[343,31]README.2ND;1********************
IFTRAN V02.01 DISTRIBUTION KIT
Bruce R. Mitchell, BSEE, BSIE
Department of Anesthesiology
University of Wisconsin - Madison
This distribution kit contains the files necessary to build a
working version of the IFTRAN V02.01 precompiler. In this kit you
will find three UICs: [150,1], [150,2], [150,3].
This UIC [150,1] contains this README.1ST file and the IFTRAN.RNO
file. The IFTRAN.RNO file contains all the documentation you will
need to build and use the precompiler. It is set up to produce
documentation on 12 chars/inch horizontally, 6 chars/inch vertically,
with margins of 15 on the left and 90 on the right. If these are not
satisfactory, you will have to extensively edit the file, as the file
is predicated on having a printer which does this.
RNO the IFTRAN.RNO file and read it. When you have finished,
copy the files from [150,2] into your preferred UIC and build the
bootstrap precompiler using file IFT.CMD. Install the resulting task
and delete all other files copied from [150,2].
Copy the files from [150,3] into your preferred UIC and build the
V02.01 precompiler using file IFTBUILD.CMD. This indirect file will
ask you what your preferences are for task attributes. When you are
through, you will have a customized version of the precompiler.
Direct any inquiries and suggestions to Bruce R. Mitchell at the
Department of Anesthesiology, B6/387 Clinical Sciences Center, 600
Highland Avenue, Madison, Wisconsin, 53792. DO NOT direct inquiries
regarding this distribution kit to Dr. Dietmeyer. He will be very
miffed and tell you that he knows nothing about PDP-11 FORTRAN, which
is true.
********************VD1:[343,32]README.1ST;1********************
********************VD1:[343,32]README.1ST;1********************
** EDITORS NOTE **
This UIC is documented in [343,31]
********************VD1:[343,33]README.1ST;1********************
********************VD1:[343,33]README.1ST;1********************
** EDITORS NOTE **
This UIC is documented in [343,31]
********************VD1:[343,34]README.1ST;1********************
********************VD1:[343,34]README.1ST;1********************
** EDITORS NOTE **
This UIC is documented in [343,31]
********************VD1:[343,35]README.1ST;1********************
********************VD1:[343,35]README.1ST;1********************
** EDITORS NOTE **
This UIC is documented in [343,31]
********************VD1:[343,40]README.1ST;4********************
********************VD1:[343,40]README.1ST;4********************
PETER J. HUNTER
U.C. DAVIS
DIV. ENV. STDS.
DAVIS, CALIF. 95616
(916) 752-7533
This directory contains a Foreign Tape Processor(FTP) which allows
a user to read, write and dump tapes that are not RSX compatible.
FTP.HLP explains how to use FTP, and a ready to use task image is
included as well as all source files. Inaddition to FTP there is a
string library(STRING.FTN) for FORTRAN which maybe of some value.
Example uses of FTP are:
FTP>FILE1.DAT=MT0:/RS:80:800
This would copy the current file on MT0 to a disk file named
FILE1.DAT. The tape file is blocked with 10 logical records
per physical tape record.
FTP>MT0:/FT:EB/RS:84:840 = MYPROG.FTN
This would copy the ASCII file MYPROG.FTN to tape MT0
translating ASCII characters to EBCDIC. The tape would
be blocked with 10 logical records of 84 characters per
physical tape record.
********************VD1:[343,50]README.1ST;1********************
********************VD1:[343,50]README.1ST;1********************
Free software BY
Project Software & Development, Inc.
This software is furnished for free and may be used and copied as
desired. This software or any other copies thereof may be provided
or otherwise made available to any other person. No title to and
ownership of the software is hereby transferred or allowed.
The information in this software is subject to change without notice
and should not be construed as a commitment by PROJECT SOFTWARE
AND DEVELOPMENT, INC.
PROJECT SOFTWARE assumes no responsibility for the use or reliability
of this software on any equipment whatsoever.
Project Software & Development, Inc.
14 Story St.
Cambridge, Ma. 02138
617-661-1444
Title: LIST
Author: Robin Miller
Date: March 25, 1981
Original source taken from KMS Software Kit.
Description:
The LIST program is used to list file(s) at the terminal. It will
list one screen full at a time so you can easily scroll through the
file. On the VT52, VT100, and Tektronix scope, it keeps the file
name and creation date at the top op the screen. It also has some
useful listing options it accepts after listing each page. Typing
a question mark (?) will display help on all the options.
Operating procedures:
>LIST <FILESPEC>
Where:
<FILESPEC> may be any legal RSX-11M file specification, and may have
wildcards (*) for file names. If wildcards are used, the version
number also defaults to * automatically.
Examples:
X.MAC, TEST.*, *.PLI.
********************VD1:[343,51]README.1ST;1********************
********************VD1:[343,51]README.1ST;1********************
Free software BY
Project Software & Development, Inc.
This software is furnished for free and may be used and copied as
desired. This software or any other copies thereof may be provided
or otherwise made available to any other person. No title to and
ownership of the software is hereby transferred or allowed.
The information in this software is subject to change without notice
and should not be construed as a commitment by PROJECT SOFTWARE
AND DEVELOPMENT, INC.
PROJECT SOFTWARE assumes no responsibility for the use or reliability
of this software on any equipment whatsoever.
Project Software & Development, Inc.
14 Story St.
Cambridge, Ma. 02138
617-661-1444
Program: VAXNET
Author: Roger Lipsett INTERMETRICS April 1979.
Rewritten by: Robin Miller Project Software & Development, Inc. 1981
VAXNET is a program used to transfer ASCII files over an asynchronous
communications line between two computers. The progams supplied in
this directory allow for communications between VAX and VAX or between
VAX and RSX11M. Two programs called F2T and T2F allow task images to
be converted into ASCII records, transferred to the other computer,
and then converted back to a task image which can be run.
This program has several enhancements over the original which include:
o Help available on each question by typing the ESCape key.
o Ability to backup to the previous question by typing the ! key.
o Automatic setup of both local and remote terminal ports.
o The ability to put output from the remote into a logfile
on the VAX which can then be REFORMATed and printed/edited.
o Terminal I/O is done in full duplex mode.
o Better error checking and recover when transfering files.
Several problems:
o occasionally the program will get stuck in a HIBERNATE state
or will exceed its buffer I/O quota (my count was 6). When
stuck in the HIBERNATE state, it must be STOPped from another
terminal.
o when VAXNET is talking to another VAX (at 9600 baud), the XON/
XOFF which the terminal driver sends when the typeahead buffer
is almost full does not always work properly (loose characters).
This problem it not so bad when communicating with RSX-11M or
if the baud rate of the remote terminal port is less than that
of the local port. The problem does not exist if the remote
port is at 1200 baud.
Build Procedures:
List file VAXNET.HLP for helping on building VAXNET & SNDRCV.
********************VD1:[343,52]README.1ST;2********************
********************VD1:[343,52]README.1ST;2********************
Free software BY
Project Software & Development, Inc.
This software is furnished for free and may be used and copied as
desired. This software or any other copies thereof may be provided
or otherwise made available to any other person. No title to and
ownership of the software is hereby transferred or allowed.
The information in this software is subject to change without notice
and should not be construed as a commitment by PROJECT SOFTWARE
AND DEVELOPMENT, INC.
PROJECT SOFTWARE assumes no responsibility for the use or reliability
of this software on any equipment whatsoever.
Project Software & Development, Inc.
14 Story St.
Cambridge, Ma. 02138
617-661-1444
Program: EDT.TEC, DRAW.TEC (runs on TECO V35 or V36)
Author: Robin Miller
Date: 1981
EDT.TEC is a teco macro which emulates version 2 of EDT (known as ED2
on RSX-11M). It was written before ED2 was released to the REAL world
since I got tired of waiting for DEC. Since it is written in TECO, it
puts a much heavier load on the system than ED2. The actual macro is
about half the size of VTEDIT.TEC (but no faster) since I've placed all
the help information in a file called TECEDT.HLP. Although it doesn't
get much use now that ED2 is released, it still comes in useful since
TECO has many features for complicated editing which ED2 doesn't. The
major use of EDT.TEC now is on RT11 systems where ED2 doesn't exist and
where the response time is very good.
Extensive documentation exists in the unsquished macro (EDT.TES) which
makes it much easier to modify than VTEDIT from DEC ever was. About the
only ED2 key not implemented, is CTRL/K for define key. I have CTRL/K
setup to kill the output file and exit. Also CTRL/E is very useful to
exit and go (TECO V36 only). Its spawns a command line of the form
"FOO filnam.ext" which another program or command file can pickup and
automatically do something with it.
DRAW.TEC is basically EDT.TEC with the ability to do drawing. By typing
the GOLD (PF1) key twice, you go into drawing mode which then allows the
arrow keys to draw a specified character (* by default). The drawing
character can be changed by typing CTRL/G and specifying the character
to draw with.
********************VD1:[343,53]README.1ST;1********************
********************VD1:[343,53]README.1ST;1********************
Free software BY
Project Software & Development, Inc.
This software is furnished for free and may be used and copied as
desired. This software or any other copies thereof may be provided
or otherwise made available to any other person. No title to and
ownership of the software is hereby transferred or allowed.
The information in this software is subject to change without notice
and should not be construed as a commitment by PROJECT SOFTWARE
AND DEVELOPMENT, INC.
PROJECT SOFTWARE assumes no responsibility for the use or reliability
of this software on any equipment whatsoever.
Project Software & Development, Inc.
14 Story St.
Cambridge, Ma. 02138
617-661-1444
Program: PNG
Author: J L Frost Chevron Reserch Company
Submitted by: Robin Miller Project Software & Development, Inc.
PNG is a video ping pong program which was written by J L Frost at
the Chevron Research Company. It original ran only on the VT52
series terminal. I've modified it to run on the VT100 terminal as well.
The VT52 code still exists and is conditionalized by the symbol VT52.
The program starts off with a help page to explain how to run the game.
********************VD1:[343,54]README.1ST;1********************
********************VD1:[343,54]README.1ST;1********************
Free software BY
Project Software & Development, Inc.
This software is furnished for free and may be used and copied as
desired. This software or any other copies thereof may be provided
or otherwise made available to any other person. No title to and
ownership of the software is hereby transferred or allowed.
The information in this software is subject to change without notice
and should not be construed as a commitment by PROJECT SOFTWARE
AND DEVELOPMENT, INC.
PROJECT SOFTWARE assumes no responsibility for the use or reliability
of this software on any equipment whatsoever.
Project Software & Development, Inc.
14 Story St.
Cambridge, Ma. 02138
617-661-1444
Programs: RSXMSG, RSXERR, TRYMSG
Author: Robin Miller
Date: 1981
RSXMSG is a module which is used to either report or return an RSX-11M
error message. All error messages are included in this module which
takes up approximatly 2.5 KW. Since most Fortan programs are overlayed
anyway, this size is insignificant since it can be hidden in one of the
overlays. For macro programs which use file I/O, these messages should
probably be moved to a disk file.
RSXERR is a macro program which makes use of the RSXMSG module to return
a specified error message to the terminal. This is very useful since
most RSX-11M utilities (excluding ED2 and PIP) report stupid error numbers
which make no sense to the average user. This program will also report
all Directive or I/O error codes (including quota exceeded for VAX) if
you specify an asterisk (*) in response to the error code question.
TRYMSG is a Fortran program which illustrates how to call the various
entry points in RSXMSG. It also contains extensive documentation on
the RSXMSG bit definitions and calling sequence from Macro.
********************VD1:[343,60]README.1ST;2********************
********************VD1:[343,60]README.1ST;2********************
THE FOLLOWING IS A BRIEF DESCRIPTION OF THE PROGRAMS IN THIS DIRECTORY
ALL RUN ON IAS 3.0 AND 3.1 REAL-TIME AND MULTI-USER SYSTEMS.
SUPPLIED BY ADCOM/J-2YPI, CHEYENNE MOUNTIAN, COLORADO SPRINGS, 80914
ROBERT L. REED. PHONE -- (303)473-4010 EXT. 3529
ATS
A dynamic, multi-column, Active Task Scan.
NODE
A dynamic, multi-column display of active tasks with node pool
usage shown.
SRD
Taken from one of the DECUS tapes. All the known problems
are fixed.
1. Buffer size.
2. Single digit date select such as 1-dec-81
3. Directory too big now tells which directory
and shows what it can of the directory. Bad
things such as incomplete sorts or partial
write backs do not take place.
4. Date selects show creation dates on listing
5. Wild card Uic's don't abort after directory to big
6. ETC. who remembers all the patches
NOTE: the SRD.UNI file is a universal library file.
the SRDEXE module is a command file to extract all
the other files. This is usable on IAS 3.1
********************VD1:[343,70]README.1ST;1********************
********************VD1:[343,70]README.1ST;1********************
SEE is a real-time memory display which permits
selective display of up to eight 'windows' anywhere
in memory in word, byte or character modes on a VT-52.
For mapped RSX11M. See SEE.RNO for details.
Jack Harvey
National Data Systems
299 Market St
Saddlebrook, NJ 07662
phone 201 843-5300
********************VD1:[344,62]README.1ST;2********************
********************VD1:[344,62]README.1ST;2********************
CCL V8.0
This version of CCL is a composit of the work of Angle Li at the
University of Miami, Paul Sorenson at Michigan State University, and Jim
Downward at KMS Fusion. Angle Li edited the code to remove all the funny
F4P lables and to comment the code. Paul Sorenson then provided a
substanitial rewrite to CCL to provide significantly more flexible command
string parsing.
V8.0 of CCL will use the RPOI$ directive to chain command lines to
tasks. In doing so the OCB's will be relinked and CCL will exit at once
since it is not needed to hang around in core to pass back OCB information.
This makes it possible to have CCL commands within a command file started
by a CCL command. Also CCL was upgraded so that it can be an Alternate
CLI for RSX11M V4.0. If it is used as an alternate CLI, it will receive
the command line prior to MCR. This means that any MCR command (even for
installed tasks) can be trapped and reparsed. Moreover, even with an
unmodified MCR, illegal characters can be used as commands.
The same CCL task image can be installed both as the catchall task
(...CA.) and as an alternate CLI. If it is to work as a catchall task
it must be installed with the name ...CA. User's desiring to use the
Alternate CLI features should create a LB1:[1,5]SYSCLI.CCL file
to avoid nasty error messages. Note that both the names for the system
and the user CCL files are modified for if CCL is a CLI. The names
are LB1:[1,5]SYSCLI.CCL and SY:[UIC]USERCLI.CCL. INSCCLCLI.CMD will install
CCL as a CLI on a V4.0 system.
To simplify use of CCL for user's (like myself) who often assign a local
LB:(to do a sysgen). The location of SYSCCL.CCL has been moved to LB1:
(unless symbol $LB0 is defined in PRECCL.MAC). To use CCL, please do a global
assign of LB1: to a physical disk either in VMR or in STARTUP.CMD.
As was previously mentioned, this version of CCL has been extensively
rewritten to provide a more flexible command format. The major changes that
must be kept in mind for this newest version are,
1) All conditional assembly directives are now in PRECCL.MAC
for easier access (see comments for their affects).
They are $LB0,,$DCL, and $TABLE.
2) An internal table lookup has been added to offer a compromise
between DCL and the .CCL files. (see comments in CCL.MAC)
3) Several new parameters have been defined -- %A%, %B%, %C% and %0%
%A% is set the the entire character string past the command.
%B% is set to character string up to first space
%C% is defined as everything not in %B% (excluding delimiter)
%0% is set to values of any leading switches
(e.g. BRU/REW/VER, %0%=/REW/VER)
4) Two options have been added for command building. If a
parameter is null, it may be replaced by a string starting with
the key character "\" and extending to the % delimiter, also,
a parameter may be tested by %2?S1\S2% which will insert string
"S1" if parameter 2 is defined, otherwise string "S2" will be
inserted (either S1 or S2 may be null).
5) A command line may extend to the next line by including the "+"
character as the last character in the line.
6) USERCCL.CCL is opened on the user's logon UIC rather than the
current default UIC.
7) If CCL can not find a command, it will try sending off its
command to another catchall ...CA2.
8) %R is a special character signifying that CCL is to ring the
terminal BELL when it exits. A previous version used %B for this.
Sorry for the incompatability.
9) %D is added to aid in debugging CCL command lines. When it is
encountered, the command up to that point is displayed in
expanded format at the user's terminal rather than being sent
to MCR.
9) %P is added to signify that an action line is to be printed out
on TI:. This makes it very easy to create CCL commands which
send escape sequences to control terminal characteristics.
10) %Q is added to signify that CCL should exit without sending on
the command to MCR if a required input field is defaulted with
a null (ie %1\%) and the input parameter is also a null.
This prevents various PIP like commands from occuring with
no files specified which often results in defaulting to the
entire directory.
11) Two possible TABLE macro files are offered. TABLE.BIG has all
kinds of CCL commands and results in a significantly larger
CCL. TABLE.KMS includes those commands which used to
be processed by the internal DCL code. The size of CCL using
the internal table file is comprable to the previous versions
using hard coded command. TABLEGEN.CMD allows the user to create
an internal CCL file.
12) CCLGEN allows the user to select amoung a variety of options.
If the user desires to use an internal table file, CCLGEN
will allow the user to link to TABLEGEN.CMD to create an
internal table from a standard CCL file. One can use either
USERCCL.CCL or SYSCCL.CCL, for example, as a source file.
13) CCL now checks to see if the keyword typed in is longer than
the maximum specified in the file (previously was ignored). This
means that commands FOO and FOOY can be different and distinct.
14) Documentation and HELP files have been updated to reflect
the many, many new features.
15) CCL now uses RPOI$ to chain the command to MCR if either a %$
is found, or if the action line is the last or only action line.
The Command is chained off, and CCL immediately exits. This is
only for the commands handled via the table file or the external
file. The hardwired commands still use SPAWN. If RPOI$ fails
CCL trys to use the SPAWN directive. Note that this makes it
possible to have CCL commands within command files started by
CCL commands. CCL is no mostly recursive although it is still
not possible to have a CCL command itself be a CCL command.
16) Support for Dan Steinberg's patch for DRSPW (passing/relinking
OCB's on special SPAWN directive) is withdrawn. RPOI$ can be
used without patching the standard RSX11M system.
17) Support for CCL as an alternate CLI.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
KNOWN BUGS and RESTRICTIONS
1) If you specify the following in a command definition file
(note the command set specifies a required prompt is parameters
are missing, but no prompt is present)
$4411XSET
*command_text
CCL will come back and tell you that there is a read error on
LB1:[1,5]SYSCCL.CCL. If you try
$4411XSET
?0Switches
*set %0%%1%P%
you will also get a read error message on LB1:[1,5]SYSCCL.CCL
if you type XSET /UIC=[xxx]. Values are stuffed into the %0
parameter until a space is found. Hence the whole line goes
into %0. Now this screws up the checking for whether or not
enough parameters were entered. %0 is not at this time counted
as one of the characters, so CCL gets confused. The %0 parameter
should be used with care until someone has a chance to come up with
a versitile fix which doesn't screw up something else. I don't
have time to fix this bug for this release, but I would welcome
any help that any users would like to give.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Included on this UIC is a working task image of CCL built without
FCSRES and with TABLE.KMS. It may be used either as a CLI or as
...CA. on a V4.0 system (maybe even on a V3.2 system, try it).
Active contributers to CCL now include
Mr. Angel Li
RSMAS/MPO
University of Miami
4600 Rickenbacker Cswy.
Miami, Fl. 33149
(305)-350-7491
Paul Sorenson
Dept. of Physiology
Mich. State Univ.
E. Lansing, MI 48824
(517)-355-5125
And myself,
James G. Downward
KMS Fusion, Inc
PO Box 1567
Ann Arbor, Mi 48106
(313)-769-8500
********************VD1:[347,101]README.1ST;1********************
********************VD1:[347,101]README.1ST;1********************
FDV.COR
THIS IS A CORRECTION FILE TO THE FMS-11 FORM DRIVER (FDV VERSION 01.00)
TO ADD ADDITIONAL FUNCTIONALITY. THE RSX UTILITY SLP SHOULD BE USED TO
APPLY THIS CORRECTION TO THE FDV.MAC SOURCE FILE.
ADDED FUNCTIONALITY:
ONE WORD IS ADDED TO THE FMS IMPURE DATA AREA. THE FIRST BYTE OF THIS WORD
CONTAINS THE FIRST LINE NUMBER ON THE SCREEN ON WHICH THE CURRENT FORM IS
DISPLAYED. THE SECOND WORD CONTAINS THE LAST LINE NUMBER ON THE SCREEN USED
BY THE CURRENT FORM. THIS WORD MAY BE ADDRESSED BY USING THE SYMBOL I$FLLL
AS AN OFFSET INTO THE IMPURE AREA.
PROGRAM FUNCTION KEYS PF3 AND PF4 ARE CHANGED TO FUNCTION AS USER CONTROLLED
PROGRAM FUNCTION KEYS IF THE CURSOR IS NOT POSITIONED IN A SCROLLED AREA WHEN
THEY ARE DEPRESSED. THE KEYS FUNCTION EXACTLY LIKE THE NUMERIC KEY PAD WHEN
IT IS IN PROGRAM FUNCTION KEY MODE. PF3 RETURNS AN "R" AND PF4 RETURNS AN "S"
TO THE USER PROGRAM IF THE KEYS ARE DEPRESSED WHILE THE CURSOR IS NOT IN A
SCROLLED AREA. IF THE CURSOR IS IN A SCROLLED AREA WHEN PF3 OR PF4 IS
DEPRESSED, THE KEYS FUNCTION EXACTLY AS DESCRIBED IN THE FMS-11 DOCUMENTATION.
THREE NEW FUNCTION CODES ARE ADDED TO FORM DRIVER CALLS.
FC$GVA THIS CALL MAY BE USED BY THE USER PROGRAM TO OBTAIN THE CURRENT
SETTING OF THE VIDEO ATTRIBUTES OF ANY FIELD ON THE CURRENT FORM.
FC$SVA THIS CALL MAY BE USED BY THE USER PROGRAM TO DYNAMICALLY SET NEW
VIDEO ATTRIBUTES FOR ANY FIELD ON THE CURRENT FORM.
CAUTION: 1- THE ORIGINAL VIDEO ATTRIBUTES ARE NOT SAVED AND MUST BE
RESTORED BY THE USER PROGRAM IF DESIRED.
2- IF THE VIDEO ATTRIBUTES OF AN INDEXED FIELD ARE CHANGED,
ONLY THE SINGLE FIELD SPECIFIED BY THE INDEX VALUE
SPECIFIED IN THE CALL IS CHANGED ON THE SCREEN. HOWEVER,
IF CNTRL W IS DEPRESSED WHILE ANY FIELD IN AN ARRAY HAS
ITS ATTRIBUTES CHANGED, ALL FIELDS IN THE ARRAY ARE
REPAINTED WITH THE ATTRIBUTES SPECIFIED IN THE LAST CALL
WHICH AFFECTED A FIELD IN THE ARRAY.
FC$NFI THIS CALL MAY BE USED TO FIND THE I.D. (NAME) OF THE FIRST FIELD ON A
FORM, OR THE I.D. (NAME) OF THE FIELD FOLLOWING THE FIELD SPECIFIED
IN THE CALL. THIS CALL IS USEFUL IN DETERMINING THE NAMES OR ORDER OF
FIELDS ON A FORM.
THE NEW FUNCTION CALLS AND RESULTING STATUS CODES ARE DOCUMENTED IN DETAIL IN
COMMENTS IN THE FDV.COR FILE.
********************VD1:[350,200]README.1ST;1********************
********************VD1:[350,200]README.1ST;1********************
** EDITORS NOTE **
This "document" was extracted from the .FTN file.
THIS PROGRAM WILL READ A FILE UNDER RSX-11M WHICH WAS CREATED
BY RSX-11M PIP BUT COPIED FROM AN ASCII TAPE WHOSE FILE WAS
CREATED BY RT-11 PIP, AND REFORMAT THE RT-11 FILE TO RSX FILES-11
FORMAT. THIS WORKS ONLY FOR SOURCE CODE FILES, TEXT FILES, .DOC
FILES, ANY ASCII FILE. THIS IS A SIMPLE FORTRAN PROGRAM BUT IT
HAS HELP ME CONVERT THE RT-11 FORMATTED ADVENTURE GAME AND THE
LATEST DUNGEON GAME.
I AM STILL LOOKING FOR A PROGRAM WHICH CAN REFORMAT RT-11 PIP
COPIED *.OBJ, *.OLB, *.TSK, AND FORTRAN DIRECT ACCESS FILES.
IF YOU HAVE SUCH A PROGRAM CONTACT ME AND SUBMIT YOUR PROGRAM TO
DECUS.
MR. GEORGE VELEZ
REVLON RESEARCH CENTER, INC.
945 ZEREGA AVENUE
BRONX, NEW YORK 10473
(212) 824-9000 EXT. 287
C
C
********************VD1:[352,2]README.1ST;1********************
********************VD1:[352,2]README.1ST;1********************
[352,2]README.1ST - LOS ANGELES FALL 81 - FILES SUBMITTED BY:
Bob Turkelson
NASA/Goddard Space Flight Center
Code 935
Greenbelt, MD 20771
(301) 344-5003
This UIC contains files for the TALK program.
TALK is a terminal emulation program which enables a user on an RSX-11M V3.2
system with the full duplex terminal driver to communicate with a remote
host computer over a single line interface (such as a DLV11 or DL11). The
program begins in terminal mode, and has the capability of bi-directional
file transfers. See the documentation and program source for details.
TALK has been modified quite a bit since the preliminary version which
appeared on the Miami Spring 81 SIG tape in [352,2]. This version includes
bug fixes and new features.
The file NOTES.DOC describes the changes since the last version and gives
instructions for building TALK.
I plan to submit an updated version of this program to the RSX SIG tape in
the spring.
Kindly advise me of any changes you make to the program.
NOTES.DOC TALK instructions and notes
TALKSYS.MAC TALK prefix file for local and host system parameters.
*.MAC TALK source files.
TALK.CMD Command file to assemble and build TALK.
TALK.DOC TALK documentation.
TALK.RNO Runoff input file for TALK documentation.
[352,2]README.1ST - END
********************VD1:[352,4]README.1ST;2********************
********************VD1:[352,4]README.1ST;2********************
[352,4]README.1ST - LOS ANGELES FALL 81 - FILES SUBMITTED BY:
Bob Turkelson
NASA/Goddard Space Flight Center
Code 935
Greenbelt, MD 20771
(301) 344-5003
This UIC contains correction files for SRD V6.0, which was submitted to the
Spring 1981 Miami RSX SIG tape, in [373,4].
The modifications I made are:
o Corrected the problem with SRD.CMD which caused the generation of
incorrect initialization defaults when the <ESCAPE> feature was used.
o Changed SRD.CMD so that a different SRD.ODL file is generated when SRD
is built with FCSRES.
o Corrected a but which prevented /WB/-LI from working properly (the
directory was not sorted before the write-back).
o Changed SRD so that when the /SE switch is specified, /WI and /WD are
ignored; that is, there is no implicit wild-carding whenever the
/SE switch is used.
o Added the /ZE switch to list zero used block files.
o Added code so that if the file attributes area of the header contains a
value of 0 for the number of blocks allocated, SRD will calculate the
number of allocated blocks from the retrieval pointers.
The SLP *.COR files assume the Version 6.0 *.MAC files are in the current UIC,
and that they have file version number 1. The correction files create *.MAC;2.
Procedure: SLP @SRD.COR ! Corrects all necessary files
@SRD ! Asks configuration questions and builds SRD
I plan to make additional modifications before the next SIG tape. I will keep
Version 6.0 *.MAC files as the base, and add on to these correction files.
I would appreciate hearing from those who have made changes or plan to make
changes to this version, so we can continue to improve this useful utility.
[352,4]README.1ST - END
********************VD1:[360,235]README.1ST;1********************
********************VD1:[360,235]README.1ST;1********************
Los Angeles, Fall 1981 - RSX/IAS and VAX SIG tape
The following are contributions from:
A.R.A.P.
Box 2229
Princeton, NJ 08540
Contact: John Leonard (609) 452-2950
A.R.A.P. modified Triangle/Duke/Rockwell RUNOFF for technical documents
In addition to the excellent changes that are part of the
base line 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. 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.
Implemented with meta-characters like underline function.
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. (meta-characters)
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.
or | = <esc>Y to get a vertical bar on a QUME letter
Gothic print wheel.
The following is a brief description of the files used to build
and run RUNOFF. Most command files are in VAX command format but
should be easily changed for M or IAS. On the RSX sig tape the
files should be in [360,235].
XNOMAC.COM
To assemble all of the RUNOFF source modules. Uses
XNPRE.MAC which does not build for READ-ONLY psects.
Use RNPRE to build for READ-ONLY psects.
MAC.COM is used for the MACRO command line template.
XNO.CMD
TKB format task-build command file. (on Vax compatibility
mode. May want to edit the options for M or IAS.
TKB @XNO or MCR TKB @XNO
The .TSK or .EXE file is XNO but can be installed as RNO.
RNO.RNO
After RUNOFF is built the documentation can be produced
from this file. Use it as input to the newly built version
or RUNOFF -
MCR RNO output-spec=RNO
If you have a DIABLO specify the /DI/UL:L switches on the
RNO side. Output-spec can be a printer, terminal or file.
RNO.CMD
This is a command file we used on IAS for running RUNOFF.
It prompts for certain information and assists in
alligning paper on the second pass.
It also calls RNO.MCR and runs DEVUIC. This is specific
to the IAS command language but should be adaptable to M
if need-be.
RNO.COM
VMS version of RNO.CMD
RNOERR.COM
This command file creates the error message file from
the source error message file. RNOERR.MSG should be
placed on LB0:[1,2].
Note: VM users !
RUNOFFrefers to LB00 (two zeros) so ASSIGN
SYS$SYSDIK TO LB00: or RNOERR.MSG will not
be able to be accessed.
KEYBOARD.RNO
This RUNOFF file will print out the greek symbol layout
for the terminal keyboard. It is set to use the same
positions as and IBM selectric typewriter.
HYPHEN.MAC
I've substitued a null version of the hyphenation routine.
If you want to use the hyphenation feature, link in
HYPHEN.OBJ instead of XYPHEN.OBJ
Notes
This version of RUNOFF assumes you are using a QUME symbol-2 wheel
for the greek/math. Within XUNOFF.MAC is an alternate table to
map into the greek/math wheel Diablo makes. We have found the
QUME wheel to be more satisfactory and, works fine in the Diablo.
If you have questions or problems regarding RUNOFF after sifting through the
documentation etc., please feel free to call me.
********************VD1:[370,130]README.1ST;1********************
********************VD1:[370,130]README.1ST;1********************
[370,130] SUBMISSION BY MICHAEL LEVINE FOR FALL 81 RSX SIG TAPE
INDEX
PROFILE PACKAGE
MAZE
RT-11/RSX/IAS INDEX VERSION 5.6
INDEX IS A FORTRAN CROSS REFERENCING PROGRAM. A FORTRAN SOURCE
FILE PROCESSED BY INDEX WILL BE CHECKED FOR ALL OF ITS VARIABLE NAME
AND LABEL USEAGE. THE RESULTS WILL THEN BE LISTED IN ALPHABETICAL
ORDER, LISTING ALL THE VARIABLE NAMES AND LABELS USED IN THE PROGRAM,
THE LINES ON WHICH THEY WERE USED, AND HOW THEY WERE USED(AS AN OPTION
LINE NUMBERS FROM FORTRAN PRE-PROCESSORS PRINTED IN COLLUMNS 73 TO 80
OF THE GENERATED FORTRAN SOURCE CAN BE USED IN THE CROSS REFERENCE IN
THE PLACE OF THE FORTRAN COMPILER LINE NUMBERS). IF NEEDED THE
VARIABLES FROM SPECIFED FORTRAN SOURCE FILES CAN BE SAVED ALONG WITH
THOSE OF OTHER FORTRAN SOURCE FILES AND LATER PRINTED OUT AS A SUPER
INDEX GIVEING VARIABLE NAME AND THE NAMES OF ALL THE FORTRAN SOURCE
MODULES IT WAS USED IN.ALSO INCLUDED IS THE CAPABILITY TO EXCLUDE FROM
THE INDEX LISTING ALL VARIABLES THAT ONLY APPEAR IN A FORTRAN SOURCE
MODULE IN A COMMON BLOCK ,TYPE OR EQUIVALENCE DECLARATION BUT ARE NOT
USED ELSEWARE(OR LIST ONLY THOSE IF WANTED). THE USER CAN ALSO LIST
ONLY THOSE VARIABLES THAT ARE GLOBAL (DEFINED IN A COMMON BLOCK) OR
THOSE THAT ARE LOCAL AS WELL AS THOSE VARIABLES THAT ARE ASSIGNED A
NEW VALUE (OR NOT ASSIGNED A NEW VALUE IF WANTED). A VARIATION OF THE
SUPER INDEX IS AVAILABLE TO LIST ALL ENTRY POINTS, THE MODULES THAT
THEY ARE DEFINED IN, AND ALL THE ENTRY POINTS THAT CALL THEM AND THAT
THEY CALL PLUS AN INDENTED CALLING TREE AND A SWITCH SELECTABLE
INDENTED CALLED BY TREE.
INDEX WILL HANDLE ALL SOURCE FILES WRITTEN IN FORTRAN FOUR OR
FORTRAN FOUR PLUS IN ACORDANCE WITH 'PDP-11 FORTRAN LANGUAGE REFERENCE
MANUAL' (AA-1855D-TC) AND THE FORTRAN 1977 STANDARD.
INDEX CAN BE GENERATED TO RUN UNDER THE RT-11, RSX-11M, OR IAS
OPERATEING SYSTEMS AND THE DESIRED USER CONFIGURATION WANTED USEING A
FORTRAN PROGRAM TO GENERATE A FILE OF CONDITIONAL ASSEMBLY PARAMETERS.
THIS VERSION OF INDEX IS THE MOST POWERFUL TO BE SUBMITTED TO
THE DECUS SIG TAPES (BOTH RT AND RSX/IAS). PREVIOUS SUBMISSIONS BY
EITHER MYSELF OR OTHERS WITH MODIFIED VERSIONS UNDER RSX ARE:
[300,031] FALL 77 ?
[302,112] FALL 78 ?
[307,020] SPRING 80 U.S. GEOLOGICAL SURVEY (AS 'IDX')
[370,130] FALL 80 MICHAEL LEVINE
[302,304] SPRING 81 RAY FRENCH
INDEX HAS APPEARED ON ALL THE FALL DECUS RT SIG TAPES.
PROFILE V01.0
THE PROFILE PACKAGE IS A SET OF TWO MACRO MODULES AND THIS
DOCUMENT THAT WILL ALLOW THE USER TO DETERMINE HOW OFTEN INSTRUCTION
MEMORY LOCATIONS ARE EXECUTED AT RUN(CRAWL) TIME AND A SUMMARY OF WHAT
INSTRUCTIONS WERE EXECUTED AND REGESTERS AND ADDRESSING MODES USED ON BOTH
THE INSTRUCTION AND PROGRAM LEVEL. THE 'MEASURE' MODULE IS TASK BUILT INTO
THE USERS PROGRAM TO RECORD THE MEMORY LOCATIONS AND INSTRUCTIONS
EXECUTED. THEN THE 'EVALUATE' PROGRAM IS RUN ON THE DATA GATHERED
AND A LISTING OF THE RESULTS IS GENERATED.
MAZE
THIS IS AN MODIFICATION OF THE VT-100 MAZE PROGRAM THAT APPEARED
ON THE SPRING 81 VAX SIG TAPE TO RUN UNDER RSX. TO BUILD JUST ENTER
THE COMMAND @MAZE. THE PROGRAM PROMPTS ALL INSTRUCTIONS NEEDED TO
USE IT.
********************VD1:[374,1]README.1ST;1********************
********************VD1:[374,1]README.1ST;1********************
[360,360]
Submitted by:
Bob Denny
Creative System Design Co.
3452 E. Foothill Blvd Suite 601
Pasadena, CA 91107
(213) 792-9474
BOGGLE:
This program plays "Big Boggle", a game in which the
players try to form words of 3 or more letters from
an 5x5 array of letter cubes using contiguous cubes.
This game acts as an opponent. Use a real Big Boggle
board, run the program and enter in the letters as
requested. The program will write out the words it
finds on the terminal and to a file BOGGLE.OUT. Sorry,
it doesn't support the "Qu" cube. No need to install
the task, put BOGGLE.DIC in your UIC.
SORT:
This is a major rewrite of the "sortc" program on the
DECUS C kit. It's a lot faster, and needs essentially
no stack, and a temp file only slightly larger than the
input file. Runs as task "...SOR"
SUPERDUMP:
A "full bore" file/device dump utility. Documentation
and source in SOD.RNO and SOD.C. Does everything you'll
ever want, including file header dumps, with multi-header
support. Runs as task "...DUM".
CHAT:
This program allows users to chat with each other from
terminal to terminal. Install, runs as "...CHA". Uses
IO.WBT's so you get auto ^R while typing. Looks a bit
kludgy, but it's convenient and prevents full-duplex
garbage when both parties type at once. If the called
party's terminal is attached, it announces "Request
to chat" and waits for the terminal to become available.
The caller sees "CHAT" when he has attached the other
terminal. The caller types ^Z to terminate chatting.
TODAY:
Writes out date and time in English, per the format
used by Robert J. Lurtsema, a classical radio announcer
in the Boston area. Also says the phase of the moon.
Written by Martin Minow. Runs as task "...TOD".
HANOI:
Does the "Tower of Hanoi" on a VT-52 or a '100 in
'52 mode, actually moving the rings visually between
posts. The first time I ran it I cracked up. Install
it with /TASK=...HAN and say HANOI n, where "n" is the
number of rings. Try 4 the first time. I think Dave
Conroy wrote it, and Martin Minow hacked on it.
These programs were written in C, compiled by the DECUS compiler
and TKB'ed with the DECUS runtime library, and the RSX executive
extensions library. You can get the kit through me or the Structured
Languages SIG. Have fun.
JARGON:
This file is a riot! It contains a valuable dictionary of
computerese, straight from the Stanford/MIT Artificial
Intelligentia. I got a big kick out of reading it, and keep
my listing close by at all times for ready reference.