Digital PDFs

XX-11EFB-40

September 1984

35 pages

Original

1.3MB

Document:	PRO TSX PLUS Installation Guide
Order Number:	XX-11EFB-40
Revision:	0
Pages:	35
Original Filename:	http://bitsavers.org/pdf/dec/pdp11/tsxPlus/manuals_5.0/PRO_TSX_PLUS_Installation_Guide_Sep84.pdf

OCR Text

PRO/TSX PWS™
Installation Guide

s&h computer systems, inc.

PRO/TSX PWS™
Installation Guide

s&h computer systems, inc.

PRO/TSX-Plus~

INSTALLATION INSTRUCTIONS

Important Note: The PRO/TSX-Plus distribution disk is copy protected, do not
attempt to copy it before installing ~ as this may make ~ impossible to
perform an installation.
The distribution disk may be copied for backup purposes as you desire, but only
after it has been "unlocked" by the installation procedure. Also note that the
distribution disk may only be used to install PRO/TSX-Plus on a single
computer. Contact S&H if you require additional distribution disks for other
Professional computers.
Perform the following steps to install PRO/TSX-Plus on your Professional:
1.

Boot RT-ll/FB on the Professional.
RT-ll/XH.

PRO/TSX-Plus cannot be started under

Insert the distribution disk into the top RX50 disk drive (DZO:).

Type the following command:
RUN DZO:INSTSX

The installation process takes several minutes to automatically copy the
necessary PRO/TSX-Plus files to your system disk.
Should any errors
occur during the installation procedure, see the PRO/TSX-Plus Installation Guide.
Once the installation
PRO/TSX-Plus by typing:

complete

you

may

start

the

execution

R TSX
5.

PRO/TSX-Plus takes about 15 seconds to get started on the Professional.
The console terminal should automatically start. Other terminals may be
started as time-sharing lines by typing a carriage return.
These
include terminals connected to the communications port, the printer port
(if properly wired) and ports on the quad serial line unit (quad SLU).
Altogether, only five time-sharing lines may be active at any given
time.
This includes any combination of the console, communications
port, printer port, or ports connected to the quad SLUe

If you need to restart RT-ll, the system must be powered off and back
on. The $STOP command is not functional on the Professional.

Once the installation has successfully completed, the distribution disk may be
copied for backup purposes. The PRO/TSX-Plus system on the distribution disk
(as well as on the system disk) will have been conditioned for the specific
Professional computer on which the installation took place.
Subsequent
execution of the installation procedure may only be done on the system on which
the original installation took place.
If your Professional should require repair involving replacement of the mother
board, be sure the engineer puts the original ID rom chip into the new mother
board.

PRO/TSX-Plus Installation Guide Addendum

A facility has been added to PRO/TSX-Plus to allow the "F2·· function key
to cause the current contents of the Professional console screen to be
written to the printer. To use this facility the PROPRT program must be
running (usually as a detached job) and logical device name ·'LP:" must be
assigned to the printer port.
PRO/TSX-Plus uses the printer port as a time-sharing line by default.
order to use it for a printer, a CL unit must "take-over·' the line.

A command file (PROPRT.COM) is supplied with the PRO/TSX-Plus distribution
to perform the operations necessary to provide the F2/print-screen
function. This command file may either be executed as a command file from
a primary or virtual line (although not from the primary line attached to
the console) or may be used to start a detached job - the normal method.,
PROPRT.COM contains the

SET eL2 LINE=2
SET CL2 SPEED=4800
SET CL2 FORM
SET CL2 FORMO
ASSIGN CL2 LP
R PROPRT

followip~

commands:

Assign CL2 to printer port
Set baud rate to 4800
Printer supports form feeds
Form feed at start of file
Assign LP: to CL2
Run the PROPRT.SAV program

This command file is usually run as a detached jobe It may be started as
a detached job any time while PRO/TSX-Plus is running. Alternatively, it
may be automatically started as a detached job by copying PROPRT. COM to
DET2. TSX, which is one of the two start-up detached job command files
specified by PRO/TSX-Plus. During installation of PRO/TSX-Plus, an option
is presented which can cause PROPRT.COM to be copied to DET2.TSX,
resulting in - its automatic startup as a detached job.

process provides a
following question:

brief

explanation of

this

feature,

The installation

then asks

the

Include print-screen detached job [Y/N1 ?
If you intend to use the printer port for a printer, and you want the
console F2 key to dump the screen to the printer, then answer Yes. This
will cause the file PROPRT.COM to be copied to DET2.TSX, which is
automatically started as a detached job whenever PRO/TSX-Plus is started.
If you intend to use the printer port as a time-sharing line, then you
should not start PROPRT.COM as a detached job.
To avoid copying
PROPRT.COM over DET2.TSX, and thus not automatically starting it as a
detached job with PRO/TSX-Plus, answer No tQ this question.

PRO/TSX-Plus
Installation Manual

Fourth Edition
First Printing -- September, 1984
Copyright © 1984.
S&H Computer Systems, Inc.
1027 17th Avenue South
Nashville, Tennessee USA
37212-2299
(615)-327-3670

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, PRO/TSX-Plus, COBOL-Plus, PRO/COBOL-Plus, SORT-Plus and
RTSORT are proprietary products owned and developed by SoH 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 produc ts should be
addressed to S&H Comp:uter Systems, Inc., 1027 17th Ave.
South, Nashville,
Tennessee 37212-2299, (615)-327-3670, TELEX 786577 S AND H UD.
TSX, TSX-Plus, PRO/TSX-Plus, COBOL-Plus, PRO/COBOL-Plus, SORT-Plus and RTSORT
are trademarks of S&H Computer Systems, Inc. DEC, DIBOL, PDP, Professional,
Q-BUS, RT-11 , UNIBUS, VAX, VMS and VT are trademarks of Digital Equipment
Corporation. DBL is a trademark of Digital Information Systems Corporation.

CONTENTS
INTRODUCTION • • • • • • • • • • • • • • • • • • • • • • • • • • • • • ••

Chapter 1
DISTRIBUTION KIT CONTENTS

........................

Chapter 2
SYSTEM PREREQUISITES • • • • • • • • • • • • • • • • • • • • • • •

Chapter 3
INSTALLATION INSTRUCTIONS

........................

Chapter 4
SOFTWARE NOTES • • • • • • • • • •
Start-up and detached command files • • • • • •
Redirecting the printer port
Redirecting the communication port • • • •
Using the printer port as a time-sharing line • •
Using the communication port as a time-sharing line
Unsupported SETUP commands - SAVE and RESET • • • • •

10
10
10
11
11
11

Chapter 5
INSTALLATION HINTS • • • • • • • •

13
Appendix A

TSGEN PARAMETER LIST • • • • • •

. . . . . . . . . . . . . . . . . . . . . 15

Contents - 1

INTRODUCTION

The purpose of this guide is to help you install PRO/TSX-Plus on your Professional system in the quickest and easiest way possible. Read this entire guide
before attempting to install or use PRO/TSX-Plus.
This guide describes the
contents of the distribution kit, necessary system resources, and the procedure
for installing a functional version of PRO/TSX-Plus.
This guide is intended for the person installing PRO/TSX-Plus and assumes some
familiarity with the commands and utilities of RT-II, including: handling of
magnetic media; use of IND control files; and the R[UN] command.
TSX-Plus is a multi-user, multi-tasking operating system which provides the
functionality of the RT-II operating system to multiple users on Digital
Equipment Corporation LSI-I~ and PDP-II computers. The PRO/TSX-Plus operating
system is designed to provide the TSX-Plus operating environment to multiple
users on the Professional computer and embodies the functionality of TSX-Plus,
without the ability to perform system generations.
Since PRO/TSX-Plus and TSX-Plus provide the same functionality, the TSX-Plus
Reference Manual and the TSX-Plus System Manager's Guide contain information
which is common to both systems. However, since PRO/TSX-Plus has preselected
generation parameters, the system generation listing (see Appendix A) may be
referred to when consulting these manuals to determine which optional features
have been included.
The TSX-Plus Reference Manual describes the functional
differences between RT-II and TSX-Plus, including additional keyboard commands,
unsupported commands, and other minor variations between the two operating
systems.
The TSX-Plus System Manager's Guide provides detailed information
necessary to manage system resources. The TSX-Plus manuals are intended to be
used in conjunction with the RT-II manuals; refer to the RT-ll manuals for
descriptions of features which are not discussed in the TSX-Plus Reference
Manual.

-1-

-2-

1. DISTRIBUTION KIT CONTENTS
Wi th each new order of a supported PRO/TSX-P Ius operating system, you should
receive:
1.

Installation guide - this is it.

A machine readable RX50 floppy containing the components of the
PRO/TSX-Plus operating system.

TSX-Plus Reference Manual.

TSX-Plus System Manager's Guide.

-3-

-4-

SYSTEM PREREQUISITES

2.1 Hardware
PRO/TSX-Plus is implemented on the Professional series of computers manufactured by Digital Equipment Corporation.
PRO/TSX-Plus uses the memory
management hardware and requires at least 512Kb of memory.
At least 2600 unused disk blocks on the system device are required to perform
the full installation procedure.
The installation procedure uses the IND
control processor, therefore IND.SAV must be on the system device.

-5-

-6-

3. INSTALLATION INSTRUCTIONS
Important Note: The PRO/TSX-Plus distribution disk is copy protected, do not
attempt to copy it before installing it as this may make it impossible to
perform an installation. It may be copied for backup purposes as you desire,
but only after it has been "unlocked" by the installation procedure. Also note
that the distribution disk may only be used to install PRO/TSX-Plus on a single
computer. Contact S&H if you require additional distribution disks for other
Professional computers.
Perform the following steps to install PRO/TSX-Plus on your Professional:
1.

Boot RT-ll/FB on the Professional.
under RT-ll/XM.

PRO/TSX-Plus cannot be started

Insert the distribution disk into the top RX50 disk drive (DZO:).

Type the following command:
RUN DZO: INSTSX

Once the installation is complete you may start the execution of
PRO/TSX-Plus by typing:
R TSX

PRO/TSX-Plus takes about 15 seconds to get started on the Professional.
The console termin~l should automatically start~
The
communications port and printer port (if properly wired) can be
started as time-sharing lines by typing a carriage return.

If you need to restart RT-ll, the system must be powered off and back
on. The $STOP command is not functional on the Professional.

Once the installation has successfully completed, the distribution disk may be
copied for backup purposes. The PRO/TSX-Plus system on the distribution disk
(as well as on the system disk) will have been conditioned for the specific
Professional computer on which the installation took place.
Subsequent execution of the installation procedure may only be done on the
system on which the original installation took place.
If your Professional should require repair involving replacement of the mother
board, be sure the engineer puts the original ID rom chip into the new mother
board.

-7-

-8-

4. SOFTWARE NOTES
When running on the Professional, the console, the printer port, and the
communications port may be used as time-sharing lines. Thus, the Professional
may support up to 3 time-sharing userse The printer port and the communications port may also be used as communication lines ("CL" lines) to drive
serial peripherals such as printers, plotters, and modems.
A summary of the system characteristics is listed below:
1.

The console terminal, printer port, and communications port are generated
as time-sharing terminals but may alternatively be used as communications
lines. The printer port and communications port are set up to do autobaud
speed recognition and will support terminals at 110, 300, 1200, 4800, and
9600 baud. The communications port supports modem control and may be used
either hardwired or with dial-up modem control.

Support is included for three virtual lines and two detached jobs.

Three Communication Line (CL) units are generated into the system but are
not initially assigned to any of the terminal ~ines. CLO and eLL are
unspooled units. CL2 is a spooled device. The spool file reserves space
for 20 files and 250 blocks.

The following system features are included:
a)

Support for a 64K byte virtual job region (plus PLAS regions -- see
below).

Generalized data caching with 300 blocks in the data cache.

PLAS (Program Logical Address Space) support for up to 250K bytes of
total virtual array/overlay extended memory regions.

Shared file record locking, supporting up to 50 shared files and 100
shared file channels.

Message communication with up to 4 queued messages of 200 byte length
and 5 message channels.

Support for user defined commands, logical subset disks, the single
line editor, program debugging facility, and the SYSMON utility.

Support for 20 I/O channels (zero through 19.) per time-sharing line.

A full listing of the system generation parameters chosen for the pregenerated
PRO/TSX-Plus system is provided in Appendix A.

-9-

Software Notes

4.1 Start-up and detached command files
Start-up command files are specified for each of the three time-sharing lines.
Two detached command files are included in the system. The names of these
command files are:
Line

Command file

Console terminal
Printer port
Communications port
Detached file
Detached file

SY:LINEl.TSX
SY:LINE2.TSX
SY:LINE3.TSX
SY: DETI. TSX
SY:DET2.TSX

If you wish to use the LOGON program to control access to the system, you
should place the following commands in the start-up command file for the line:
A(SET ERROR FATAL
R/LOCK LOGON
OFF
Other commands t such as turning on the single line editor or assigning LP to a
communications line may be placed in the start-up command file in front of the
"R/LOCK LOGON" command.
4.2 Redirecting the printer ~
Communication Line (CL) unit CL2 is generated as a spooled device.
The
following commands can be used to direct CL2 to the printer port and set the
speed to 4800 baud which is the default speed for the Professional printer:
SET CL2 LINE-2
SET CL2 SPEEn-4800
ASSIGN CL2 LP
ASSIGN CL2 LS

Direct CL2 to printer port (line 2)
Set speed to 4800 baud
Assign LP to CL2
Assign LS to CL2

If the printer port will always be used for a printer, these commands can be
conveniently issued whenever PRO/TSX-Plus is started by including them in one
of the detached command files (e.g., SY:DETl.TSX).
4.3 Redirecting the communication port
Communication units CLO and CLI are unspooled communication units.
The
following commands can be used to direct CLO to the communications port and set
it up for use by the VTCOM program:

-10-

Software Notes

SET CLO LINE=3
SET CLO SPEED=nnnn
SET CLO NOLFOUT
ASSIGN CLO XC

Direct CLO to corom port (line 3)
Select communications speed (usually 300 or 1200)
Don't transmit line feed chars
Assign logical device used by VTCOM

A CL unit may not be assigned to a time-sharing line which is in use. The
following commands can be used to disassociate CL units from the lines
reenabling them for use as time-sharing lines:
SET CLO LINE=O
SET CL2 LINE=O
4.4 Using the printer port ~~ time-sharing line
If the printer port is used as a time-sharing line, a cable must be constructed
to connect it to a terminal.
The following pins on the printer port are
significant:
Pin

Function

2
3
6
7

Transmit data
Receive data
Data set ready
Signal ground

In addition, pins 8 and 9 must be connected together with a jumper.
set ready signal on pin 6 must be asserted by the terminal.

The data

4.5 Using the communication port as ~ time-sharing line
The communications port has a standard DB25 (RS232) connection.
is provided for the communications port.

Modem support

4.6 Unsupported SETUP commands ~ SAVE and RESET
The SETUP program may be used under PRO/TSX-Plus to control the operation of
the Professional. However, operator privilege is required to run SETUP and the
SAVE and RESET functions are not implemented.
WARNING: Do not attempt to use the SAVE function as it may damage the PI.SYS
file.

-11-

-12-

5. INSTALLATION HINTS
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 PRO/TSX-Plus. A complete listing of start-up
error messages which may be reported by PRO/TSX-Plus are included in Appendix A
of the TSX-Plus System Manager's Guide. Appendix B 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 PRO/TSX-Plus; these are usually indicative
of an unusual hardware condition. If an error is reported during start-up of
PRO/TSX-Plus which is not described in those two appendices, it will probably
have originated from RT-l1 before PRO/TSX-Plus took control; see the RT-ll
System Message Manual for descfiptions of RT-ll error messages.
?PIP-F-Device full
There is not enough free space on the system disk to copy all
distributed files.
The system disk requires about 2600 unused
blocks:
about 550 blocks for the executable files and handlers,
about 1800 blocks for the various swap files, and an additional 250
blocks for the spool file. Remove unnecessary files from the system
disk and squeeze if necessary.
?KMON-F-Insufficient memory
The base of the monitor is too low to load the TSX. SAV program.
PRO/TSX-Plus may not be started from the RT-IIXM monitor.
The
TSX.SAV program must be run from the RT-l1 Foreground/Background
monitor which has NOT been "sysgenned".
If necessary, copy the
original RT-11 Foreground/Background monitor (RTIIFB.SYS) from your
RT-11 distribution and boot it before running PRO/TSX-Plus.
?TSX-F-( *** error message displayed here *** )
See the TSX-Plus System Manager's Guide,-Appendix A for descriptions
and remedies for fatal errors which occur during start-up of
PRO/TSX-Plus.
No response from communication port:
Check the connections to insure that the wiring is correct and test
the port under RT-ll.
The communication port is generated as a
time-sharing line. If you are using the communication port as an I/O
device (for example to run VTCOM), see the information in Chapter 4
on redirecting the communication port.
No response from terminals:
Check the connections to insure that the wiring is correct and test
the ports under RT-11. If the hardware is wired and working properly
and the installation was performed successfully, the terminal will
respond.

-13-

Installation Hints

No response from printer:
Check the connections to insure that the wiring is correct and test
the port under RT-ll.
The printer port is generated as a timesharing line.
If you are using the printer port for a printer, you
should use the spooled communication line to direct output to this
port.
It is necessary to know the speed of the printer which is
connected to this port (the default Professional printer speed is
4800 baud).
See the section in Chapter 4 on redirecting the printer
port.

-14-

Appendix ~= TSGEN PARAMETER LIST
PRO/TSX-Plus has been generated with various system parameters which select the
features available. A brief summary of these characteristics is described in
Chapter 4.
The following listing describes the options chosen and which
constitute the PRO/TSX-Plus environment. Since PRO/TSX-Plus is available only
as a preconfigured system, no alterations may be made to these choices. Device
handlers used in PRO/TSX-Plus are standard RT-11 XM handlers and do not require
alteration.
;~a~==_=============~================================= =========

The TSX-Plus system manager alters values in the following
section to customize the system for a particular configuration.
System parameters:
Swap file device-file specification.
SWDBLK: .RAD50

/SY TSXSWPTSX/

Spool file device-file specification.
SPLBLK: .RAD50

/SY TSXSPLTSX/

PLAS region swap file specification.
RSFBLK: .RAD50

/SY TSXRSFTSX/

Maximum amount of memory that can be used by any job (# K bytes).
This value must not exceed 64. (Kb)

64.

HIMEM

jMax memory that any job may use

Default memory size for jobs that will be in effect when the job
logs on. (Specify in # K bytes).

DFLMEM =

64.

jDefault memory limit for jobs

Number of 512-byte blocks to allocate for swap file that is used
for extended memory PLAS (Program's Logical Address Space) regions
that are used by jobs that have virtual overlays or virtual arrays.
Note that this is the total space in the PLAS swap file for all
extended memory regions in use at any time by all jobs.
Note: In a non-swapping system (SWAPFL=O), SEGBLK must be non-zero
if PLAS support is wanted, but its value does not matter.
SEGBLK

500.

;# blocks for PLAS swap file

SWAPFL controls whether TSX-Plus is allowed to swap jobs to disk if
insufficient memory is available to hold all active users.
The normal case (SWAPFL=l) allows TSX-Plus to do job swapping.
SWAPFL can be set to 0 (zero) in special situations such as when a
small number of lines are being supported on a floppy disk based system
-15-

TSGEN Parameter List

that does not have room for a swap file.
If SWAPFL is set to zero the following actions occur:
1. No disk swap file is created.
2. A line will not be allowed to log on if there is insufficient
free memory space to support it.
3. Each job is allocated a memory size equal to DFLMEM (default job
memory size).
4. The MEMORY command cannot be used to change the job size.
SWAPFL

;l==)Allow job swapping; O==)Do not swap.

BUSTYP defines the machine bus structure for TSX-Plus. Their are two
possible machine bus ,structures supported by TSX-Plus - the QBUS (LSI)
and the UNIBUS. Select one of these parameters below to specify the
bus support desired. Use the following information for choosing the
correct bus structure.
QBUS
- 11/23, 11/23-Plus, 11/73, and Professional.
UNIBUS - 11/24, 11/34a, 11/44, and 11/60.
BUSTYP

QBUS

;Specify machine bus structure (UNIBUS/QBUS)

Enable 22-bit addressing for the 11/23-Plus, 11/24, 11/44, and 11/73.
This feature requires the use of either the 22-bit extended memory
mapping for the LSI or the UNIBUS. This feature must be enabled to
allow TSX-Plus to utilize more than 256Kb of memory.
EXTMCH

;l==)Allow 22-bit addressing; O==)Do not use 22-bit.

Memory upper limit size specification expressed in number of k-bytes.
This parameter controls the maximum memory available for TSX-Plus
system use. Memory above this upper limit will not be used by the
operating system.
If the ~mMSIZ parameter is set to 0 (zero), TSX-Plus will use all
available memory on the machine. To disable the use of extended
memory, set MEMSIZ to 248 or less.
MEMSIZ

;Upper memory limit

The INIABT parameter controls the action taken by TSX-Plus when
certain errors are detected during system initialization.
If INIABT=O, TSX-Plus ignores the error and continues running.
If INIABT=l, TSX-Plus aborts initialization and prints an error message.

*************************************************
** The normal and recommended setting for
**
** this parameter is INIABT=I. It is cleared **
** for the short-cut installation method.
**
*************************************************

-16-

TSGEN Parameter List

The following initialization errors are controlled by the INIABT flag:
1. A device that was specified in TSGEN is not installed in RT-11
or does not have a TSX-Plus handler on the system disk.
2. A time sharing line that was generated into, TSX-Plus is not
installed on the machine.
3. A shared run-time syste~ file could not be found during startup.
INIABT

;O==)Continue on error, 1==)Abort on error

The IOABT parameter controls the action taken by TSX-Plus when
a job terminates execution. If IOABT=O, TSX-Plus will wait for
all outstanding I/O pending for the job to complete before the job
is actually terminated. If IOABT=1, TSX-Plus will call the handler
abort entry point for all outstanding I/O pending for the job.
Note, the "SET 10 [NO]ABORT" keyboard command may be used to
change the value of this p~rameter.
IOABT

;0==)1/0 rundown, 1==)1/0 abort

U$CL is a flag that controls whether the User Command Linkage is to
be used to allow users to define their own commands.
If U$CL is non-zero the UCL facility is enabled and users may define
their own system commaqds. If U$CL is zero, user defined commands
will not be supported by the system. Note: if the UCL facility is
enabled, the TSXUCL.SAV file must be placed on the system disk.

U$CL

jO==)No UCL program, 1==)VCL program

Number of user-defined commands that can be stored by TSXUCL
for each job. (The number of blocks required in the SY:TSXUCL.DAT file
is approximately equal to the number of commands per job times the
total number of time-sharing lines divided by 5).
UCLMNC

20.

;Maximum user-defined commands per job

The UCLORD parameter selects the default call order for checking
to see if a command is a user-defined command.
FIRST ==) Check for user-defined commands before system commands.
MIDDLE ==) Check after system commands but before command files.
LAST
==) Check after system commands and command files.
Note that the SET UCL FIRST/LAST keyboard command can be used to
alter this order on a line~by-line basis.
UCLORD

MIDDLE

jSelect FIRST i MIDDLE I LAST

The LDSYS flag controls whether the standard system support for
logical disks (LD) is to be provided.
If LDSYS is set to 1, system support for logical disks is included.
If LDSYS is set to 0, system support for logical disks is excluded.

-17-

TSGEN Parameter List

LDSYS

;l==>Include LD support, O=a>Exclude LD.

The SLEDIT flag controls whether the Single Line Editor (SL) facility
is to be made available to the system.
If SLEDIT is set to 1, Single Line Editor support is included.
If SLEDIT is set to 0, Single Line Editor support is omitted.
Single Line Editor support adds approximately 2Kb to the size of the
mapped portion of the system.
SLEDIT

;l==>Include SL support, O==>Exclude SL

Set DBGFLG to 1 to cause the TSX-Plus program debugging facility
to be included with the system.
Set DBGFLG to 0 if the debpgging facility is not wanted.
DBGFLG

;l==>Include debugger; O==>Exclude debugger

The following time-slice values are used to schedule jobs for execution.
Each time value must be specified in 0.1 second units.
QUANO -- Time slice for round-robin scheduling of high-priority
real-time jobs. That is, jobs with execution priorities
greater than or equal to PRIHI.
2.

QUANO

;Time slice for real-time jobs

QUAN1 -- Time that jobs will remain in a high-priority state after
they receive an activation character from the terminal.
A job is classified as "interactive" from the time when an
activation character is received until the job consumes
QUAN1 units of time, then the job is classified as "compute
bound".
20.

QUAN1
QUAN1A

QUAN1A

QUAN1B
QUAN1B
QUAN1C
QUANIC

;High-priority time for interactive jobs

Time that jobs will remain in a high-priority state after
they are activated because of I/O co~pletion or they are
restarted following other wait states.
2.

;High-priority time for wait-reactivation

Time slice used to switch between "interactive" jobs.
2.

;Time slice for "interactive" jobs.

Time job will be allowed to stay in highest execution state
after receipt of a character from the terminal.
1.

;Time at highest execution state
-18-

TSGEN Parameter List

QUAN2 -- Time that normal priority CPU~bound jobs are allowed to run
if there are no high-priority jobs that want to run.
This time-slice controls round-robin scheduling of CPU-bound jobs
with execution priority values in the range (PRILOW+1) to
(PRIHI-1).
QUAN2
QUAN3

,
QUAN3
INTIOC

INTIOC
HIPRCT

HIPRCT

10.

;Normal-priority CPU-bound job time-slice

Time slice for round-robin scheduling of very low priority
jobs~ That 18 7 jobs with priorities less than or equal
to PRILOW.
20.

;Time slice for very low priority jobs

Number of consecutive times that a job will be allowed to
perform I/O operations following input of an activation
character from the terminal before the job is classified
as non-interactive.
30.

;Number of I/O ops. while "interactive".

Number of consecutive times that a job will be given a
high-priority execution boost following wait states such
as I/O wait before the job will be scheduled as a normal
CPU-bound job.

40.

;Number of consecutive high-priority hits

Time that job will be held in memory after being swapped in from disk.
A job is not eligible to be swapped out of memory until CORTIM has
elapsed since it was swapped into memory. However, the job becomes
immediately eligible to be swapped if it goes into a state where it is
waiting on any resource other than non-terminal I/O.
Specify in 0.1 second units.
CORTIM

;Guaranteed memory-residency time

Job priority classes: There are three groups of job priorities,
the lowest priority group ranges from a job priority 0 up to and
including the priority equal to the PRILOW parameter. Jobs with
priorities in this range execute with lower priority than all normal
time-sharing jobs.
The second range of priorities is from (PRILOW+1) up to (PRIHI-l).
Jobs in this range are treated as normal time-sharing jobs.
The third range of priorities is from PRIHI up to 127. These priorities
are for real-time jobs which will take unconditional precedence over
all other jobs.
All priority values must be in the range a to 127.

-19-

TSGEN Parameter List

19.
80.

PRILOW
PRIHI
PRIDEF

Default job priotity.
50.

PRIDEF

;Highest "low priority" value
;Lowest "high priority" value

;Default job priority

PRIVIR -- Amount by which a job's execution priority is reduced
when the job is disconnected from the terminal by switching
to a virtual line. Note: this only applies to jobs with
base priorities in the range (PRILOW+l) to (PRIHI-l).
10.

PRIVIR

;Disconnect job priority reduction

Maximum number of virtual lines per primary line.

MAXSEC

;Max virtual lines per user

Maximum file size (D blocks) that will be returned in response to
a .ENTER request that specifies a file size of 0 blocks.
MAXFIL

1000.

;Max # blocks for default allocation

Number of 512 byte blocks to hold in memory in a generalized data cache.
If the CACHE parameter is set to 0 (zero), data caching is not performed.
Note: The data caching facility adds approximately 2000 bytes to the
size of the unmapped portion of the system and 528*CACHE bytes to
the mapped portion of the system.
CACHE

300.

;Number of blocks in data cache

The following parameters relate to the cache of file directory entries
maintained by TSX-Plus. This cache is used to reduce the number of disk
accesses required to do lookups on frequently accessed files.
The system disk (SY:) is automatically cached.
Other devices are only cached if they are introduced to the system
by use of the MOUNT command.
Maximum number of units that may be cached.
This includes all logical disks (LD) and all physical disks for which
directory caching is enabled by use of the MOUNT command.
(Space required is 14 bytes per unit).
MAXCSH

30.

;Max # device units whose directories to cache

Maximum number of file entries to be held in directory cache.
(Space required is 18 bytes per entry)
l'i"MFCSH

60.

;Max # file entries to be cached

-20-

TSGEN Parameter List

Maximum number of device units that can be allocated to jobs for exclusive
use by use of the ALLOCATE command.
MAXALC

jMax # units that can be allocated

Maximum number of simultaneous requests by jobs to monitor other jobs.
MAXMON

;Max # job monitoring requests

Amount of time that carrier signal must be lost on dial-up
lines before we assnme the connection has been broken.
This value is also used to time-out lines which ring and
do not raise carrier.
Specify in 0.5 second units.
120.

;Allow 60 seconds of lost carrier.

Amount of time that a user may remain connected to a dial-up line
after logging off before Data Terminal Ready (DTR) will be
dropped causing the phone to hang up.
Specify in 0.5 second units.
OFFTIM

60.

;Time allowed for job to be logged off

Define Lead-in character that tells TSX-Plus that a special
terminal control sequence is coming from the program.
TSLICH

;Octal 35 = decimal 29.

Define the keyboard control character that will be used to
switch between virtual time-sharing lines.
(Specify the octal value of the ASCII control character)
VLSWCH

jOctal 27 = control-W

Define maximum number of user defined activation characters
that each line may define during execution.
MXSPAC

16.

;Max # user defined activation chars per job

Select default system editor.
The choices are
EDIT
TECO
~D

K52
EDITOR

jDefault system editor

Select system default implicit or explicit wildcards for CCL commands.
-21-

TSGEN Parameter List

DEVDEF
DEVDEF
DEVDEF
DEVDEF
DEVEND

<DW)
<DZ>
<NL)
<ZZ),MAPH
;End of device definitions

;-------------------------------------------------------------------------Parameters related to system I/O buffers used when DMA devices
with 18-bit controllers are used on Q-bus systems with
22-bit addressing (e.g., 11/23-Plus and 11/73).
Number of system buffers allocated for I/O buffering.
(The recommended number is one per active device that requires buffering.)
MIONBF

;Number of system I/O buffers

Size of each system I/O buffer, in units of 512 bytes.
The maximum allowed value for this parameter is 15.
MIOBSZ

;1/0 buffer size in units of 512 bytes

;-------------------------------------------------------------------------Define those devices which are to be spooled by TSX-Plus
(such as line printers).
There are seven arguments to the SPOOL macro:
1. Number of devices to be spooled (may be zero).
2. Number of spool files which may bg open by all users.
3. Number of spool buffers (512. bytes each).
4. Number of blocks in spool disk file.
S. List of 3 character names of devices to be spooled.
6. Specify
if spool files are to be eligible to be
started as soon as they are created,
specify 1 if they are to be held until the channel
is closed. Note: The "SPOOL xx, [NO]HOLD" keyboard
command can override this parameter.
7. Number of blocks which are to be backed up
when the "SPOOL xx, BACK" command is given.

Note: The SPOOL macro must be present even if
there are no spooled devices. However, if the first
argument (number of spooled devices) is zero, no spool
tables are generated and arguments 2-7 are ignored.
SPOOL

1,20.,2,250.,<CL2),O,5.

;---------------------------------------------------------------Define parameters pertaining to record (block) locking
for shared files. If the shared file block locking
facility is not wanted, set all of these parameters to
(zero).

-23-

TSGEN Parameter List

Maximum number of shared files which may be open
simultaneously. Note that several users accessing the same
file count as 1.
MAXSF

50.

;Max number of shared files

Maximum number of I/O channels which all users may
simultaneously have open to shared files.
Note, this is the total number for all users not
for each user.
MAXSFC

100.

;Max # shared file channels

Maximum number of blocks which may be simultaneously
held locked by any channel. That is, max blocks
locked per channel.
MXLBLK

;Max blocks lo~ked per channel

Number of 512-byte blocks to be held in the in-memory data
cache for shared files.
(Note that the MAXSF, MAXSFC, and MXLBLK parameters must be
non-zero to enable shared file data caching.)

NUMDC

;Number of blocks in shared file data cache

;-----------------------------------------------~----------------

Define parameters pertaining to the inter-program
message communication feature. If this feature is
not wanted, set all four parameters to 0 (zero).
Maximum number of message communication channels
which may be simultaneously in use.
MAXMC

;Max message channels

Maximum message length (bytes).
MSCHRS

200.

;Max message length (bytes)

Maximum number of messages which may be held in queue.
6.

MAXMSG

;Max queued messages

Maximum number of requests for messages that may be held in queue
MAXMRB

;Max # pending message requests

;----------------------------------------------------------------------------24-

TSGEN Parameter List

The RTVECT parameter is used to control whether the TSX-Plus
real-time support facility is to be included in the system being
generated. If RTVECT is set to 0 (zero) the real-time support facility
is not included in the system being generated. If RTVECT is greater
than zero, the real-time support facility is included.
Set RTVECT to the maximum number of interrupt vectors that all running
real-time programs may be connected to at the same time.
Note: The RTVECT parameter must be non-zero if the SYSMON system monitor
and display program is going to be used.

RTVECT

;Max # interrupt vectors that may be connected

;------------------------------------------------------------------------Define the size of the table within TSX-Plus used to hold information
when the performance monitoring feature is being used.
Each word in this table corresponds to one cell in the histogram.
Specify the size as number of bytes for the table,
(Note: The maximum allowed size is 8192 bytes)

;Size of performance monitor table (bytes)

;---------------------------------------------------------------------------Use the RTDEF macro at this point to specify information about
any shared run-time systems to be loaded when TSX-Plus is started.
The form of the RTDEF macro is
RTDEF
<name),r-flag,skip-count
Where
- Name is the 12 character name of the file containing the run-time system
which must be specified in the form DevFilnamExt -- that is, three
character device name, six character file name and three character
extension.
- R-flag is either R if user programs are to have read-only access to
the run-time system, or RW if read-write access is to be granted.
- Skip-count is the number of blocks to be skipped over at the front
of the file when loading it.
Example:
RTDEF
RTDEF

<SY CBR050SHR),R,I.
<SY DBLSHRRTS),R,I.

;COBOL-Plus shared run-time
;DBL shared run-time

;-----------------------------------------------------------------------Time-sharing line parameters:
Default input and output character buffer sizes.
These buffer sizes will be used for lines that don;t use
the BUFSIZ macro within their line definitions to declare
their character buffer sizes.
These buffer sizes are also used for all virtual lines.

-25-

TSGEN Parameter List

DINSPC
DOTSPC

190.
240.

;Default input char buffer size
;Default output char buffer size

When the terminal-output character buffer is filled a job is suspended.
The job is restarted after characters are printed from the buffer and
there are OTRASZ characters remaining in the buffer.
25.

OTRASZ

;Reactivation character count

A software character "silo" is used to hold characters received
from time-sharing lines until they can be processed by the system.
The silo is used to prevent the loss of characters during high
speed input. Each time-sharing line and CL line has its own silo.
If the input to the line is coming from a terminal, the silo can be
quite small. On the other hand, if the input is coming from another
computer or other high speed device, the silo size should be increased.
The NCSILO, NCXOFF, and NCXON parameters set default values pertaining
to the silos. The SILO macro can be used within a line definition
to specify silo parameters for a specific line.
Default size of input character silos.
44.

NCSILO

;Default silo size

The system will transmit a control-S (XOFF) character when an input
silo is filled to the point where there are only NCXOFF free
character positions remaining.
12.

NCXOFF

;Default XOFF point for silos

If the system sends an XOFF because a silo becomes nearly full,
it will send an XON to restart transmission when there are only
NCXON characters remaining in the silo.
NCXON

;Default XON point for silos

Number of "extra" CL (communication line) units to be genned into
system. These CL units are not initially assigned to any line but
may be used "take over" a time-sharing line to use it as a CL unit.
The total number of CL units (those defined using CLDEF blocks plus
the extra units) may not exceed 8.

CLXTRA

;Number of extra CL units.

Default output ring buffer size for I/O communication lines defined
with the CLDEF macro and accessed as "CL" devices.
The recommended value is «3*baud_rate)/1000+2).
CLORSZ

32.

;Size of CL output ring buffers
-26-

TSGEN Parameter List

;---------------------------------------------------~=~~---------------------

Flags which can be used with the FLAGS macro within
a line definition block to define line characteristics.

$SCOPE
$ECHO
$TAPE
$8BIT
=
$START
$NODET
$TAB
$FORM
$AUTO
=
$LC
$NOVLN
$DEFER
$QTSET
$PRIV
$PHONE =

100000
40000
20000
10000
4000
2000
1000
400
200
40
20
10
4
2
1

;ON==)CRT type terminal
;ON==)Echo characters to terminal
;ON==)"Paper-tape" mode (do x-on/x-off control, etc.)
;ON==>Support 8 bit (rather than 7 bit) characters.
;ON==)Automatically start line during initialization
;ON==)Disallow use of detached jobs
;ON==)Do not simulate tabs (Terminal handles tab char)
;ON==)no not simulate form-feeds (Terminal handles FF)
;ON==)Do auto baud speed selection for line
;ON==)Enable lower-case input
;ON==)Disallow use of virtual lines
;ON=~>Do defered character echoing (recommended)
;ON==>Set tt quiet (Don't list command files)
;ON==)Allow job to use privileged system features
;ON==)Dial-up, modem connected line

Default line flags that will be used for each line that does
not explicitly specify flags using a FLAGS macro.
NRMFLG

$ECHO!$DEFER!$LC!$PRIV

;----------------------------------------------------------------------Terminal type names that are legal to used with the TRMTYP macro
within a line definition block to define the terminal type.
VT100 ~=> DEC VT100

VT200 ==) DEC VT200 with 7 bit control codes
VT52 ==) DEC VT52
LA36 ==) DEC LA36
LA120 ==) DEC LAl20
HAZEL ==) Hazeltine brand terminals
ADM3A ==) Lear Siegler ADM3A
DIABLO==) Diablo brand terminals (with X-ON/X-OFF protocol)
QUME ==) Qume brand terminals (with X-ON/X-OFF protocol)
• PAGE

;-----------------------------------------------------------------Line definitions

The TBLDEF macro call requires four arguments:
1. The number of real (physical) time-sharing lines on machine.
2. The number of virtual time-sharing lines desired.
3. The number of detached job lines to be generated.
4. The number of dedicated CL lines.

-27-

TSGEN Parameter List

TBLDEF

3.,3.,2.,0.

;# Real, # Virtual, # Detached, # CL lines

Define primary (real) time-sharing lines
LINDEF
CMDFIL
TRMTYP
FLAGS
LINEND

60,177560,OPER ;Use console terminal as tIs term
LINE1.TSX
VT 100
NRMFLG!$PRIV!$START!$SCOPE!$TAB

LINDEF
FLAGS
CMDFIL
TRMTYP
LINEND

220,173400
NRMFLG!$AUTO
LINE2.TSX
VT100

LINDEF
FLAGS
CMDFIL
TRMTYP
LlNEND

210,173300
jCommunications port
NRMFLG!$AUTQ!$PHONE
LINE3.TSX
VT100

;Printer port

,,
Use the "DETACH" macro here to declare any start-up command
files to be run as detached jobs.
DETACH
DETACH

SY:DET1.TSX
SY:DET2.TSX

jStart-up detach job command file

,·=========================================~===c======= ==
END OF SECTION OF TSGEN TO BE ALTERED BY USER

,·=================================a=======================

-28-

Index
Cable connection
Communication port, 11
Printer port, 11
CL lines
Communication port, 10
For VTCOM, 10
Printer port, 10
Communication port
For a time-sharing line, 11
For communication, 10
Detached command files, 10
Device handlers, 15
Distribution kit, 3
Errors during installation, 13
Installation
Errors, 13
Hints, 13
Instructions, 7
Requirements,S
Printer port
For a printer, 10
For a time-sharing line, 11

PRO/TSX-Plus
Detailed selected features, 15
Summary of features, 9
TSX-Plus relationship, 1
Redirect~ng

Communication port, 10
Printer port, 10
SETUP
RESET command, 11
SAv"E command, 11
Software notes, 9
Statup-up command files, 10
System requirements, 5
TSGEN parameter list, 15
TSX-Plus
PRO/TSX-Plus relationship, 1
Reference Manual, 1
System 11anagsr's Guide, 1
Unsupported commands
SETUP RESET, 11
SETUP SAVE, 11
VTCOM
Using on comm port, 10

-29-