... TSX-Plus System Generation
The TSX-Plus system must be regenerated to provide the necessary device support, system services, and options required by the TCP/IP Package. What follows is a description of each option that should be examined and updated to allow the proper operation of the various hardware and software components of the TCP/IP Package.
BUSTYPE
NOTE
The DEQNA device used by the TCP/IP Package is a QBUS
device. The DEUNA/DELUA device used by the TCP/IP
Package is a Unibus device.
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 in-
formation 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)
TSGEN Unibus Mapping
A change to the TSX-Plus TSGEN.MAC file is required to allo-
cate 4 UNIBUS MAPPING REGISTERS for the 22-bit EU22.TSX driver
when used with systems having more than 248. kbytes of address-
able memory.
The mapping registers are only required when more than 248.
Kbytes of memory are used by TSX-Plus on a Unibus system.
The following was excerpted from TSGEN.MAC:
******************************************************
;
; Generate tables for Unibus map registers
;
.GLOBL UMRBAS,UMREND,UMRWHD
UMRWHD: .WORD 0
.MACRO UMRDEF NUM
.BYTE CURUMR ;UM$UMR
.BYTE NUM ;UM$NMR
.WORD NUM*4096. ;UM$WDS
.WORD 0 ;UM$IOQ
CURUMR = CURUMR+NUM
.ENDM UMRDEF
; Define UMR sets in order of size -- small to large.
CURUMR = 5 ;Map regs 0-4 always mapped
UMRBAS:
.IF EQ,<BUSTYP-UNIBUS> ;Generate only
UMRDEF 1. ;for UNIBUS
UMRDEF 1. ;machines
UMRDEF 4.
UMRDEF 4.
UMRDEF 8.
UMRDEF 8.
.ENDC
UMREND:
******************************************************
Change the first 'UMRDEF 8.' to 'UMRDEF 4.' This will free
the last 4 UNIBUS MAPPING REGISTERS for use by the 22-bit
EU22.TSX driver.
NGR
NOTE
The TCP/IP Package uses PLAS regions for passing data
and parameters between the network server and the
various client/server tasks. Each active client pro-
gram uses at least one region. FTP variants (FTP,
FTPL, or RFTP) use an additional region during data
transfers.
The number of shared global PLAS regions that can be created
by all jobs.
NGR = 27. ;Number of global PLAS regions
NOTE:
When configuring the NGR parameter in TSGEN.MAC
TSGEN.MAC (The total number of 'shared' global
regions used by all jobs) the minimum value must
be set to the sum of the number of time share
lines plus the total number of subprocess windows
plus the number of TCPIP sockets plus one. This
is required even though the subprocess windows
are not shared.
When configuring the TBLDEF parameters
in TSGEN.MAC, e.g. with
TBLDEF 2.,8.,10.,1.
a value of 2 + 8 + 16 + 1 is the minimum value
required for NGR.
It has been observed that if the detached jobs
parameter is increased much beyond 10 TSX becomes
unstable with heavy network access and will
consistently freeze. This effect is quite
repeatable and may change with different system
configurations. (TSX-Plus V6.5)
DEVXMR
NOTE
The DEQNA/DEUNA/DELUA device handlers use 1 PLAS region
Some device handlers allocate extended memory (PLAS) regions
for their use. For example, the DU and MU handlers each require
one PLAS region. If you are using any other handlers which re-
quire extended memory regions, include the number of regions re-
quired.
DEVXMR = 4. ;Number of XM regions for device handlers
IOABT
NOTE
The TCP/IP Package Network Server which uses the
DEQNA/DEUNA/DELUA handlers internally queue the net-
work requests. If IOABT is not set to 1 then the Net-
work Server program cannot be aborted. This will also
be true for the remote TELNET and CNCT servers which
must abort I/O through the CL device handler.
The IOABT parameter controls the action taken by TSX-Plus
when a job terminates execution. If IOABT=0, 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 IO NO ABORT" keyboard command may
be used to change the value of this parameter.
IOABT = 1 ;0==>I/O rundown, 1==>I/O abort
DEVDEF
NOTE
The device handler, EQ.TSX or EU.TSX must be added to
the list of system handlers loaded by TSX-PLUS at sys-
tem startup. The handler may be mapped, uses DMA, and
should not allow SET operations on the loaded handler.
DEVDEF <EQ>,DMA,MAPH,NOSET
Message Communication
NOTE
Each active client/server program of the TCP/IP Pack-
age allocates 1 message channel for interprocess com-
munication.
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 = 24. ;Max message channels
Maximum message length (bytes).
MSCHRS = 16. ;Max message length (bytes)
Maximum of messages which may be held in queue.
MAXMSG = 64. ;Max queued messages
Maximum of requests for messages that may be held in queue.
MAXMRB = 24. ;Max pending message requests
The message length used by TCPIP programs is only 16. bytes.
Thus the MSCHRS term can be changed to 16. if no other user
programs use the message channels. This change reduces the size
of the TSX+ image by about 2K bytes.
Line Definitions
NOTE
If the remote TELNET or CNCT servers are to be
enabled, then a pair of cross connected serial lines
must be added to the Line Definition table for each
active session. The following Line Definitions il-
lustrate the additions required. If more than one
pair of lines are added then select sequential time
share and sequential CL lines. The SILO length de-
finition for the CL line should be greater than or
equal to the maximum number of characters it will re-
ceive in .5 seconds (120 for 2400 baud or 240 for 4800
baud). This will reduce XON/XOFF sequences and max-
imize the serial transfer rate.
; The TBLDEF macro call requires four arguments:
; 1. The number of real time-sharing lines on machine.
; 2. The number of subprocess jobs.
; 3. The number of detached jobs.
; 4. The number of dedicated CL lines.
TBLDEF 3.,10.,6.,1. ;# Real, # Subprocess,# Detached, # CL lines
; #3 time-sharing line is cross linked to CL0:
LINDEF 340,175600
CMDFIL LINE3.TSX
TRMTYP VT100
FLAGS NRMFLG
LINEND
; CL0: is cross linked to #3 time-sharing line
CLDEF 0,350,175610
SILO 256.,12.,4.
CLEND
DETACH
NOTE
The command file DETACH.TSX is used to startup the
Network Server.
Use the "DETACH" macro here to declare any start-up command
files and associated parameters (up to 80 characters) to be run
as detached jobs:
DETACH <SY:DETACH.TSX> ;Start-up detached job
Record Locking
NOTE
If the MAIL, RSMTP, MMAIL, MAILER, RPOP3, or RLPD pro-
grams are to be used then record locking is necessary
to properly update the mail sequence files.
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 0 (zero).
Maximum number of shared files which may be open simul-
taneously. Note that several users accessing the same file
count as 1.
MAXSF = 4. ;Max number of shared files
Maximum number of I/O channels which all users may simul-
taneously have open to shared files. Note, this is the total
number for all users not for each user.
MAXSFC = 16. ;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 = 16. ;Max blocks locked per channel
User Command Linkage
NOTE
The file TCP:TSXUCL.INS contains over 40 UCL defini-
tions, however a typical user may require only a few
of them.
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 de-
fine their own system commands. 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 = 1 ;0==>No UCL program
;1==>UCL 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 = 12. ;Maximum user-defined
;commands per job
... Exit TCP/IP Documentation
... Home Page
Last Updated: June 2008