TCP/IP Package For TSX-Plus Documentation

-... 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.



      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) 

=> Section Index

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
                  .ENDM   UMRDEF
   ;  Define UMR sets in order of size -- small to large.
   CURUMR  =       5       ;Map regs 0-4 always mapped
                  .IF     EQ,<BUSTYP-UNIBUS>      ;Generate only
                  UMRDEF  1.                      ;for UNIBUS
                  UMRDEF  1.                      ;machines
                  UMRDEF  4.
                  UMRDEF  4.
                  UMRDEF  8.
                  UMRDEF  8.

   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.  

=> Section Index



     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

   The  number of shared global PLAS regions that can be created
by all jobs.  

NGR = 27.       ;Number of global PLAS regions


        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)

=> Section Index



       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-

DEVXMR = 4.     ;Number of XM regions for device handlers 

=> Section Index



     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 

=> Section Index



     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. 


=> Section Index

Message Communication


     Each  active client/server program of the TCP/IP Pack-
     age allocates 1 message channel for interprocess  com-

   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.  

=> Section Index

Line Definitions


     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
      TRMTYP  VT100
; CL0: is cross linked to #3 time-sharing line
      CLDEF   0,350,175610
      SILO    256.,12.,4.

=> Section Index



     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 

=> Section Index

Record Locking


     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 

=> Section Index

User Command Linkage


     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 

=> Section Index

... Exit TCP/IP Documentation

... Home Page

Last Updated: June 2008