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