home *** CD-ROM | disk | FTP | other *** search
/ Rat's Nest 3 / ratsnest3.iso / stuff / pcf.lzh / FLEXNET.DOC < prev    next >
Text File  |  1996-01-22  |  21KB  |  430 lines
  1. PC/FlexNet Dokumentation       FLEXNET.EXE       (C)1995 Gunter Jost, DK7WJ
  2.  
  3. Stand: 18.01.96
  4.  
  5. FlexNet-Kernel
  6.  
  7. Dies ist das zentrale FlexNet-Modul, das immer als erstes geladen werden muss.
  8.  
  9. Es sind alle FlexNet-Kanaltreiber einsetzbar. Es können maximal 15 Kanäle ange-
  10. steuert werden, das reicht sicherlich für alle Einsatzmöglichkeiten aus.
  11.  
  12. -   Hard/Softwarevoraussetzungen:
  13.         PC/XT, besser AT mit mindestens 256 kB RAM
  14.         PC/Flexnet benötigt ca. 60 kB RAM, zuzüglich dem Platzbedarf für
  15.         Kanaltreiber und Utilities.
  16.     Betriebssystem:
  17.         Ab MS-DOS 3.1, besser 5.0 oder 6.2, hier können Teile des Paketes
  18.         in die UMBs hochgeladen werden
  19.     Schnittstellen:
  20.         Nach Bedarf, je nach verfügbaren Kanaltreibern
  21.  
  22. -   Als Hardware genügt prinzipiell bereits ein PC/XT. Die erzielbare
  23.     Leistung hängt im wesentlichen von Geschwindigkeit und Datenrate
  24.     der Hardwaretreiber ab.
  25.  
  26. -   Bei Tests mit MS-DOS 6.0 gab es Probleme, Erfahrungen mit DR-DOS liegen
  27.     nicht vor. Empfohlen wird die Verwendung von MS-DOS 5.0 oder 6.2. Hier
  28.     können die Module, genügend Speicher vorausgesetzt, in die UMBs geladen
  29.     werden.
  30.     EMM386 oder Vordergrundprogramme mit virtuellem Speicherhandling führen
  31.     u.U. zu Datenverlusten auf den Kanälen, dies hängt aber stark vom ver-
  32.     wendeten Rechner und von den eingesetzten Kanaltreibern ab.
  33.  
  34. -   Zum Laden der Module (ab MS-DOS 5.0) generell "LOADHIGH" oder "LH" ver-
  35.     wenden, es schadet nicht; falls oben nicht genug Platz ist, landen die
  36.     Module trotzdem im konventionellen Speicher. Einen Platzgewinn erzielt
  37.     man auch dann, da der Environmentblock keine Lücke im Speicher hinter-
  38.     läßt.
  39.     Mit "MEM /D" kann man die Speicherbelegung kontrollieren.
  40.  
  41. -   PC/FlexNet unterstützt ladbare L1-Treiber. Sie werden durch einfachen
  42.     Aufruf im Speicher installiert. Dadurch ist es sehr einfach, beliebige
  43.     Schnittstellen zu unterstützen. Ein "Treiber-Kit" steht für interessierte
  44.     Entwickler zur Verfügung.
  45.  
  46. -   Die Kanalnummern ergeben sich in aufsteigender Folge durch die Reihen-
  47.     folge der Treiberinstallation. Ein Treiber kann beliebig viele Kanäle
  48.     unterstützen. FlexNet kann jedoch nur maximal 15 Kanäle verwalten.
  49.  
  50. -   Die gesamte Installation wird üblicherweise in einem Batchfile vor-
  51.     genommen, da die meisten Kanaltreiber noch Kommandozeilen-Parameter
  52.     brauchen. Auftretende Fehler werden beim Abbruch an COMMAND.COM
  53.     gemeldet, das Batchfile sollte dann die Installation abbrechen.
  54.  
  55. -   FLEXNET.EXE muß stets zuerst geladen werden. Danach folgen die Treiber
  56.     in der gewünschten Reihenfolge. Als letztes erfolgt die Aktivierung der
  57.     Module mit dem Utility "FLEX". Nach dieser Aktivierung werden keine
  58.     Treiberinstallationen mehr zugelassen. Nun muß noch die Parametrierung
  59.     der Kanäle mit FSET erfolgen. Die Mode-Einstellungen durch FSET sind
  60.     treiberspezifisch, siehe dazu die Treiberdokumentation und Online-Hilfen,
  61.     die mit "<treibername> /?" abrufbar sind.
  62.     Erst jetzt können die Applikationen (Terminalprogramm usw.) bzw. der
  63.     Hostmode-Emulator TFEMU gestartet werden.
  64.  
  65. -   FLEXNET.EXE hat als optionalen Parameter die Größe des benutzten Arbeits-
  66.     speichers in Kilobytes. Hier kann man etwas experimentieren. 15 kB pro
  67.     aktivem Kanal sind das sinnvolle Minimum, bei vielen QSOs (z.B. BBS)
  68.     sollte man 30-40kB vorsehen, mehr kann nie schaden.
  69.  
  70. -   Die Kanaltreiber sind, je nach Verfügbarkeit, dem Paket beigelegt. Zu
  71.     jedem Treiber gibt es ein gleichnamiges .DOC-File, das seine Installation
  72.     erklärt. Außerdem gibt jeder Treiber beim Aufruf mit /? eine kurze Hilfe-
  73.     stellung über seine Parametrierung.
  74.  
  75. -   Durch Aufruf von FLEX.EXE mit dem Argument "/U" werden alle Treiber
  76.     und andere Erweiterungen sowie FLEXNET.EXE deinstalliert.
  77.     Wie bei DOS üblich dürfen dazu keine weiteren TSRs geladen worden
  78.     sein, sonst kann es zu Abstürzen kommen.
  79.  
  80. -   Neu in der Version 3.3e ist ein eingebauter Multikanal-Digipeater.
  81.     Das Rufzeichen wird mit "FSET" eingegeben. Der Ausgabekanal entspricht
  82.     der SSID des Digi-Rufzeichens + Kanalnummer. Somit kann beliebig
  83.     Crosskanalbetrieb gefahren werden. Man braucht also nicht mehr den
  84.     kompletten FLEXDIGI, der wesentlich mehr Speicher benötigt und
  85.     auch schwieriger zu parametrieren ist.
  86.  
  87. Ein Batchfile zum starten des Pakets kann wie folgt aussehen (Kommentare
  88. am Ende der Zeile hinter dem * weglassen!):
  89.  
  90. >>>>>>>>>>>>>>>>>>>>>>>>>>> Hier ausschneiden <<<<<<<<<<<<<<<<<<<<<<<<<<
  91.  
  92. LH FLEXNET 20               * Kernel mit 20kB Arbeitsspeicher
  93. if errorlevel 1 goto end    * Optional: Wenn schon installiert, abbrechen!
  94. LH SER12 2                  * Kanal 0: BayCom-Serialmodem auf COM2
  95. if errorlevel 1 goto error  * Optional: Bei Fehler abbrechen!
  96. LH KISS 1                   * Kanal 1: KISS-Mode f. Rechnerkopplung auf COM1
  97. if errorlevel 1 goto error  * Optional: Bei Fehler abbrechen!
  98. FLEX                        * Aktivierung von Kernel und Treibern
  99. FSET mode 0 1200c           * Mode Kanal 0: 1200 Baud halbduplex, Soft-DCD
  100. FSET txd  0 15              * TxDelay Kanal 0 150ms
  101. FSET mode 1 38400cd         * Mode Kanal 1: 38400 Baud vollduplex, CRC-Modus
  102. FSET digi DK7WJ-3           * Optional: Rufzeichen des Digipeaters setzen
  103. LH TFEMU                    * Optional: Hostmode-Emulation starten
  104. goto end
  105. :error
  106. FLEX /u                     * Bei Fehlern wieder entladen!
  107. :end
  108. >>>>>>>>>>>>>>>>>>>>>>>>>>> Hier ausschneiden <<<<<<<<<<<<<<<<<<<<<<<<<<
  109.  
  110. Optional können jetzt noch weitere residente Applikationen gestartet werden,
  111. siehe dazu die jeweilige Dokumentation.
  112.  
  113. Zuletzt wird, falls gebraucht, das Vordergrund-Programm gestartet. Der Kernel
  114. bleibt auch beim Beenden der Applikation aktiv.
  115.  
  116. Entladen wird das gesamte residente Paket mit dem Kommando "FLEX /U".
  117.  
  118. -   In der Regel wird man FLEXNET mit nur einem Kanal betreiben, dann gibts
  119.     keine Probleme mit der Anwahl von verschiedenen Ports. Bei Mehrkanal-
  120.     betrieb ist folgendes zu beachten:
  121.  
  122.         Abgehende Verbindungen werden immer auf Kanal 0 geleitet. Wenn ein
  123.         anderer Kanal gewählt werden soll, muß er als erster Digipeater im
  124.         Pfad als Nummer angegeben werden, also z.B.
  125.             "CONNECT DB0ODW 1"
  126.         oder
  127.             "CONNECT DK7WJ via 1 DB0ODW".
  128.         Das "via" ist wie immer optional.
  129.  
  130.         Bei ankommenden Verbindungen hängt es von der Applikation ab, wie die
  131.         Kanalnummer ausgewertet und ggf. angezeigt wird.
  132.  
  133. - Digipeating: Wenn das Digirufzeichen z.B. DK7WJ-3 ist, so wird ein
  134.   Frame "via DK7WJ-3" auf Kanal 0 ausgegeben, "via DK7WJ-4" kommt man
  135.   auf Kanal 1 usw.
  136.  
  137. Nützliche Hilfsprogramme:
  138.  
  139.     FSET     Parametrieren von Kanälen (Tx-Delay, Baudrate, Digirufzeichen)
  140.     SHOW     Tracen von Kanälen mit Kanalstatus-Display (PTT/DCD)
  141.     STAT     Anzeige der Kanalstatistik
  142.     CALIB    Calibrate-Mode ein/ausschalten
  143.  
  144. Alle Programme bringen beim Aufruf mit "/?" eine Hilfe zum richtigen Aufruf.
  145.  
  146. -------------------------------------------------------------------------------
  147. Bei Fragen und Problemen bitte zuerst denjenigen konsultieren, von dem man
  148. das Paket erhalten hat.
  149. Oft kann auch der lokale Netzknoten-Sysop helfen, vor allem wenn es ein
  150. FlexNet-Knoten ist.
  151. Bitte erst, wenn es dann immer noch klemmt, eine Mail an DK7WJ @DB0ZDF
  152. schicken.
  153. Eine Antwort kann schonmal ein paar Tage dauern. Wenn Sachen gefragt werden,
  154. die in der Dokumentation hinreichend beschrieben sind oder die durch probieren
  155. gelöst werden können, fallen Fragen aber schonmal in den Biteimer.
  156.  
  157. Dieses Softwarepaket wird kostenlos verteilt. Wenn ihnen das Paket gefällt
  158. und Sie die Arbeit der FlexNet-Gruppe unterstützen wollen, wird eine Spende
  159. gerne angenommen. Das Geld kommt Hard- und Software-Entwicklungen für RMNC
  160. und FlexNet zugute.
  161.  
  162.                   ╔════════════════════════════╗
  163.                   ║ Sonderkonto FlexNet-Gruppe ║
  164.                   ║    Sparkasse Darmstadt     ║
  165.                   ║    Kto.Nr. 111 050 090     ║
  166.                   ║    BLZ      508 501 50     ║
  167.                   ╚════════════════════════════╝
  168.  
  169.  
  170. Zum Schluß noch die Nutzungsbedingungen für PC/FlexNet und seine Module.
  171. Weitergehende und eventuell abweichende Regelungen können für einzelne
  172. Module von anderen Autoren gelten, gegebenenfalls dort nachlesen!
  173.  
  174. RMNC/FlexNet, PC/FlexNet sowie die dazugehörigen Hilfsprogramme und
  175. Dokumentationen sind ein Produkt von Gunter Jost, DK7WJ. Ausnahmen
  176. hiervon sind als solche gekennzeichnet. Alle Rechte verbleiben beim
  177. Autor. Der Benutzer erhält das einfache Nutzungsrecht an der Software
  178. unter folgenden Bedingungen:
  179.  
  180.     -   Die Software wird ausschließlich zur nichtkommerziellen Nutzung im
  181.         Amateurfunk eingesetzt. Alle anderen Verwendungen, insbesondere in
  182.         anderen Funkdiensten, bedürfen in jedem Einzelfall der schriftlichen
  183.         Zustimmung des Autors.
  184.  
  185.     -   Die gesetzlichen Bestimmungen des Amateurfunks werden eingehalten.
  186.  
  187.     -   Gewerbliche Vervielfältigung und Verkauf der Software ist nur mit
  188.         schriftlicher Genehmigung des Autors gestattet. Eine, auch kostenlose
  189.         Beigabe zu gewerblich vertriebenen Komponenten (z.B. Modems) bedarf
  190.         ebenfalls einer schriftlichen Zustimmung. In jedem Fall muß der Kunde
  191.         schriftlich darüber informiert werden, daß er durch die Beigabe keine
  192.         über diese Bedingungen hinausgehenden Rechte an der Software erwirbt.
  193.  
  194.     -   An der Software dürfen keine Änderungen vorgenommen werden, die nicht
  195.         mit dem Autor abgesprochen sind. Individuelle Parametrierungen sind
  196.         hiervon ausgenommen.
  197.  
  198.     -   Urhebervermerke, Copyright-Meldungen von Softwaremodulen dürfen nicht
  199.         entfernt oder geändert werden.
  200.  
  201.     -   Die Software darf weder in Teilen noch insgesamt über PBBS-Systeme
  202.         oder öffentlich zugängliche Mailboxen publiziert werden, soweit dies
  203.         nicht schriftlich mit den Autoren abgestimmt ist.
  204.  
  205.     -   Die Software darf beliebig weitergegeben werden. Dabei ist stets der
  206.         komplette Umfang, wie selbst erhalten, unverändert mitzugeben.
  207.         Dabei ist insbesondere darauf zu achten, daß Datum und Uhrzeit der
  208.         einzelnen Files unverändert bleiben, um verschiedene Versionen leicht
  209.         auseinanderhalten zu können.
  210.         Eigene Erweiterungen sind ausdrücklich als solche zu kennzeichnen,
  211.         und zwar mindestens mit Angabe des Rufzeichens.
  212.         (Anmerkung: Dieser Absatz gilt nicht für die Netzknotenversion!)
  213.  
  214.     -   Die Autoren und Verteiler der Software können nicht für eventuelle
  215.         Schäden, gleich welcher Art, die durch den Einsatz und die Verwendung
  216.         der Software entstehen, haftbar gemacht werden.
  217.  
  218. Durch den Einsatz der Software werden vorstehende Nutzungsbedingungen und der
  219. Haftungsausschluß anerkannt.
  220. ------------------------------------------------------------------------------
  221. PC/FlexNet Documentation       FLEXNET.EXE       (C)1995 Gunter Jost, DK7WJ
  222.                                             Translation: Tom Sailer, HB9JNX
  223.  
  224. Date: 16.06.95
  225.  
  226. FlexNet-Kernel
  227.  
  228. This is the central FlexNet module. It must always be loaded first. It may be
  229. used in conjunction with FLEXDIGI, if digipeater services are required.
  230. All FlexNet channel drivers are supported. There may be up to 15 channels,
  231. which should suffice for all purposes.
  232.  
  233. -   Hardware and software requirements
  234.         PC/XT or preferably AT with at least 256 kB RAM
  235.         PC/FlexNet needs about 60 kB RAM plus the RAM needed for channel
  236.         drivers and utilities.
  237. -   Operating system
  238.         MS-DOS version 3.1 or later, preferably 5.0 or 6.2, where parts of
  239.         the package may be loaded into the UMBs
  240. -   Interfaces
  241.         as required (see available channel drivers)
  242.  
  243. -   A PC/XT should basically suffice. The achievable data rate depends largely
  244.     on the speed and throughput of the channel drivers.
  245.  
  246. -   Tests with MS-DOS 6.0 showed problems, and there is no experience with
  247.     DR-DOS. The author suggests the use of MS-DOS 5.0 or 6.2. This allows
  248.     the modules to be loaded into UMBs if there is sufficent memory.
  249.     EMM386 or foreground programs with virtual memory management may in some
  250.     cases lead to loss of data on the channels, but this depends largely on
  251.     the computer and the channel drivers that are used.
  252.  
  253. -   To load the modules (with MS-DOS 5.0 or later), use "LOADHIGH" or "LH",
  254.     it doesn't hurt; if there is not enough memory in the UMBs, the modules
  255.     are loaded into the conventional memory. Even in this case memory can be
  256.     saved, since the environment block does not leave a gap in the memory.
  257.     "MEM /D" shows the memory usage.
  258.  
  259. -   PC/FlexNet supports loadable L1 drivers (or channel drivers). They are
  260.     installed in memory simply by calling them. Therefore it is very easy to
  261.     support any interface. A "driver kit" is available for interested
  262.     developers.
  263.  
  264. -   Channel numbers are allocated in ascending order of the driver
  265.     installation. A driver may support any number of channels. FlexNet however
  266.     supports at most 15 channels.
  267.  
  268. -   The whole installation is usually done with a batch file, because most
  269.     channel drivers need command line parameters. Error conditions are
  270.     reported back to COMMAND.COM, and the batch file should terminate the
  271.     installation.
  272.  
  273. -   FLEXNET.EXE must always be loaded first. Then the channel drivers
  274.     should be called in the desired order. Then the modules must be activated
  275.     by calling the utility "FLEX". After activation, channel driver
  276.     installation is refused. Now, channel parameters must be set up using
  277.     the "FSET" utility. The mode parameter is driver dependent and may be
  278.     found in the driver documentation or the online help, which is displayed
  279.     with "<driver name> /?".
  280.     Applications (terminal programs and so on) or the hostmode emulator TFEMU
  281.     may now be loaded.
  282.  
  283. -   The size of the used data memory may be specified as an optional command
  284.     line parameter to FLEXNET.EXE. A reasonable minimum is 15 kB per active
  285.     channel. If there are many QSOs (for example BBS), there should be at least
  286.     30-40 kB, more does not hurt.
  287.  
  288. -   Channel drivers are included in the package if available. Every channel
  289.     driver comes with a .DOC file with the same name that explains its
  290.     installation. Every driver also displays a short help text if called with
  291.     /? that explains its parameters.
  292.  
  293. -   FLEXNET.EXE, the channel drivers and other extensions may be deinstalled
  294.     by calling "FLEX.EXE /U". DOS however requires that there were no other
  295.     TSRs loaded after FLEXNET, otherwise the machine may crash.
  296.  
  297. -   New in version 3.3e: An integrated multi channel digipeater. The call
  298.     sign is entered with "FSET" (see below). The output channel is built
  299.     from the digi SSID by adding the desired channel number. Now it is
  300.     possible to build cross channel gateways without the need for the full
  301.     featured FLEXDIGI node.
  302.  
  303. An example batch file to start the PC/FlexNet package follows (comments at the
  304. end of the lines after the * must be omitted!)
  305.  
  306. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>> cut here <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
  307.  
  308. LH FLEXNET 20               * Kernel with 20kB data memory
  309. if errorlevel 1 goto end    * optional: if already installed, give up!
  310. LH SER12 2                  * channel 0: BayCom serial modem at COM2
  311. if errorlevel 1 goto error  * optional: if an error occured, give up!
  312. LH KISS 1                   * channel 1: KISS mode to connect a computer at COM1
  313. if errorlevel 1 goto error  * optional: if an error occured, give up!
  314. FLEX                        * activate the kernel and the channel drivers
  315. FSET mode 0 1200c           * mode channel 0: 1200 baud half duplex, soft DCD
  316. FSET txd  0 15              * txdelay channel 0 150ms
  317. FSET mode 1 38400cd         * mode channel 1: 38400 baud full duplex, CRC mode
  318. FSET digi AC5FC             * optional: set digipeater callsign
  319. LH TFEMU                    * optional: start hostmode emulator
  320. goto end
  321. :error
  322. FLEX /u                     * if an error occured, unload the rest
  323. :end
  324. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>> cut here <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
  325.  
  326. Optionally, futher resident applications may be started, see the accompanying
  327. documentation.
  328.  
  329. At last the forground application may be started if needed. The kernel
  330. stays active even if the application is terminated.
  331.  
  332. The whole package may be unloaded with "FLEX /U".
  333.  
  334. -   If FLEXNET is used as a non-digipeater (i.e. without loading FLEXDIGI),
  335.     only one channel is used normally, so the port needs not be specified.
  336.     If there are multiple channels, the following should be noticed:
  337.  
  338.         The default channel for outgoing connects is channel 0. If another
  339.         channel should be used, the channel number must be specified as first
  340.         digipeater, for example:
  341.             "CONNECT DB0ODW 1"
  342.         or
  343.             "CONNECT DK7WJ via 1 DB0ODW"
  344.         The "via" is optinal, as usual.
  345.  
  346.         The applications determines if the port number of incoming connects
  347.         is used or displayed.
  348.  
  349. - Digipeating: If the given digi callsign is AC5FC-3, a frame "via AC5FC-3"
  350.   will be output on channel 0, "via AC5FC-4" will come out on channel
  351.   1 and so on.
  352.  
  353. Useful utilities:
  354.  
  355.     FSET     Sets channel parameters (TX Delays and baud rates etc)
  356.     SHOW     Traces channels and displays the channel states (PTT/DCD)
  357.     STAT     Displays channel statistics
  358.     CALIB    Switches the calibration mode on and off
  359.  
  360. Every utility displays a command line parameter help if called with "/?".
  361.  
  362. -------------------------------------------------------------------------------
  363. If you have questions or problems, please contact first the one from whom
  364. you got the package. Often, the local packet node sysop may help, especially
  365. if it is a FlexNet node.
  366. Please contact the author only if the above failed, by sending a mail to
  367. DK7WJ @DB0ZDF. The answer may take a few days. If questions are asked that are
  368. answered sufficiently in the documentation or that can be found by
  369. experimenting, the mail may fall into the bit bucket.
  370.  
  371. This software package is distributed freely. If you like the package and you
  372. want to support the work of the FlexNet group, a donation is welcome.
  373. The money will be used for further hardware and software development for
  374. RMNC and FlexNet.
  375.  
  376.                   ╔════════════════════════════╗
  377.                   ║ Sonderkonto FlexNet-Gruppe ║
  378.                   ║    Sparkasse Darmstadt     ║
  379.                   ║    Kto.Nr. 111 050 090     ║
  380.                   ║    BLZ      508 501 50     ║
  381.                   ╚════════════════════════════╝
  382.  
  383. Note: This is a translation of the german legal terms. It is for informational
  384. purposes only, they have, however, no legal significance. The german terms
  385. are the only applicable terms.
  386.  
  387. The following legal terms govern the use of PC/FlexNet and its modules.
  388. Different modules from other authors may use different terms, which should
  389. be read in the documentation of the modules!
  390.  
  391. -   RMNC/FlexNet, PC/FlexNet and the accompanying utilities and documentations
  392.     are a product of Gunter Jost, DK7WJ. Exceptions are marked. All rights
  393.     remain at the author. The user has the right to use the software under
  394.     the following conditions:
  395.  
  396.     -   The software may only be used noncommercially for amateur radio. Every
  397.         other use, especially in other radio services, needs in every case the
  398.         written consent of the author.
  399.  
  400.     -   The legal regulations concerning amateur radio are met.
  401.  
  402.     -   Commercial copying and selling without the written consent of the
  403.         author is prohibited. Also, the software must not be bundled with
  404.         commercially sold components (for example modems) without the
  405.         written consent of the author. In every case the customer must be
  406.         informed in writing that he does not acquire further rights concerning
  407.         the software.
  408.  
  409.     -   The software must not be patched or changed. Changing parameters
  410.         however is allowed.
  411.  
  412.     -   Copyright notices must not be removed or changed from the software
  413.         modules and documentation.
  414.  
  415.     -   The software must not, neither in part nor wholly, published over
  416.         PBBS systems or publicly accessible mailboxes.
  417.  
  418.     -   The software may be distributed freely. One must, however, always
  419.         distribute the complete package, without any change.
  420.         File dates and times must not be changed, so that different versions
  421.         can easily be distinguished.
  422.         Own extensions have to be clearly marked, at least with the callsign.
  423.         (Note: This paragraph does not apply to the network node version!)
  424.  
  425.     -   The authors or distributors of this software assume no responsibility
  426.         or liability for any harm that results from using this software.
  427.  
  428. The use of this software implies accepting the above legal terms.
  429. ------------------------------------------------------------------------------
  430.