Digital PDFs

XX-11B3A-66

February 1984

15 pages

Original

0.6MB

Document:	TSX-Plus 5.0 Installation Guide
Order Number:	XX-11B3A-66
Revision:	0
Pages:	15
Original Filename:	http://bitsavers.org/pdf/dec/pdp11/tsxPlus/manuals_5.0/TSX-Plus_5.0_Installation_Guide_Feb84.pdf

OCR Text

TSX-Plus
Installation Guide

s&h computer systems J inc.

TSX-Plus
Installation Guide

s&h computer systems, inc.

TSX-Plus
Installation Guide

Third Edition

-- February, 1984

Copyright (c) 1982, 1983, 1984
S&H Computer Systems, Inc.
1027 17th Avenue South
Nashville, Tennessee 37212
USA
(615) 327-3670

This guide describes the installation of TSX-Plus Version 5.0
The information in this document is subject to change without notice and should
not be construed as a commitment by S & H Computer Systems Inc. S & H assumes
no responsibility for any errors that may appear in this document.
NOTE: TSX, TSX-Plus, COBOL-Plus, SORT-Plus and RTSORT are proprietary products
owned and developed by S&H Computer Systems, Inc., Nashville, Tennessee, USA.
The use of these products is governed by a licensing agreement that prohibits
the licensing or distribution of these products except by authorized dealers.
Unless otherwise noted in the licensing agreement, each copy of these products
may be used only with a single computer at a single site. S&H will seek legal
redress for any unauthorized use of these products.
Questions regarding the licensing arrangements for these products should be
addressed to S&H Computer Systems, Inc., 1027 17th Ave.
South, Nashville,
Tennessee 37212, (615) 327-3670, TELEX 786577 SAND H UD.

TSX, TSX-Plus, COBOL-Plus,. SORT-Plus and RTSORT are trademarks of S&H Computer
Systems, Inc. DEC, RT-11, CTS-300, DIBOL and PDP-II are trademarks of Digital
Equipment Corporation.
DBL is a trademark of Digital Information Systems
Corporation.

CONTENTS
Introduction •

Distribution Kit Contents

System Prerequisites
Hardware
Software

3
3
3

Do you need to perform a TSX-Plus system generation?

TSX-Plus Short-cut Installation Procedure

TSX-Plus Installation and System Generation Hints

1. Introduction
The purpose of this guide is to help you install TSX-Plus on your system in the
quickest and easiest way possible. Read this entire guide before attempting to
install or use TSX-Plus.
This guide describes the contents of a typical
distribution kit, necessary system resources, the circumstances that require a
TSX-Plus system generation, and the short-cut procedure for installing a
functional version of TSX-Plus.
The new TSX-Plus user should follow the
short-cut path to verify that all the components of the system are working
together correctly and to obtain some experience with TSX-Plus before tailoring
TSX-Plus to the peculiarities and needs of a particular site. The experienced
TSX-Plus user may proceed directly to the TSX-Plus System Manager's Guide for
detailed instructions on performing the TSX-Plus system generation process.
This

guide

intended for

the person installing TSX-Plus and assumes some

familiarity with the commands and utilities of RT-11, including: handling of
magnetic media; use of command files; the COpy and PRINT commands; use of one
of the system editors (KED, EDIT, or TECO); assembling and linking a prewritten MACRO program; and the R[UN] command. It is not necessary to be able
to write MACRO programs, but you should be familiar with the assembly and
link-ina........ 0

- _ ............ -

nrAf'ACC_
r------..

T-F
__
..L.

UA11

J--

A1Af't-

- - - ....... -"-

t-t"\
,--

nor4=t"\r1Tl
rr
........... ..L." ....

u...&.

<l
{",4

'T'~Y-Dl,.co
..LI.J",,:a..

....

~uo

coucot-o",
0Jt.;;J'-~1.LI.

~o ..... ...,. ........ t-~" .....

~f-~ ...

6~1..LIi;;;..LCL'-..LVIJ.".LL

..LO

also useful to be familiar with the usage of comments, labels and parameters in
MACRO programs.
It is necessary to have access to configuration information
about the various peripheral devices attached to your computer, especially to
know what device handlers are needed and what vectors and addresses are used by
these devices and by timesharing terminals.
This configuration information
should have been written down and left with the system by the person who
installed the hardware.
If it is not available, ask the person who installed
the hardware to enter the configuration information for your system in the form
in Appendix D of the TSX-Plus System Manager's Guide=

The TSX-Plus operating system is designed to provide the familiar RT-11
operating environment to multiple users. This goal mandates several extensions
to the command language of RT-11, and makes a few features unavailable. The
TSX-Plus Reference Manual describes all of the functional differences between
RT-11 and TSX-Plus, including additional keyboard commands and other features,
unsupported commands and other features, and other minor variations between the
two operating systems.
The TSX-Plus manuals are intended to be used in
conjunction with the RT-11 manuals; refer to the RT-11 manuals for descriptions
of features which are not discussed in the TSX-Plus Reference Manual.

-1-

2. Distribution Kit Contents
With each new order of a fully supported TSX-Plus operating system, you should
receive:
1.

Installation guide - this is it.

A machine readable medium containing the components of the TSX-Plus
operating system - this may be a reversible single density diskette,
an RL01 or RL02 disk, or magnetic tape.

TSX-Plus Reference Manual and TSX-Plus System Manager's Guide.

-2-

3. System Prerequisites
3.1.

Hardware

TSX-Plus is implemented on the PDP-II series of computers manufactured by
Digital Equipment Corporation. TSX-Plus uses the memory management hardware
available on most DEC computers. Specifically, TSX-Plus may be used on the
following computers:
LSI-11/23, PDP-11/23-PLUS, LSI-11/73, MICRO/PDP-II,
PDP-11/24, PDP-11/34a, PDP-11/44 and PDP-11/60. (TSX-Plus may not be used on
LSI-11/2, PDP-11/03 or VAX computers.) Some older machines which support memory
management may also use TSX-Plus. All of these computers support memory up to
at least 256Kb. TSX-Plus requires at least 128Kb of memory. On the LSI-II
bus, the PDP-11/23-PLUS, LSI-11/73, and MICRO/PDP-II support more than 256Kb of
memory whereas the LSI-11/23 may support more than 256Kb of memory only if the
backplane is configured for 22-bit addressing.
The only Digital devices
currently supported with 22-bit DMA addressing on the LSI-II bus are those
using the DL handler (RL01 and RL02) , the DU handler (RA80, RC25, RD51, and
RX50) and the MS handler (TSV05). All other DMA device handlers only support
18-bi t addressing on the LSI-II bus and therefore must use the TSX-Plus I/O
mapping facility if the system has more than 256 K bytes of installed memory.
On the Unibus, the PDP-11/24 and PDP-ll/44 support more than 256Kb of memory
with the necessary hardware. Although it is not impossible to use TSX-Plus on
a system with only floppy disks, this configuration is highly discouraged due
to the frequency with which information is shuttled back and forth from disks
in the multi-user environment.
3.2.

Software

Al though TSX-Plus completely replaces the RT-11 kernel during operation of
TSX-Plus, it must be started from the RT-11 Single-Job or Baseline monitor. In
addition, the necessary utilities and device handlers are provided with RT-11.
TSX-Plus supports many of the keyboard commands of RT-11 Version 5, but it may
be run wi th either RT-11 Version 4 or 5.
At tempts to use features which
require RT-11 Version 5 utilities will generate error messages when used with
RT-11 Version 4 utilities. Both Logical Subset Disk and Single Line Editor
features are separately implemented in the TSX-Plus kernel, they do not use the
LD or SL handler, and are available whether TSX-Plus is used with either RT-11
Version 4 or, 5.

-3-

~ Do

you need to perform ~ TSX-Plus system generation?

In order to tailor the features of TSX-Plus for your particular installation
TSX-Plus is shipped as several program modules. The module named TSGEN.MAC is
provided to allow special modification for the needs of your site. It contains
all the parameters which are modifiable by TSX-Plus users and allows selective
inclusion of various optional features of TSX-Plus. It also allows specification of the peripheral devices and terminals which are to be used by
TSX-Plus. The short-cut method of installing TSX-Plus described later in this
guide assumes certain system configurations which may be more or less suitable
for your site. The short-cut installation makes the following assumptions:
1.

The system disk is one of:
or RK05.

You have a console terminal at the standard vector and address, and
additional terminals are connected through DL(V)11 type interfaces.
You must perform a TSX-Plus system generation in order to use DZ(V)11
type multiplexors.
The vectors and CSR addresses for time-sharing
terminal interfaces are assumed to be:
Line

Vector

Address

60
310
320

177560
176510
176520

2
3

RLOl, RL02, RK06, RK07, RA80, RC25, RD51

(operator's console)

Your printer will be spooled (see the TSX-Plus Reference Manual for a
discussion of printer spooling); will use the LP device handler; is
attached through a LP(V)11 type interface; and is not configured at
any of the vector/address combinations defined for time-sharing lines
(see list above; the default LP CSR=177514 and vector=200).

You do not require any of the following optional features:
Log-on or device access control.
Generalized or shared file cache.
Performance monitoring.
Shared run-time systems.
Virtual arrays or virtual overlays.

(The functions of these features are described in both the TSX-Plus
Reference Manual and the TSX-Plus System Manager's Guide.)
6.

You do not have or plan to use memory above 256Kb.

If your requirements differ from these, then it will be necessary for you to
perform a complete TSX-Plus system generation procedure. The TSX-Plus System
Manager's Guide describes the TSX-Plus system generation process. Note that
the short-cut installation procedure does not copy from the distribution medium
all of the files necessary for a complete system generation; if you need to
perform a TSX-Plus system generation, copy all of the files from the distribution disk(s) to a working surface. In ca~ in which there are no hardware
conflicts with the above restrictions, it may be useful to use the short-cut

-4-

installation method to verify the correct interaction of TSX-Plus with your
hardware and to gain experience with the TSX-Plus system before selecting the
parameters which must be specified in TSGEN.MAC for generation of the TSX-Plus
system.

-5-

5. TSX-Plus Short-cut Installation Procedure
There are three simple steps to the short-cut installation procedure:
1) Assign the logical device name "IN" to the device containing the TSX-Plus
distribution files.
If your distribution was supplied on floppy diskette then
files must be transferred from both sides of the diskette.
The short-cut
installation command file (MAKTSX. COM) will prompt you to replace the input
volume (turn the diskette over) at the appropriate time.
In the following
examples, the unit number "n" refers to the unit containing the distribution
medium.
If TSX-Plus was distributed on a floppy diskette:
.ASSIGN DYn IN
or
.ASSIGN DXn IN
If TSX-Plus was distributed on an RLOI or RL02 disk:
.ASSIGN DLn IN
If TSX-Plus was distributed on magnetic tape:
.ASSIGN MTn IN
or
.ASSIGN MSn IN
or
.ASSIGN MMn IN
2) Assign the logical device name "DK" to a working surface on which TSX-Plus
will be assembled and linked. Approximately 1400 free blocks are necessary on
the working surface; about 700 blocks for files copied from the distribution
and about 700 blocks for files created during the installation process. For
example:
.ASSIGN DLI DK
The system disk also requires approximately 2000 free blocks to contain the
executable TSX-Plus program, utilities, device handlers, job swapping and spool
files.
These figures reflect the mlnlmum total free space required. If insufficient
free space is available, remove unnecessary files. If the free space is badly
fragmented, it may be necessary to squeeze the fragmented surface.

-6-

3) Use the command file provided to copy, assemble, link and start TSX-Plus •
• @IN:MAKTSX
In order to install TSX-Plus, you must be booted from the RT-ll Version 4 or 5
Single-Job or Baseline monitor. The Foreground/Background and XM monitors do
not leave enough room to run the TSX.SAV module and will report an error if you
try to start TSX-Plus from them.
(This is also true of some RT-ll Single-Job
monitors which have been "sysgenned" and include too many features, such as
multi-terminal support; in this case, copy the original Single-Job moni tor
(RTllSJ.SYS) from your RT-ll distribution and boot it before running TSX-Plus.)
To reiterate the short-cut installation procedure:
5.1

Boot the RT-ll Single-Job or Baseline monitor. If you normally use
either the Foreground/Background or XM moni tor, type the following
command:
.BOOT R'fllSJ

5.2

Assign logical names to the device holding the TSX-Plus distribution
files and to the device on which TSX-Plus will be built.
For
example:
.ASSIGN DXO IN
.ASSIGN DLI DK
(DX and DL are examples, use the correct devices for your site.)

5.3

Prepare at least 2000 free blocks on the system disk, and 1400 free
blocks on the work disk.
You can verify the presence of the
necessary free space with the DIRECTORY commands:
.DIR/FREE SY:
.DIR/FREE DK:

5.4

Execute the command file (MAKTSX. COM) on the distribution medium
which copies the necessary files to the system disk and to the
working disk, builds, copies to the system disk and starts TSX-Plus •
• @IN:MAKTSX
This command file will prompt you to replace the input volume at the
appropriate time.
If you received TSX-Plus on a floppy diskette,
then turn the diskette over at this time and type Y and then press
the RETURN key.
If you received TSX-Plus on a large disk or on
magnetic tape, just type Y and enter a RETURN in response to this
prompt.
In either case, when you are asked to replace the output volume, just
type Y and press RETURN.

-7-

5.5

You should now be running TSX-Plus.
At this point, a greeting
message containing S&H's copyright notice and the date and time
should appear on the operator's console.
TSX-Plus is now ready to
accept a command. The monitor prompt is a period (".").
The greeting message will appear on other terminals when they are
on-line and a carriage return is typed on their keyboards.
If this short-cut installation does not succeed or if any errors are
reported at any point in the process: review the requirements listed
above for the short-cut installation process; review the common
errors described in the next section; read the TSX-Plus System
Manager's Guide before performing a TSX-Plus system generation for
your system configuration.

5.6

Once TSX-Plus is successfully installed, you may subsequently start
it, after booting the RT-11 Single-Job monitor, with the command:
.R TSX

5.7

You can verify the operation of TSX-Plus at any time while it is
running by using the SYSTAT command to display the status of the
system and all current time-sharing jobs.
The SYSTAT command is
described in the TSX-Plus Reference Manual, as are all other valid
TSX-Plus commands.
The SYSMON utility program may also be used to
dynamically display system and job parameters.
Use of the SYSMON
program is described in Appendix E of the TSX-Plus System Manager's
Guide.
The SYSMON program may only be used with VT100 or VT52 type
terminals.

-8-

~ TSX-Plus

Installation and System Generation Hints

Whether using the short-cut installation process described here or using the
complete system generation process described in the TSX-Plus System Manager's
Guide, various types of errors can occur and be reported during the installation process. The errors discussed in this section are those most commonly
encountered when first installing TSX-Plus.
A complete listing of start-up
error messages which may be reported by TSX-Plus are included in Appendix B of
the TSX-Plus System Manager's Guide.
Appendix C of the TSX-Plus System
Manager's Guide lists those fatal system error messages which may be reported
at any time during the operation of TSX-Plus; these are usually indicative of
an unusual hardware condi tion.
If an error is reported during start-up of
TSX-Plus which is not described in those two appendices J it will have originated from RT-ll before TSX-Plus took control; see the RT-11 System Message
Manual for descriptions of RT-ll error messages.
Error message: ?PIP-F-Device full
---There is not enough free space on the output disk to copy all
distributed files. The system disk requires about 2000 free blocks:
about 400 blocks for the executable files and handlers, about 1100
blocks for the swap file, and an additional 500 blocks for the spool
file. The working disk requires about 1400 free blocks: about 700
blocks for distributed source and object files, and about 700 blocks
for files created while generating TSX-Plus.
Remove unnecessary
files from the system and working disks and squeeze if necessary.
~rror

message: ?KMON-F-Not enough memory (RT-11 V4)
?KMON-F-Insufficient memory (RT-11 V5)
The base of the monitor is too low to load the TSX.SAV program.
Unload some resident device handlers and SET USR SWAP. TSX-Plus may
not be started from the RT-llFB or RT-l1XM monitors.
The TSX.SAV
program must be run from the RT-11 Single-Job or Baseline monitor
which has NOT been sysgenned to include mul ti -terminal support.
Copy the original RT-1l Single-Job monitor (RT11SJ .SYS) from your
RT-11 distribution and boot it before running TSX-Plus.
II

Error message: ?TSX-F-( *** error message displayed here *** )
-----See the TSX-Plus System Manager's Guide, Appendix B for descriptions
and remedies for fatal errors which occur during start-up of
TSX-Plus.
No response from terminals:
The operator console is established wi th vector=60 and CSR=177560.
This and all other time-sharing terminals must have their hardware
interface vector and CSR address settings declared to TSX-Plus by
parameters in the file TSGEN.MAC before assembling and linking the
TSX-Plus sys tem. Only DL (V) 11 type interfaces are usable wi th the
short-cut installation method; DZ(V)ll multiplexors require that you
perform a TSX-Plus system generation.
The short-cut installation
process assumes that time-sharing lines are configured as follows:

-9-

TSX-Plus
Line II

Vector

CSR

--------

------

--------

1
2
3

60
310
320

177560
176510
176520

Error message: ?TSX-F-Fatal system error @nnnnnn
(EEE-error message displayed here)
Arg. value = xxxxxx
Seg. value = yyyyyy
The most common causes of this error are incorrect device vector and
address specifications.
If the vector is incorrect, the error
message will be:
"UEI-Interrupt occurred at unexpected location".
If the address is incorrec t, the error will be:
"KTP-Kernel mode
trap".
Review the default time-sharing line vectors and addresses
above. The only other devices declared to TSX-Plus in the short-cut
installation method are the following:
Device

Vector

CSR

------

--------

DL
DM
DU
DY
LP
NL
RK

160
210
154
264
200
N/A
220

174400
177440
172150
177170
177514
N/A
177400

The vector and address assigned to the printer may be changed using
the keyboard "SET" command after TSX-Plus has been started, but
before printing anything; see the next paragraph. See the TSX-Plus
System Manager's Guide, Appendix C for explanations of other fatal
error messages.
Printer does not respond:
The interface hardware for the printer must correspond to the address
specified in the device handler LP. TSX. If your printer is not at
the default vector and address, then after starting TSX-Plus, but
before printing anything, use the keyboard handler "SET" options to
set the correct vector and address.
SET LP VECTOR=nnn
SET LP CSR=nnnnnn
The printer vector and address must not conflict with those defined
for any time-sharing-terminal line. After setting the correct vector
and address in the LP.TSX file, reboot the system and restart
TSX-Plus with the command:
.R TSX

-10-

+-------------------------------------------------------------------------+
I
* Software Problem Report *
I
+-------------------------------------------------------------------------+
I From:
I Mail to: S&H Computer Systems, Inc. I
I
I
I
I Contact=
I
I OEM:

I
I
I
I
I Phone:
i

I
I
I
I
I
I
I
I
I
I

Lie € n self :

I
I
!

I
I Phone:
I

I Telex:
I
I

I Date:

1027 17th. Avenue South
Nashville, Tennessee USA
37212
(615)-327-3670
786577

S&H NAS

+-----------------------------------+-------------------------------------+
I S&H product:
TSX:
TSX-Plus:
COBOL-Plus:
RTSORT:
I
I
I
I Ve r s ion If:

INDAS:

Other:
r. PIT Mod e 1 ~

+-------------------------------------------------------------------------+
I
Report Classification:
I
I
I
Severe error
I
Moderate error
!
Minor error
I --- Documentation error

I
I
I
I
I

Suggestion
Inquiry
Comment
Other

--+-----------------------------------+-------------------------------------+
Problem description / Comment:
I

All submissions become the property of S&H Computer Systems,

Inc.

+-------------------------------------------------------------------------+
S&H Response:
Received:
Verified:
Resolved:
-----

----

---

+-------------------------------------------------------------------------+