Home

MatchBox User Manual

Contents

1. cd cdrom cdrom0 solaris2 5 Add the Solaris 2 packages pkgadd d pwd all When prompted for an installation directory press Return for the default opt t ranstech or type an alternative installation directory 6 Eject the CD ROM from the drive eject cdrom 3 2 Password A password file opt ranstech tdpasswd is required on Solaris 2 systems This file contains one or more passwords one for each host computer with a connected MatchBox Passwords can be obtained from your local Transtech office by quoting the host id of the workstation as displayed by the hostid command 3 3 Environment A number of environment variables should be set IBOARDSIZE IDEBUGSIZE ITERM ISEARCH ISERVER ICONDB ASERVDB Memory size of the first Transputer board Memory size of the first Transputer board used by idebug The file containing terminal keyboard and screen codes The list of directories on which the Iserver will search for certain files if the full pathname is not specified Include the tp 41libs directory for use with the 4th generation Inmos ANSI C Toolsets Dx414 Full pathname of the Iserver program Relative to the installation directory this is bin iserver server is described in Chapter 5 Full pathname of the connection database See section 4 1 for details Full pathname of the Aserver database file 12 MatchBox User Manual MBX M 711 Soft
2. lt gt S T E C H Parallel Systems MatchBox User Manual Ref MBX M 711 Document reference number MBX 711 Copyright 1997 Transtech Parallel Systems This publication is protected by Copyright Law with all rights reserved No part of this publication may be reproduced stored a retrieval system translated transcribed or transmitted in any form or by any means manual electric electronic mechanical chemical optical or otherwise without prior written permission from Transtech Parallel Systems Transtech reserves the right to alter specifications without notice in line with its policy of continuous development Transtech cannot accept responsibility to any third party for loss or damage arising out of the use of this information Transtech acknowledges all registered trademarks Transtech Parallel Systems Corp Transtech Parallel Systems Ltd 20 Thornwood Drive Ithaca NY 14850 1263 USA tel 607 257 6502 fax 607 257 3980 transtech transtech com http www transtech com 17 19 Manor Court Yard Hughenden Avenue High Wycombe Bucks HP13 5RE United Kingdom tel 444 0 1494 464303 fax 444 0 1494 463686 support transtech co uk http Awww transtech co uk Table of Contents 2 Chapter 1 Introduction 1 1 1 Manual Conventions 1 Chapter 2 Hardware Installation 3 2 1 Power Connection 3 2 2 SCS
3. preceded by t2 Test M212s T2s 225s only t4 Test 4145 T425s only t8 Test T800s only 1 Log progress of testing 36 MatchBox User Manual MBX M 711 Check Utilities load NAME load Loads files onto Transputer in a network SYNOPSIS Unix check load n Filel File2 f filename in Jw E cu DOS check load n Filel File2 f filename in Za umo DESCRIPTION load is a utility used in conjunction with check which loads a file or files onto a processor in a Transputer network The host link connection to use is specified by the SPUTER environment variable using the syntax cmtnlo where m is the SCSI controller number or SCSI bus number n is the SCSI target Id and o is the host link number OPTIONS In Unix options are preceded by DOS options are preceded by n Filel File2 Load Transputer n with a number of files in sequence f filename Use check command file in Set default iserver path to Transputer n l Log progress of load h Display this help page MBX M 711 MatchBox User Manual 37 Reference mtest Test memory of Transputers in a network SYNOPSIS Unix check mtest c e Kb i iter 1 t tp 12 41 T 204 1 4 581 20 205 check mtest e 1 i iter 1 1 t tp t2 t4 1 1 E 1 EL 70 1 h 1 DESCRIPTION
4. 75 SCSI Commands READ BUFFER Byte Byte 0 Operation Code 3Ch Logical Unit Number ij il Mode Buffer Offset MSB Buffer Offset Buffer Offset LSB Allocation Length MSB Allocation Length Allocation Length LSB JOJN The READ BUFFER command reads data from the MatchBox target buffer or returns a description of the buffer The target buffer is an array of memory on the MatchBox with the same size as the flash EPROM i e 512K With Mode set to 010b up to Allocation Length bytes of data are transferred from the target buffer starting at offset Buffer Offset With Mode set to 011b a descriptor of up to four or Allocation Length bytes is returned Bit 7 6 5 4 3 2 1 0 0 Offset Boundary 0 1 Buffer Capacity MSB 08h Buffer Capacity 00h Buffer Capacity LSB 00h 76 MatchBox User Manual MBX M 711 Index Symbols login 13 A ASERVDB 12 41 Aserver 41 Block size 59 Boot r flag 14 Break out board 8 BUSY 60 C check 31 32 43 CHECK CONDITION 60 ckmon 31 34 Command descriptor block CDB 61 Configuration link 60 Connection database 13 15 D D connector 7 pinout 7 Disconnects 60 E Environment variables 12 F Flash EPROM 75 76 ftest 31 36 G genio 27 GOOD 60 H Host link Name 15 hostmux 21 IBOARDSIZE 12 ICONDB 12 15 IDEBUGSIZE 12 IDENTI
5. mtest is a utility used in conjunction with check which tests the memory of processors in a network of Transputers The host link connection to use is specified by the SPUTER environment variable using the syntax cmtnlo where m is the SCSI controller number or SCSI bus number n is the SCSI target Id and o is the host link number OPTIONS In Unix options are preceded by In DOS options are preceded by c Include T2s with C004s on links default no E Kb Sets ceiling in Kbytes to which memory is tested i iter Number of iterations Log progress of testing t tp Test processor tp only t2 Test T2s only t4 Test T4s and T8s only q Quick memory sizing option Extra information why memory search stopped 38 User Manual MBXM 711 Check Utilities 0 Do not include root processor in tests h Display help page MBX M711 MatchBox User Manual 39 Reference 40 MatchBox User Manual 711 Aserver Chapter 7 Aserver Sa The Inmos Aserver based tools such as rspy and the Inquest debugger can be used with the MatchBox Set the environment variable ASERVDB to point to the supplied Aserver database file tp 4libs aservdb Please see the Inmos documentation for details of the format of the Aserver database file The value of the environment variable TRANSPUTER is used in conjunction with the Aserver database file to determine the host int
6. char name int mode int genio_close int fd int genio_read int fd char buf int int genio_write int fd char buf int int genio_lseek int fd long int offset int origin void genio_control int iotype int param DESCRIPTION The generic I O library implements faster versions of the Inmos Toolset low level file I O functions Several tech niques are included that give optimal results on different kinds of hardware This is done by allowing a larger iserver packet size up to 4096 bytes to be used than normal 512 bytes or in the case of the 16 motherboard by DMA direct to the BIOS disk controller routines All operations on files opened using genio_open must be formed using the genio library functions and not using the default library functions Similarly the genio library functions should not be used on files opened using the nor mal open function On multi processor systems the server channels should be multiplexed using hostmux lku and not the occam procedure so multiplexor This routine should also be used instead of so buffer The open close read write and lseek routines are used in MBX M711 MatchBox User Manual 27 Reference Section the same way the corresponding Inmos routines taking exactly the same parameters By default the library performs standard Iserver I O with 512 byte packets genio control is used to specify what type of I O opti
7. This command will terminate after one second if the requested data or one 4096 byte block is not received on the corresponding link CHECK CONDITION status is returned A subsequent REQUEST SENSE command returns sense data with Sense Key set to ABORTED COMMAND 8h Additional Sense Code set to 08h and Additional Sense Code Qualifier set to 01h After such a timeout it is an error for subsequent RECEIVE commands to request less data than is outstanding from previous RECEIVE commands The behaviour of the RECEIVE command depends on the Protocol and Block Size as set by WRITE FLAGS In protocols other than raw mode the value of Allocation Length must be the same as the Block Size as set by WRITE FLAGS otherwise the command terminates with CHECK CONDITION status In raw mode an attempt is made to input Allocation Length bytes of data from the host link In Iserver mode an attempt is made to input an iserver protocol packet two byte count plus count data bytes of up to Allocation Length bytes in total Allocation Length must equal the protocol Block Size In block mode an attempt to input a block of data of length Allocation Length on the host link is made Allocation Length must equal the protocol Block Size 68 MatchBox User Manual MBXM 711 SCSI Reference Disconnects are used to minimise SCSI bus usage during this command If disconnect
8. be used to interface to a wide range of other Inmos Transputer based systems On multi user workstations up to four users can concurrently access the PARAstation resources per MatchBox In addition to these four host links a fifth configuration link is implemented which allows the network configuration of the PARAstation to be set When using a Transtech PARAstation system this manual should be read in conjunction with the PARAstation User Manual Please note that a password is required to use the MatchBox with a UNIX host See section 3 2 on page 12 for details Passwords can be obtained from your local Transtech office 1 1 Manual Conventions Commands filenames e t c are printed in courier font Command lines which are to be typed at the Unix prompt are printed thus command except for commands which are required to be run by root or superuser which are printed thus command The contents of files or the output of programs is printed thus First line Second line MBX M711 MatchBox User Manual 1 Manual Conventions Where relative filenames or directory names are quoted i e filenames not starting with a then these should be interpreted as being relative to the software installation directory See the relevant software installation section for details of the installation directory 2 MatchBox User Manual MBX 711 Hardware Installation Chapter 2 Hardware Installation The Transt
9. by tsp_open data Pointer to memory into which data is read length The maximum amount of data to be read timeout Timeout in seconds Zero for no timeout DESCRIPTION A call to tsp_read requests the target to read up to length bytes of data from the host link By default a raw link protocol is used in which the target attempts to input length bytes of data in 4096 byte blocks until a timeout occurs If iserver link protocol is used an iserver packet of total length of up to length or 4096 bytes containing a two byte count and count bytes of data is input In block link protocol mode an attempt is made to read a block of data of length length The link protocol and block size is set using tsp_protocol In protocol modes other than raw mode the length of data requested must be the same as the block size specified by the function tsp_protocol If a timeout occurs during a read it is an error to subse quently request a lesser amount of data until either the original request is satisfied or until the connection is reset using tsp_reset RETURN VALUES Returns the number of bytes read which may be less than that requested on success or 1 on error MBX M 711 MatchBox User Manual 53 TSP Library tsp_read_config NAME tsp_read_config Read data from the configuration link SYNOPSIS include lt tsplib h gt int tsp_read_config int fd void data size_t length int timeout ARGUMENTS fd Descriptor
10. ee ede eei tc 50 protocol uie ie 51 tsp read 53 read cOnflg uite etenim 54 15 x 55 Isp reset conflg en epe Co 56 TSP M 57 write config tec ceils eere c tee 58 Appendix A SCSI Reference 59 Host Links tcia E O 59 A 2 Configuration Link 60 Subsystems 5 e cte ee cue teo epo rts 60 A 4 Miscellaneous eeeeeeeseeseee eene na 60 5 SCSI Commands 61 TESTUNIT READY 1 EIER et eee de 62 READ FLAGS 63 REQUEST SENSE aust aie 64 WRITE FLAGS india dian eS 66 ii MatchBox User Manual MBX 711 RECEIVE 68 READ CONFIG 70 SEND a rite 71 WRITE CON FG T atu eei ei 72 INQUIRY ARM 73 SEND DIAGNOSTIC eese 74 WRITE BUFFER 5 rte eee 75 READ BUFFER 76 Index 77 MBX M711 MatchBox User Manual iv MatchBox User Manual MBX 711 Introduction Chapter 1 Introduction Transtech MatchBox is primarily designed to interface the SCSI port of a workstation to Transtech PARAstation systems However the MatchBox can equally
11. host link using tsp_open The host link is specified by the device parameter which has the format cmtnlo where m is the SCSI controller or bus used is the target SCSI id and is the link number 0 3 For example c0t510 specifies link 0 on the target with id 5 on SCSI bus 0 Note that root privileges are required on some systems to use this function RETURN VALUES Returns zero on success or 1 on error MBX M711 MatchBox User Manual 49 TSP Library tsp_open NAME tsp_open Open a host link connection SYNOPSIS include lt tsplib h gt int tsp_open char device ARGUMENTS device Name of host link to open DESCRIPTION A connection to a host link is created by a call to tsp open The link to connect to is specified by the device parameter which has the format cmtnlo where m is the SCSI controller or bus used n is the target SCSI id is the link number 0 3 For example 0 510 specifies link 0 on the target with id 5 on SCSI bus O0 RETURN VALUES Returns a non negative descriptor on success or 1 on error 50 MatchBox User Manual MBX M 711 TSP Library tsp_protocol NAME tsp_protocol Set a host link read protocol SYNOPSIS include lt tsplib h gt int tsp_protocol int fd int protocol int block_size ARGUMENTS fd Descriptor returned by tsp_open protocol Link protocol block_size Block size The supported values of prot
12. FY 61 Inquest 41 INQUIRY 60 73 Installation Hardware 3 Software 11 iocache 25 ISEARCH 12 ISERVER 12 Iserver 15 16 17 19 ITERM 12 L Link protocols 59 load 31 37 MBX M 711 MatchBox User Manual 77 Logical unit number 61 Logical units 59 LUN 61 man 13 18 MANPATH 13 MatchBox 1 Connectors 3 mtest 31 38 Password 12 Path 13 pkgadd 11 pkgrm 11 probe scsi 6 14 R READ BUFFER 76 READ CONFIG 60 70 READ FLAGS 59 63 Rebooting 13 RECEIVE 59 68 REQUEST SENSE 60 64 rspy 41 5 SCSI Disconnects 60 Id 5 Id switch 3 Reset 64 Status 60 Termination 5 SEND 59 71 SEND DIAGNOSTIC 74 Status 60 Subsystems 60 T TEST UNIT READY 62 Timeouts 60 TRANSPUTER 13 15 16 17 41 tsp analyse 45 tsp close 47 tsp error 48 tsp mknod 49 tsp open 50 tsp protocol 51 tsp read 53 tsp read config 54 tsp reset 55 tsp reset config 56 tsp write 57 tsp write config 58 tspconf 43 44 TSPLIB 45 U Unit attention condition 60 W WRITE BUFFER 75 WRITE CONFIG 60 72 WRITE FLAGS 59 66 78 MatchBox User Manual MBX M 711
13. I Connection oo eter IET 4 2 2 1 SCSI Cabling and Termination 5 2 2 2 MatchBox SCSI ld esee 5 2 3 PARAstation Connection sss 7 2 34 Die Gorntiecltor idees 7 Chapter 3 Software Installation 11 3 1 11 3 2 PassWord cate ode cd dei 12 3 9 EnVIFOnmett 22 14 12 3 4 Connection Database 13 3 5 REBOOTING 13 Chapter 4 Host Link Names 15 4 1 Connection Database 15 Chapter 5 Iserver 17 17 5 2 Iserver Libraries 17 5 3 Reference Section 19 Ele 19 21 ioca he DE 25 27 711 MatchBox User Manual i Chapter 6 Check Utilities 31 6 1 Reference 32 CHECK Em 32 22255252 e eee tee 34 TEST IRE UBER ete Ee ia 36 x eee e eed 37 ERRARE entis 38 Chapter 7 Aserver 41 Chapter 8 Configuration 43 8 1 dedi adi ete nett 44 ie 44 Chapter 9 TSP Library 45 Isp analyse er 45 tsp 6lOS gc uidet cette 47 ISp eror ts eI Ben Wee 48 TSP eo 49 15 EE
14. ND DIAGNOSTIC Bit 7 6 5 4 3 2 1 0 Byte 0 Operation Code 1Dh 1 Logical Unit Number ISelfTest 2 3 4 5 The SEND DIAGNOSTIC command requests the MatchBox to perform diagnostic operations on itself The MatchBox responds to this with status if the SelfTest bit is set otherwise it returns CHECK CONDITION status 4 MatchBox User Manual 711 SCSI Reference WRITE BUFFER Bit 7 6 5 4 3 2 1 0 Byte 0 Operation Code 3Bh 1 Buffer Offset MSB Buffer Offset Buffer Offset LSB Transfer Length MSB Transfer Length Transfer Length LSB The WRITE BUFFER command writes data into the MatchBox target buffer and enables programming of the flash EPROM The target buffer is an array of memory on the MatchBox with the same size as the flash EPROM i e 512K Data can be written to this buffer and its contents can be written to the MatchBox flash EPROM Up to Transfer Length bytes of data are transferred to the MatchBox target buffer starting at offset Buffer Offset The valid binary values of Mode have the following effect 010b Write to target buffer 100b Write to target buffer 101b Write to target buffer and write its contents to flash EPROM The MatchBox does not set a unit attention condition if these complete successfully MBX M711 MatchBox User Manual
15. RIPTION A call to tsp_reset_config resets the configuration link as well as any devices connected to the host link connection specified by fd The configuration link is not available for use by the user on Paramid systems RETURN VALUES Returns zero on success or 1 on error 56 MatchBox User Manual 711 TSP Library tsp_write NAME tsp_write Write data to a host link SYNOPSIS include lt tsplib h gt int tsp_write int fd void data size_t length int timeout ARGUMENTS fd Descriptor returned by tsp_open data Pointer to data to write length The number of bytes to write timeout Timeout in seconds Zero for no timeout DESCRIPTION A call to tsp write sends length bytes of data to be out put on a host link If write timeout occurs it is an error to attempt further writes until the connection is reset using tsp reset tsp analyse or tsp reset config Note that as write buffers are used to increase the host link bandwidth then tsp write may return without error before the data is actually output on the host link the data cannot be output on the host link then subsequent calls to tsp write will return an error RETURN VALUES Returns the number of bytes written success or 1 on timeout or other error BUGS There is a built in maximum timeout of five seconds MBX M 711 MatchBox User Manual 57 TSP Library tsp_write_config NAME tsp_write
16. The host workstation should be switched off whenever a MatchBox is connected to the SCSI bus disconnected from the SCSI bus or its SCSI id is changed MBX M 711 MatchBox User Manual 13 Rebooting When rebooting a Sun workstation running Solaris 2 use the boot flag to tell the host that it should reconfigure itself With the Sun switched off 1 Switch on the MatchBox if connected and any other SCSI peripherals 2 Switch on the Sun 3 When the Sun logo appears hold down the 11 key and press A This stops the Sun from booting and enters monitor mode If the monitor prompt is gt then type n and press Return to get the ok prompt Check that the Sun can see the MatchBox if connected or any other SCSI peripheral ok probe scsi Boot the Sun with the r flag Exactly what command to type depends on which Sun system is being used and how the oper ating system is installed On early SPARCstations that boot from disk use something like ok boot sd 0 1 0 On later SPARCstations that boot from disk the command will be something like ok boot disk r 14 User Manual MBX 711 Host Link Names Chapter 4 Host Link Names E The MatchBox host link to be used is specified using a host link name such as c0t510 which corresponds to SCSI controller 0 SCSI target 5 the MatchBox SCSI id link 0 Thus for a MatchBox with SCSI id 5 the names of the host links 0 are c0t 510
17. _config Write data to the configuration link SYNOPSIS include lt tsplib h gt int tsp_write_config int fd void data size_t length int timeout ARGUMENTS fd Descriptor returned by tsp_open data Pointer to data to write to the configuration link length The amount of data to be written timeout Timeout in seconds Zero for no timeout DESCRIPTION A call to tsp_write_config causes the target to attempt to write length bytes of data to the configuration link If a timeout occurs it is an error to attempt further writes to the configuration link before resetting it using tsp_reset_config The configuration link is not available for use by the user on Paramid systems RETURN VALUES Returns the number of bytes written on success or 1 error or timeout BUGS There is a built in timeout of five seconds per 4096 byte block 58 MatchBox User Manual MBX M 711 SCSI Reference Appendix A SCSI Reference ET This appendix describes the SCSI commands supported by the Transtech MatchBox The MatchBox is a processor type SCSI device and has eight logical units Units 0 to 3 correspond to host output from host links 0 to 3 Units 4 to 7 correspond to host input to host links 0 to 3 A 1 Host Links Data is sent to the output host links using SEND and received on the input host links using RECEIVE Each logical unit can have one outstanding SCSI command at a time thus using disconnec
18. c0t511 c0t512 and c0t513 4 1 Connection Database The connection database lists the capabilities resources available to certain tools such as the host server utility Iserver The actual resource that the tool is to use is specified by the TRANSPUTER environment variable or command line arguments such as the Iserver 51 option The name of the connection database file to use is the value of the environment variable ICONDB The connection database file 1ib tsp db defines capabilities for MatchBoxes at any SCSI id on SCSI bus 0 The capability names are chosen to have the same name as the host link as defined above An extract from this file is SCSI id 5 c0t510 c0t511 c0t512 c0t513 localhost c0t510 tsp 1111 localhost cOt511 tsp 1111 IT localhost c0t512 tsp 1111 localhost c0t513 tsp 1111 MBX 711 MatchBox User Manual 15 Connection Database The non comment lines in this file contain the fields Capability IsWorking Machine Linkname Linkdev Mmsfile Mmslink Description The resource name passed for instance to Iserver using the s1 option or the environment variable TRANSPUTER Setto T if the resource is available Set to F if the resource is not available The name of the host on which the resource exists For a MatchBox connected to the local workstation this is set to localhost The device name See above for the device naming co
19. e following is produced Target 1 Unit 0 Disk MAXTOR LXT 231S 4 18 L oor o This shows that there is a disk with SCSI id 1 with one logical unit In fact it is a Maxtor LXT 231S disk revision 4 18 which is installed internally in the Sun The Sun workstation SCSI adapter is 7 by default thus in this case a suitable choice for the MatchBox SCSI id is 5 When a MatchBox is correctly connected to the host SCSI bus for example with SCSI id 5 the probe scsi command will additionally display messages similar to Target 5 Unit Unit Unit Unit Unit Unit ab Processor TRANST MatchBox 1 00 Processor TRANST MatchBox 1 00 Processor TRANST MatchBox 1 00 Processor TRANST MatchBox 1 00 Processor TRANST MatchBox 1 00 Processor TRANST MatchBox 1 00 6 MatchBox User Manual 711 Hardware Installation Unit 6 Processor TRANST MatchBox 1 00 Unit 7 Processor TRANST MatchBox 1 00 showing the eight MatchBox logical units At this point you can safely switch off the Sun 2 3 PARAstation Connection The Transtech MatchBox is connected to the PARAstation by a cable which connects to 37 way D connector on both systems as shown in figure 4 Main UP Connector x b 2b 4 f MatchBox PARAstation 37 Way Cable Figure 4 PARAstation Connection 2 3 1 D Connector The con
20. ech MatchBox needs to be connected to The power supply The host workstation SCSI bus The Transtech PARAstation The MatchBox connectors and switches are shown in figure 1 which is a rear view of the MatchBox Power Switch 37 Way D Connector oon Power Connector Fan SCSI Connectors SCSI Id Switch Figure 1 MatchBox Back Panel 2 1 Power Connection Mains power at the correct voltage needs to be supplied to the workstation the MatchBox and the PARAstation The MatchBox takes AC voltages in the range 90V to 260V MBX M 711 MatchBox User Manual 3 SCSI Connection For reliable operation ensure that the workstation the MatchBox the PARAstation and any other peripherals are all powered from the same mains circuit 2 2 SCSI Connection The MatchBox is connected to the computer workstation by the SCSI bus This requires you to Choose and set the MatchBox SCSI id e Connect the MatchBox to the host workstation SCSI port and other SCSI devices if any Terminate the SCSI bus Shutdown and switch off the workstation and any connected SCSI peripherals before connecting the MatchBox Most UNIX workstations have a built in SCSI port accessible from the rear A typical workstation SCSI setup is illustrated in figure 2 where the workstation has an internal disk and the MatchBox is the only external SCSI peripheral Alternatively it is possible to have more than one SCSI adapter
21. erface resource to use to access the Transputer network The utility can be used to determine the link connectivity of the network For example o 5 rspy Part rt Link0 Linkl Link2 Link3 0 T805 25 HOST MBX M711 MatchBox User Manual 41 42 User Manual 711 Configuration Chapter 8 Configuration SS The Transtech PARAstation link connection scheme can be altered by use of link switches which are set by use of the MatchBox configuration link using the t spconf command A number of pre defined configuration files are supplied in the parastn directory for use with tspconf to setup various PARAstation configurations The Inmos Module Motherboard Software MMS can be used to create custom configuration files See the PARAstation User Manual for details Note that due to the way in which the PARAstation configuration System is implemented then t spconf can only be used with host link O devices with names such as c0t 510 MBX M 711 MatchBox User Manual 43 8 1 Manual 15 tspconf Transtech SCSI Processor configuration program SYNOPSIS tspconf h 1 v 1 l name file DESCRIPTION tspconf is a utility used to load a file down the SCSI Pro cessor configuration link Typically this is used to con figure a Transtech PARAstation connected to the host works tation using a T
22. erver packets MBXM 711 MatchBox User Manual 29 Reference Section 30 MatchBox User Manual MBX 711 Check Utilities Chapter 6 Check Utilities The check utilities are set of tools for testing networks of Transputer nodes The utilities are check Probe a Transputer network ckmon Transputer hex monitor ftest Perform Transputer functional tests load Load Transputer node in network mtest Perform Transputer memory tests Some of the utilities take the output of check as their input For instance to test the Transputer memory of a network of processors use check mtest 1 Similarly to perform functional tests of the Transputers in a network of processors use 5 check ftest These utilities are documented in the form of Unix man pages in the following section MBX M711 MatchBox User Manual 31 Reference 6 1 Reference check NAME check Test a Transputer network SYNOPSIS Unix check c4 1 cl 1 cr 1 cs cfb filename 1 h i l name 1 m filename n r v 1 x lt filename DOS check 4 1 cl cfb filename 1 h 1 i 1 name 1 m filename r 1 v 1 x lt filename DESCRIPTION check is a utility which tests a network of Transputer pro cessors It outputs a list of the processors found and the connections between them The output of check can be used as the input o
23. esses Note that iocache multiplexes the host channels of several processes in manner similar to hostmux 2 io type specifies the type of I O optimization that is performed It is an integer as defined in the above value declarations packet size is used to determine the size of iserver packets when the type is BIG IO it is ignored for all other I O types To obtain 1 0 compatible with a standard iserver both io type and packet size should be set to zero block size determines the size of buffer that is allocated for each file opened by a client A value of 16384 16K is recommended The space available for buffers is controlled by the heapsize given to the process In general as much heap as possible should be given to this process If the host is a PC running DOS then text mode files opened by Transputer processes are not cached This does not apply to files opened by i860s The standard input and output are not cached When the same file is opened more than once eg by dif ferent client processes the cached data can be shared between processes For this to happen both the file name and the open mode must match exactly FILES iocache lku SEE ALSO iserver 1 hostmux 2 26 MatchBox User Manual MBX M 711 Iserver genio NAME genio genio open genio close genio read genio write genio lseek genio control optimized file I O library SYNOPSIS include lt genio h gt int genio_open
24. evices of the host link connection specified by fd MBX M711 MatchBox User Manual 45 TSP Library RETURN VALUES Returns zero on success or 1 on error 46 MatchBox User Manual MBX M 711 TSP Library tsp_close NAME tsp_close Close a host link connection SYNOPSIS include lt tsplib h gt int tsp_close int fd ARGUMENTS fd Descriptor returned by tsp_open DESCRIPTION A call to tsp close closes a connection to a host link that was created by a call to tsp open RETURN VALUES Returns zero on success or 1 on error 711 MatchBox User Manual 47 TSP Library tsp error NAME tsp error Return host link connection error status SYNOPSIS include lt tsplib h gt int tsp error int fd ARGUMENTS fd Descriptor returned by tsp open DESCRIPTION A call to tsp error returns the state of the error line of the host link connection specified by fd RETURN VALUES Returns zero or one indicating the state of the error line on success 1 on error 48 MatchBox User Manual MBX M 711 TSP Library tsp_mknod NAME tsp_mknod Create TSP device character special files SYNOPSIS include lt tsplib h gt int tsp_mknod char device ARGUMENTS device Name of host link for which character special files are to be created DESCRIPTION Creates the character special files which are required on some systems to access a Transtech SCSI Processor
25. eyboard screen file system and other services The list of available systems resources which iserver can use is kept in a file called the connection database The environment variable ICONDB should be set to the pathname of this file The resource that iserver should attempt to use is specified by the sl option or the environment variable TRANSPUTER The session manager provides a mechanism to allow users tinuous access to a resource It has a simple command line interface allowing users to specify and use the required resource This interface can be customised by a configura tion file specified by the environment variable ISESSION OPTIONS On Unix systems iserver options are preceded by On DOS Systems iserver options are preceded by sb filename Boot the named file same as sr ss si sc filename si Verbose mode 711 MatchBox User Manual 19 Reference Section se Test the error flag sl linkname Use the named resource sr Reset the root transputer sa Analyse and peek the root transputer sc filename Copy the named file to the link sp n Set peek size to n Kchars ss Serve the link sm Enter the session shell sk interval Retry connects every interval seconds 521112 Very verbose debug mode logs all transactions St Pass all of the following arguments to the booted pro gram Options and or arguments not recognised by iserver are passed to the boo
26. f mtest ftest or load Alternatively the output from a previous run of check can be piped into subsequent runs The host link connection to use is specified by the 1 option or the TRANSPUTER environment variable using the syntax cmtnlo where m is the SCSI controller number or SCSI bus number n is the SCSI target Id and is the host link number OPTIONS In Unix options are preceded by In DOS options are preceded by c4 Read the state of all 0045 found cl Read the state of C004s long form Reset all 0045 found cs Set all 0045 in file piped into check 32 User Manual 711 Check Utilities cfb filename Use filename as a configuration binary file h Print help page i Information tells you whats happening 1 name Use this link else use TRANSPUTER environment variable m filename Use filename as a toolset map file n Do not reset the root transputer Reset the root transputer subsystem Leave network in virgin reset state x Ignores any file piped in to check MBX M711 MatchBox User Manual 33 Reference ckmon NAME ckmon Transputer hex monitor SYNOPSIS Unix check ckmon 0 h 1 name ckmon f filename h 1 name 1 DOS check ckmon 0 h 1 name ckmon f filename h 1 name 1 1 DESCRIPTION ckmon is a Transputer monitor program The first Transputer in the
27. installed in the workstation and have the MatchBox on a different SCSI bus from other SCSI peripherals Workstation MatchBox SCSI Terminator SCSI Adapter Internal Disk SCSI Cable Figure 2 SCSI Connections 4 MatchBox User Manual MBX 711 Hardware Installation 2 2 1 SCSI Cabling and Termination Most SCSI peripherals including the MatchBox have two SCSI connectors This allows multiple SCSI peripherals to be connected to one workstation It does not matter which MatchBox SCSI connector is used to connect to the workstation and which is used to connect to other SCSI peripherals Problems can occur if the SCSI cables are of poor quality or if their total length is too big The shorter the SCSI bus cables the better The SCSI 2 specification requires that the total cable length including internal cables is no greater than 6m As a rule of thumb do not allow external cabling to exceed 3m The SCSI bus must be terminated using a suitable terminator at both ends The end internal to the workstation will normally be terminated on the SCSI adapter If the MatchBox is the last external SCSI peripheral fit the supplied terminator to the unused MatchBox SCSI connector If a SCSI peripheral is used which has internal SCSI bus termination then this must be the last device on the SCSI bus 2 2 2 MatchBox SCSI Id The SCSI id of the MatchBox is set using a switch on the underside of the b
28. mizations should be used It can be called to switch between modes whenever desired I O will be performed using the mode selected when the file was opened genio control takes two arguments an I O type and a dary parameter The parameter is ignored unless otherwise Specified The following I O types can be used STD IO Standard mode default TMB16 IO Optimize I O for the TMB16 NB the calling process must have it s host I O links connected directly to the TMB16 interface NOT through any multiplex ors TB400_IO Use enlarged iserver packets optimized for the TB400 MCP_IO Use enlarged iserver packets optimized for MCP1000 and MCP500 BIG_IO Use enlarged iserver packets of the specified size The second argument specifies the size of packet that may be used in bytes FILES genio h genio lib SEE ALSO hostmux 2 RESTRICTIONS File descriptors used by routines in the genio library not be used with the standard file I O routines and vice versa The server channels from Transputer processes using the 28 MatchBox User Manual 711 Iserver genio routines cannot be multiplexed using so multiplexor or buffered using so buffer TMBl6 optimized I O is enabled the calling process must have its host channels connected DIRECTLY to the TMB16 interface link multiplexors or buffers are allowed between the library and the host link The hostmux process can handle enlarged is
29. nection between the MatchBox and the PARAstation or to other external Transputer systems is made via the MatchBox 37 way D connector The pin out for this is shown in figure 5 MBX M711 MatchBox User Manual 7 PARAstation Connection Pin 1 Ground Config Reset Pin 20 Pin 2 rov rane Pin 3 LinkO Out E Pin 4 Link Out Link1 In Pin 23 Pin 5 Ground Link2 Out Pin 24 Pin 6 Link2 In Link3 Out Pin 25 Pin 7 Link3 In Config Out Pin 26 Pin 8 Config In Ground Pin 27 Pin 9 N C RUE Pin 10 N C Nieves Pin 11 N C N C Pin 30 NotReset0 Pin 31 NotAnalyseO Pin 32 NotReset1 Pin 33 NotError1 Pin 34 NotError2 Pin 35 45V Pin 36 NotAnalyse3 Pin 37 Pin 12 Ground Pin 13 NotErrorO Pin 14 5V Pin 15 NotAnalyse1 Pin 16 NotReset2 Pin 17 NotAnalyse2 Pin 18 NotReset3 Pin 19 NotError3 Figure 5 37 Way D Connector A Break out board is supplied which plugs into the 37 way D connector and has a number of link headers which can be used to connect the MatchBox to Transputer networks using standard Inmos link cables The connectors available on the Break out board are shown in figure 6 8 MatchBox User Manual MBX 711 Hardware Installation Config Reset Link 0 Link 1 Link 2 Link 3 Config Link Subsystem 0 Subsystem 1 Subsystem 2 Subsystem 3 Figure 6 Break out Board Connecti
30. network can be monitored by using the 0 option Other Transputers can be monitored using the n option where n is the number of a processor as defined in the output of check in the file filename as specified using the f option The host link connection to use is specified by the 1 option or the TRANSPUTER environment variable using the syntax cmtnlo where m is the SCSI controller number or SCSI bus number n is the SCSI target Id and o is the host link number OPTIONS In Unix options are preceded by In DOS options preceded by 0 onitors root processor n onitors processor n f filename Use check output filename h Help page l name Use the named link 34 MatchBox User Manual MBX M 711 Check Utilities a Assert Subsystem Analyse MBX M711 MatchBox User Manual 35 Reference ftest NAME ftest Test processors in a Transputer network SYNOPSIS Unix check 2 64 1 t8 J 4 4 DOS check testi 62 p 7t4 1 X 71 1 DESCRIPTION ftest is a utility used in conjunction with check which tests processors in a network of Transputers The host link connection to use is specified by the SPUTER environment variable using the syntax cmtnlo where m is the SCSI controller number or SCSI bus number n is the SCSI target Id and o is the host link number OPTIONS In Unix options are preceded by In DOS options
31. nvention used The type of device Set to t sp to indicate the use of a Transtech SCSI Processor System such as the MatchBox Reserved for future use Reserved for future use Descriptive comment Thus using the above connection database to use Iserver on host link 0 to load and run the Transputer executable run bt1 use the command on UNIX systems iserver sl cOt510 sb run btl Alternatively set the environment variable TRANSPUTER to the required capability name For instance on UNIX systems oe oe setenv TRANSPUTER cOt510 iserver 5 run btl 16 MatchBox User Manual MBX M 711 Iserver Chapter 5 Iserver u Iserver is a host server program which loads and runs Transputer and PowerPC programs on Transtech systems allowing access to host services such as the keyboard screen and filesystem The resource that Iserver is to use is specified by the environment variable TRANSPUTER or the s1 option The host link name corresponding to this is found from the connection database See section 4 1 on page 15 for details of the connection database file 5 1 Source The source of Iserver is supplied in subdirectories of the source iserver directory It is based on the Inmos version 1 50v of Iserver with some changes including Support for the MatchBox is added using calls to the Transtech SCSI Processor Library in the Linkios tsplink c The variable OPScommsmode defined in linkops link
32. ocol are TSP_RAW_PROTOCOL Raw byte mode protocol TSP_ISERVER_PROTOCOL Iserver mode protocol TSP_BLOCK_PROTOCOL Fixed block size protocol The maximum value of block_size is 4096 DESCRIPTION A call to tsp protocol sets the link protocol used for host link reads using tsp read This allows the target to attempt to perform reads before they are requested using tsp read thus improving link bandwidth With raw byte mode protocol read request lengths correspond to the number of bytes of data to receive The value of block size is ignored With iserver protocol read request lengths must be set to the value of block size and correspond to the maximum number of bytes to receive in the form of an iserver packet which consists of a two byte count followed by count bytes of data MBXM 711 MatchBox User Manual 51 TSP Library In fixed block size protocol all reads must of length block_size The link protocol is set to raw byte mode when the host link is reset by a call to tsp_reset tsp_analyse or tsp_reset_config After being set by tsp_protocol this protocol persists until the link is reset RETURN VALUES Returns zero on success or 1 on error 52 MatchBox User Manual MBX M 711 TSP Library tsp_read NAME tsp_read Read data from a host link SYNOPSIS include lt tsplib h gt int tsp_read int fd void data size_t length int timeout ARGUMENTS fd Descriptor returned
33. ons MBX M711 MatchBox User Manual 9 PARAstation Connection 10 MatchBox User Manual MBX M 711 Software Installation Chapter 3 Software Installation u M EHE Instructions are given here for installing the MatchBox software on Sun SPARCstations running Solaris 2 A password is required to use the Transtech MatchBox connected to UNIX hosts See section 3 2 for details It is recommended that the MatchBox is connected to the host workstation before installing the MatchBox software 3 1 Sun SPARCstation The MatchBox software for Sun SPARCstation systems running Solaris 2 is supplied on CD ROM the contents of which are installed using the pkgadd command Packages that are installed using the pkgadd command can be removed using the pkgrm command Most of the software is installed by default in the directory opt transtech This software can in fact be installed anywhere in the file system for instance on a networked file server disk but it is recommended that a symbolic link is made to the installation directory from opt transtech if the software is not installed there To install the MatchBox software on Sun SPARCstation systems running Solaris 2 1 Log into the Sun as root 2 Putthe supplied CD ROM into the CD ROM drive 3 Use volcheck to mount the CD ROM volcheck cdrom MBX M 711 MatchBox User Manual 11 Password 4 Move to the solaris2 directory on the CD ROM
34. ops c is made global and an external reference to it is added to linkops linkops h Thisis usedin 1inkios tsplink cto optimise Iserver transactions Support for PC systems running DOS with no network connection is added 5 2 Iserver Libraries The following files are supplied in the 41155 directory to be used with the Inmos ANSI C Toolset Dx414 in conjunction with Iserver genio h Header file for genio 1ib MBX M711 MatchBox User Manual 17 Iserver Libraries genio lib Generic I O library Used to improve I O performance of Transputer and i860 programs using Iserver hostmux lku Iserver host link multiplexor process iocache lku Disk cacheing process The genio library and the hostmux and iocache processes are documented in the form of Unix man pages in the following section 18 MatchBox User Manual MBX M 711 Iserver 5 3 Reference Section Iserver NAME iserver Inmos host server program SYNOPSIS Unix iserver sb filename 1 si 1 se sl linkname 1 sr J sa filename 1 55 1 sm sk 8 112111 st arguments 205 iserver sb filename 1 81 1 se 1 sl linkname 1 sr 1 1 sc filename sp ss 1 sm sk 1 sz 112 1 st 1 arguments DESCRIPTION iserver is the Inmos host server program It is used to load programs onto Transtech systems and allow them access to the host workstation s k
35. ox as shown in figure 3 lt a Decrement Button 5 5 lt q Increment Button Figure 3 SCSI Switch A ballpoint pen or other suitable object can be used to increase or decrease the value by one until the required value is set as required You need to use an unused value between 0 and 7 A SCSI id of 5 is often suitable Each internal and external peripheral connected to the SCSI bus including the workstation SCSI adapter has a unique id between 0 and 7 The SCSI bus will fail to operate if more than one device has MBX 711 MatchBox User Manual 5 SCSI Connection the same SCSI id To choose an id for the MatchBox you need to know the SCSI ids of all of the other devices already on the SCSI bus 2 2 2 1 Sun SPARCstations On Sun SPARCstations there is a monitor command probe scsi which can be used to determine the ids of peripherals connected to the SCSI bus 1 If any external SCSI peripherals are used ensure that they are properly connected to the Sun and the SCSI bus is terminated 2 Switch on the Sun monitor and external SCSI peripherals 3 Switch on the Sun workstation 4 When the Sun logo appears and the monitor tests start hold down the 1 1 key and press the A key This stops the tests and brings up the monitor prompt 5 If the monitor prompt is gt then type n and press Return 6 Atthe ok prompt type probe scsi and press Return A list of SCSI target devices like th
36. ranstech MatchBox The syntax of the name parameter is cmtnlO0 where m is the SCSI controller number or SCSI bus number and n is the SCSI target Id The logical unit or host link number is zero If no host link name is specified the value of the environ ment variable TRANSPUTER is used to specify the host link to use OPTIONS Print help message y Verbose mode 1 name Host link name file Name of file to boot 44 MatchBox User Manual MBX M 711 TSP Library Chapter 9 TSP Library The Transtech SCSI Processor library TSPLIB is a library of C functions which can be used by workstation programmers to use MatchBox facilities without the need for detailed knowledge of the use of SCSI The function argument syntax is common to all workstations that support the MatchBox The Solaris 2 version of the TSP library used on Sun SPARCstations is 1ib libtsp a and uses the header file include tsplib h programs using TSPLIB can be compiled and linked as follows oe CC c prog o prog c IS TPS include 5 cc o prog prog o L TPS lib ltsp The TSP library functions are documented in the following section tsp analyse NAME tsp analyse Reset a host link connection with analyse SYNOPSIS include lt tsplib h gt int tsp_analyse int fd ARGUMENTS fd Descriptor returned by tsp_open DESCRIPTION A call to tsp_analyse resets the link and with analyse asserted the connected d
37. returned by tsp_open data Pointer to memory into which data is read length The maximum amount of data to be read timeout Timeout in seconds Zero for no timeout DESCRIPTION A call to tsp_read_config requests the target to read up to length bytes of data from the configuration link The configuration link is not available for use by the user on Paramid systems RETURN VALUES Returns the number of bytes read which may be less than that requested on success or 1 on error or timeout BUGS There is a built in timeout of five seconds per 4096 byte block for this command after which the number of bytes read is returned If a timeout occurs as specified by timeout then 1 is returned and the number of bytes read from the configuration link is undefined 54 MatchBox User Manual 711 TSP Library tsp_reset NAME tsp_reset Reset a host link connection SYNOPSIS include lt tsplib h gt int tsp reset int fd ARGUMENTS fd Descriptor returned by tsp open DESCRIPTION A call to tsp reset resets the link and connected of the host link connection specified by fd RETURN VALUES Returns zero on success or 1 on error devices MBX M 711 MatchBox User Manual 55 TSP Library tsp_reset_config NAME tsp_reset_config Reset the configuration link SYNOPSIS include lt tsplib h gt int tsp_reset_config int fd ARGUMENTS fd Descriptor returned by tsp_open DESC
38. rotocol Five bytes are transferred from the Initiator Bit Byte 2 esu ls 0 Protocol Block Size MSB Block Size 2 3 4 Block Size LSB The data contains the following fields SR SA LR CLR Protocol Block Size The subsystem reset line is set to the value of SR The subsystem analyse line is set to the value of SA If set the input or output link corresponding to the logical unit is reset If set the configuration link is reset Sets the current link protocol Sets the current value of the link block size 66 MatchBox User Manual MBX M 711 SCSI Reference The valid values of the Protocol Field are 0 Raw mode This is the default mode 1 Iserver mode 2 Block mode The SR SA Protocol and Block Size fields retain their values until they are either explicitly changed by a subsequent WRITE FLAGS command or until a SCSI bus or bus device reset occurs The LR and CLR bits are self clearing 711 MatchBox User Manual 67 SCSI Commands RECEIVE 0 Operation Code 08h 1 Logical Unit Number Allocation Length MSB Allocation Length LSB 2 3 Allocation Length 4 5 A RECEIVE command is used to request up to Allocation Length bytes of data from the input Transputer link This command is valid only on logical units 4 to 7
39. s REQUEST SENSE Bit 0 21235528 0 Operation Code 03h 1 Logical Unit Number 2 3 4 Allocation Length 5 A REQUEST SENSE command is used to return sense error information to the Initiator When an error status of CHEC occurs during the execution of a SCSI command a K CONDITION is returned Further information about the error can be determined from the data returned by performing the SE REQUEST SE command command immediately following the errant Sense data is also set when a unit attention condition occurs e g after power on or a SCSI bus or bus device reset 64 User Manual MBX M 711 SCSI Reference The MatchBox returns up to eighteen or Allocation Length bytes of sense data Bit 7 6 5 4 3 2 1 0 0 Error Code 70h 1 7 Additional Sense Length OAh 8 11 12 Additional Sense Code 13 Additional Sense Qualifier 14 17 See the SCSI 2 specification for details of the possible values of Sense Key Additional Sense Code and Additional Sense Qualifier MBX M711 MatchBox User Manual 65 SCSI Commands WRITE FLAGS Bit 7 6 5 4 3 2 1 0 Byte 0 Operation Code 06h 1 2 3 4 Parameter Length 5 AWRITE FLAGS command is used to set subsystem lines reset the configuration link and set the link p
40. s Note that the Logical Unit Number field of the command descriptor block is only used if no IDENTIFY message is sent by the initiator on selection MBX 711 MatchBox User Manual 61 SCSI Commands TEST UNIT READY Byte Operation Code 00h Logical Unit Number A TEST UNIT READY command is used to test the readiness of a logical unit on a MatchBox to receive a command A GOOD status is returned if the logical unit is ready BUSY is returned if another command is in progress and CHECK CONDITION is returned if it is in a unit attention condition e g after power on or reset Further information is available by using the REQUEST SENSE command 62 MatchBox User Manual MBX M 711 SCSI Reference READ FLAGS 4 Allocation Length 5 A READ FLAGS command is used to find the current state of the subsystem error and the link protocol flag On success up to five or Allocation Length bytes of data is returned to the Initiator Protocol Block Size MSB Block Size Block Size LSB The data returned contains the following fields SE Set to 1 if any nodes in the subsystem error line is set Protocol The Protocol byte is set to the current link protocol as set by WRITE FLAGS Block Size The Block Size is set to the current protocol block size as set by WRITE FLAGS MBX M711 MatchBox User Manual 63 SCSI Command
41. s are disabled and the request cannot be satisfied immediately then the command terminates as in the above timeout condition MBX M711 MatchBox User Manual 69 SCSI Commands READ CONFIG Bit 0 Operation Code 09h 1 Logical Unit Number Allocation Length MSB Allocation Length Allocation Length LSB A READ CONFIG command is used to request to Allocation Length bytes of data from the configuration link If not all of the requested data has been received within approximately five seconds only the data received if any is transferred to the initiator This is not an error Do not use this command unless disconnects are enabled 70 MatchBox User Manual MBX 711 SCSI Reference SEND Byte 7 6 5 4 3 2 1 0 Operation Code 0Ah 1 Logical Unit Number Transfer Length MSB Transfer Length 2 3 4 Transfer Length LSB 5 A SEND command is used to send up to Transfer Length bytes of data to the output host link This command is valid only on logical units 0 to 3 Write buffering is used so that this command may terminate with GOOD status before the data is actually output on the link If the data cannot be output on the host link then subsequent SEND commands will terminate with CHECK CONDITION status after approximately five seconds It is then an error for subsequent SEND commands to be attempted until the link is re
42. set using WRITE FLAGS Do not use this command unless disconnects are enabled MBX 711 MatchBox User Manual 71 SCSI Commands WRITE CONFIG Bit 0 Operation Code 0Ch 1 Logical Unit Number Allocation Length MSB Allocation Length Allocation Length LSB A WRITE CONFIG command is used to send up to Transfer Length bytes of data to the configuration link If the data is not output on the configuration link within approximately five seconds then the command terminates with CHECK CONDITION status It is an error for subsequent WRITE CONFIG commands to be attempted until the configuration link is reset using WRITE FLAGS Do not use this command unless disconnects are enabled 72 MatchBox User Manual MBX 711 SCSI Reference INQUIRY 7 6 5 4 3 2 1 0 Byte 0 Operation Code 12h 2 3 4 Allocation Length 5 An INQUIRY command is used to return information about the MatchBox logical unit to the initiator The MatchBox returns up to 36 or Allocation Length bytes of INQUIRY data ipheral Device Type 03h Response Data Format 02h 8 15 Vendor Identification TRANST 16 31 Product Identification Mat chBox 2 35 Product Revision Level See the SCSI 2 specification for details of the format of the data returned MBX M711 MatchBox User Manual 73 SCSI Commands SE
43. t links and thus are common to logical units 0 and 4 1 and 5 2 and 6 and 3 and 7 These are manipulated by using the vendor specific commands WRITE FLAGS and READ FLAGS A 4 Miscellaneous The MatchBox handles data in blocks of up to 4096 bytes Commands that have timeouts associated with them are timed with respect to each block If a unit attention condition is current for example after power on or reset all commands except INQUIRY and REQUEST SENSE terminate immediately with CHECK CONDITION status after which the unit attention condition is cleared An INQUIRY command can be performed returning GOOD status without clearing the unit attention condition AREQUEST SENSE command can be performed returning GOOD status if no error occurs clearing the unit attention condition If an attempt is made to use a logical unit whilst it is processing another command then BUSY status is returned This can happen if two initiators attempt to use a logical unit at the same time or if a previous command has been aborted and the MatchBox has not terminated processing it For the correct operation of the MatchBox disconnects should always be enabled on commands which may not complete immediately 60 MatchBox User Manual MBXM 711 SCSI Reference A 5 SCSI Commands The command descriptor blocks CDBs and data formats of SCSI commands supported by the MatchBox are listed in the following page
44. ted program ENVIRONMENT The following environment variables are used by iserver TRANSPUTER Specifies the resource to used May be overridden by the sl option ICONDB Pathname of the connection database file ISESSION Pathname of the session manager configuration file Default is session cfg 20 MatchBox User Manual MBX 711 Iserver hostmux NAME hostmux host server channel multiplexor SYNOPSIS process stacksize 16K heapsize 64K interface input from_host output to_host input in size output out size int n size mux use hostmux lku for mux DESCRIPTION The host server channel multiplexor is used where more than one process needs access to host I O facilities The multi plexor takes any number of pairs of server channels and combines them into a single pair that is connected to the host The host connections can be connected another multiplexor giving rise to tree shaped structures which may be built up to any level of complexity A process accessing the host is referred to as a client of the multiplexor Each client is connected to one in chan nel and to the out channel with the same array index The multiplexor receives requests on any in channel passes the request to the host waits for the reply and passes the reply to the corresponding out channel Termina tion messages which cause the iserver to terminate receive Special trea
45. tment a termination message is not passed to the host until a total of n termination messages are received from clients Hence the iserver will not terminate until all clients have terminated Client channels should not be left unconnected if they are MBXM 711 MatchBox User Manual 21 Reference Section the iserver will never terminate because the multiplexor will expect a termination message from the unconnected chan nel The multiplexor is not limited to a fixed size of iserver packet If a packet is encountered that exceeds the current buffer size it attempts to allocate a new buffer from the heap The multiplexor inputs requests from the clients using a fair ALT This means that even if there is a continuous stream of requests from one client requests from any other client are guaranteed to be serviced within a finite time EXAMPLE loader cfs This example shows the use of hostmux to provide host services to run860 processes on three processors 27 include i860tset cfh include hardware cfs process stacksize 64K heapsize 64K process declarations val boot 0 860 val len 1 size boot_1 val boot 2 1 860 7 val len 2 size boot_2 val boot 3 2 860 val len 3 _ 3 process interface input HostInput output HostOutput int flags NORUN char boot file len 1 boot 1 driver 1 process interface input HostInput o
46. tmux lku SEE ALSO iserver 1 24 MatchBox User Manual 711 Iserver iocache NAME iocache host file I O accelerator SYNOPSIS io type val val val val val val TMB16 16384 TB400 65536 PARAMID 65536 MCP 131072 0 STD_IO 0 packet size val DEFAULT_SIZE 0 cache block size val DEFAULT_BLOCK 16384 process stacksize 10K heapsize 1M interface input from_host Gutput to host input from client n output to client n vut num chans n int io type type int packet size size int block size b size cache use iocache lku for cache DESCRIPTION The file cache process improves I O performance by The size of I O blocks is converted depending on the host server recently accessed data up or down to the optimum cacheing and MBX M 711 MatchBox User Manual 25 Reference Section interface hardware being used Where many processes are reading the same file concurrently such as when a group of 18605 are booting the same pro gram I O speed can be dramatically increased The problem of the iserver running out of file descriptors is also avoided as the cache only opens each file only once The configuration parameters are as follows from host and to host are the normal iserver channels to the host from client and to client are arrays of iserver channels to the clients or application proc
47. ts the MatchBox can be inputting and outputting on all four links concurrently Double buffering is used to maximise the link bandwidth this means that SCSI SEND command may complete before the data is actually sent down the output host link Various protocols and the block size can be set on input host links so that double buffering can be performed on link input data may be inputted on a host link before a SCSI RECEIVE command has been received Input protocol and block size are set and read using the vendor specific commands WRITE FLAGS and READ FLAGS and apply only to host input links Host output links use Raw mode The input protocols currently supported are Raw Input the requested amount of bytes The block size parameter is ignored Iserver Input a two byte count and count bytes of data The maximum packet size count plus data is set by the block size MBX 711 MatchBox User Manual 59 Configuration Link Block Fixed length blocks The maximum value of the block size parameter is 4096 bytes A 2 Configuration Link In addition to the host links the MatchBox has a configuration link on which data can be read or written by performing the vendor specific commands READ CONFIG and WRITE CONFIG The configuration link can be reset using the vendor specific command WRITE FLAGS A 3 Subsystems The four MatchBox subsystems correspond to the host input and outpu
48. utput HostOutput int flags NORUN 22 MatchBox User Manual MBX M 711 Iserver proces proces proces char boot file len 2 boot 2 driver 2 amp interface input HostInput output HostOutput int flags NORUN char boot file len 3 boot 3 driver 3 S interface input HostInput output HostOutput input Input 2 output Output 2 int Size 2 mult 1 S interface input HostInput output HostOutput input Input 2 output Output 2 input HostInput output HostOutput connect mult 1l HostInput to HostInput connect mult l HostOutput to HostOutput connect mult_1 Input 0 to mult_2 HostOutput connect mult_1 Output 0 to mult 2 HostInput connect mult 1l Input l to driver 1l HostOutput connect mult 1l Output 1 to driver 1l HostInput connect mult 2 Input 0 to driver 3 HostOutput connect mult 2 O0utput 0 to driver 3 HostInput connect mult 2 Input l to driver 2 HostOutput connect mult 2 O0utput 1 to driver 2 HostInput placement use hostmux lku for mult 1 use hostmux lku for mult 2 use run860 1ku for driver 1 use run860 1lku for driver 2 use run860 1ku for driver 3 place driver 1 on TTM100 1 place driver 2 on TTM100 2 place driver 3 on 100 3 place mult 1 on TTM100 1 place mult 2 on TTM100 2 place HostInput on host MBX M 711 MatchBox User Manual 23 Reference Section place HostOutput on host FILES hos
49. ware Installation TRANSPUTER The host link to use See Chapter 4 for details MANPATH Search path for the Unix man command Include the full pathname of the man installation directory to access the on line manual pages The command search path should include the bin directory If Inmos Toolsets are being used then this should occur before any Inmos Toolset directory is quoted The following lines are an example extract of the file login which can be used to set these environment variables for users of the C shell under Solaris 2 setenv TPS opt transtech setenv IBOARDSIZE 400000 BUGSIZE 400000 RM usr inmos d4414 iterms sun itm ARCH usr inmos d4414 libs STPS tp 4libs setenv ISERVER STPS bin iserver setenv ICONDB TPS lib tsp db setenv ASERVDB STPS tp 4libs aservdb setenv TRANSPUTER c0t510 setenv MANPATH usr man usr openwin man S TPS man set path path STPS bin usr inmos d4414 tools usr inmos d4405 tools setenv ID setenv IT setenv IS E 029 3 4 Connection Database Certain utilities such as the host server program iserver usea connection database file to determine what resources are available to it See section 4 1 for details A connection database file 1i1b tsp db is supplied which can be used with a MatchBox at any SCSI id on SCSI bus 0 This file will need to be altered if a MatchBox is connected to a SCSI bus other than O 3 5 Rebooting

Download Pdf Manuals

Related Search

Related Contents

ONELOCK CLASSIC  Add-On Computer Peripherals (ACP) BN-CKM-SP-SR-AO network transceiver module  positivID Standard - positivID Identity Systems Ltd  PDF - CKD  

Copyright © All rights reserved. Failed to retrieve file