home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD2.img / d4xx / d411 / pcstatus / pcstatus.doc < prev    next >
Text File  |  1990-12-15  |  15KB  |  356 lines
  1.                                  PCSTATUS
  2.                                  ========
  3.  
  4.                                »Version 2.0«
  5.  
  6.                    Copyright (c) 1990 by drs. A.D. Hagen
  7.  
  8.  
  9.     COPYRIGHT, DISTRIBUTION AND LICENSE
  10.     -----------------------------------
  11.  
  12.     All rights about this program and it's documentation remain
  13.     with the author. However, you are granted a limited license.
  14.     Here are the terms:
  15.  
  16.       1) This software may be copied freely.
  17.  
  18.       2) Distribution in whatever form must include at least the
  19.          files listed below.
  20.  
  21.          /-------------------------------------------------------\
  22.          | File              | Description                       |
  23.          |-------------------------------------------------------|
  24.          | PCStatus          | PCStatus program for the Amiga    |
  25.          | PCStatus.info     | PCStatus workbench info file      |
  26.          | PCStatus.Exe      | PCStatus program for the PC       |
  27.          | PCStatus.Doc      | Documentation for PCStatus        |
  28.          | PCStatus.Doc.info | Documentation workbench info file |
  29.          \-------------------------------------------------------/
  30.  
  31.          With the word "programs" in the next statements, all these
  32.          files are ment.
  33.  
  34.       3) All programs must keep their original names, as listed in
  35.          the table above.
  36.  
  37.       4) None of the programs may be altered. A translation into a
  38.          foreign language is allowed, provided:
  39.            a) The english version is included as well.
  40.            b) The name of the program, the name of the author, the
  41.               version and revision number and the copyright
  42.               message remain unchanged.
  43.            c) All rights of the translated program or
  44.               documentation will belong to the author of the
  45.               english version!
  46.            d) You've sent a copy of the translated files to the
  47.               author of the english version. No distribution may
  48.               take place until he has acknowledged the receipt of
  49.               the translated programs.
  50.  
  51.       5) If a fee is charged for a disk containing the programs,
  52.          it may not exceed the fee used by Fred Fish. Also, the
  53.          disk must be full for at least 75%.
  54.  
  55.       6) The programs may not accompany any commercial product without
  56.          obtaining a written agreement from the author of PCStatus
  57.          first. This includes all hardware, all commercial
  58.          software and all magazines.
  59.  
  60.       7) The programs are shareware. If after a certain evaluation
  61.          period you find the program useful, you are encouraged to
  62.          register. The time you'll need for evaluation is up to you.
  63.  
  64.       8) These programs have been tested extensively. However,
  65.          using it is at your own risk. Under no circumstances will
  66.          the author of the program (or anyone else) be held
  67.          responsible for any damage caused direct or indirect by
  68.          this program. If the legal situation in your country is
  69.          such that this statement does not apply to you, the use
  70.          of this program is forbidden, unless you agree to this
  71.          statement.
  72.  
  73.     SHAREWARE AND REGISTRATION
  74.     --------------------------
  75.  
  76.     PCStatus is made available to you under the concept of
  77.     shareware. The only reason for me to do so, is to find out
  78.     wether shareware works. If it does, I will release any future
  79.     janus applications as shareware as well. If it does not work,
  80.     I will either keep the programs to myself or I will distribute
  81.     them commercially. Remember, PCStatus is just a try-out. It's
  82.     up to you to decide what will happen with my next janus
  83.     program.
  84.  
  85.     Everything I know about programming the bridgeboard was
  86.     discovered with the help of some files left behind by
  87.     Commodore on the original janus disk. PCStatus gives you just
  88.     a taste of the possibilities of the janus software. As my
  89.     understanding of the bridgeboard grows, the programs will get
  90.     more complicated and even more useful. If you want to support
  91.     my efforts to control the bridgeboard, you can register this
  92.     program. The registration fee is very modest, 10 Dutch
  93.     Guilders (approx US$ 5). This is the smallest banknote over
  94.     here. There are numerous ways you can send me the money. The
  95.     table below gives you a short overview. But, NEVER SEND COINS!!!
  96.     You can obtain my address from the section, titled SUPPORT, at
  97.     the end of this manual.
  98.  
  99.      /-----------------------------------------------------------\
  100.      | Payment method                  | Value in Dutch Guilders |
  101.      |-----------------------------------------------------------|
  102.      | Cash (in Dutch Guilders)        |            10           |
  103.      | Cash (in another currency)      |            15           |
  104.      | (International) money order     |            15           |
  105.      | National bank transfer          |            10           |
  106.      | International bank transfer     |            25           |
  107.      | Check (drawn on a Dutch bank)   |            10           |
  108.      | Check (drawn on a foreign bank) |            25           |
  109.      \-----------------------------------------------------------/
  110.  
  111.     Any additional charge (above 10 Dutch Guilders) is used to
  112.     cover exchange rate fluctuations and provisions only. If you
  113.     want to transfer the amount to my bankaccount, here are the
  114.     details:
  115.  
  116.          /-------------------------------------------------\
  117.          | Account: 5.683.208 of | Bank: Postbank N.V.     |
  118.          |          A.D. Hagen   |       P.O. Box 41900    |
  119.          |                       |       1009 CD Amsterdam |
  120.          |                       |       The Netherlands   |
  121.          \-------------------------------------------------/
  122.  
  123.     Don't forget to mention which program you are registering. All
  124.     registered users will receive a registration confirmation.
  125.  
  126.     All charity organisations can apply for a free registration.
  127.     To do so, simply send a request on official organisation paper
  128.     together with the statute of your organisation. If the request
  129.     is granted, you'll receive your registration confirmation free
  130.     of charge.
  131.  
  132.     In some countries, there is no legal obligation to register
  133.     for shareware programs. If this applies to you, you should
  134.     nevertheless feel morally obliged to pay for the program. It's
  135.     more than worth the small amount!
  136.  
  137.     THE PROGRAM
  138.     -----------
  139.  
  140.     PCStatus is one of the first utility programs for the Amiga
  141.     bridgeboard; and it's the first one that is released as
  142.     shareware. At the moment it will work only with the A2088 XT
  143.     and the A2286 AT board. It does not work with any other PC
  144.     expansions and it never will, unless they use Commodore's
  145.     janus software interface.
  146.  
  147.     PCStatus and all the icons that come with it have been designed for
  148.     use with version 2.0 of the workbench. If you don't have this
  149.     version yet, don't worry. PCStatus will work with version 1.2 and
  150.     1.3 as well. However, the graphic images might look less attractive
  151.     to you. Sorry for that.
  152.  
  153.     PCStatus will open a status window on every screen that
  154.     contains a PCWindow. Once invoked, PCStatus will monitor all
  155.     OpenWindow and CloseWindow function calls and act if these
  156.     functions deal with a PC display window.
  157.  
  158.     In each status window the status of the CAPS, SCROLL, NUM and
  159.     INS key are displayed. Also, any changes in the CapsLock-key
  160.     outside a PCWindow will be transmitted to the bridgeboard. So,
  161.     both the PC and the Amiga will work with the same setting of
  162.     the CapsLock key.
  163.  
  164.     Everything about starting this program is explained in the
  165.     section titled "INSTALLATION". Removing PCStatus is even more
  166.     simple. Just click on the close-gadget in the control window.
  167.     Please note that this will remove the Amiga side of the
  168.     program immediately and will close all status windows that are
  169.     still open. It will not remove PCStatus from the PC-side. To
  170.     achieve that simply reboot the PC. However, you might as well
  171.     leave it untouched, since PCStatus does not require any
  172.     conventional memory. Yes, PCStatus doesn't need any user
  173.     memory, nor does it need any expanded or extended memory.
  174.     Instead, all routines are kept in the janus dual port memory.
  175.     The amount needed is minimal; approximately 170 bytes.
  176.  
  177.     PARAMETERS
  178.     ----------
  179.  
  180.     PCStatus is ment to be very flexible. Hence, a number of
  181.     options for the Amiga program have been included. Although
  182.     both the CLI parameters and the workbench tool types obey the
  183.     same syntax, the workbench tool types are case-sensitive,
  184.     while the CLI parameters are not.
  185.  
  186.     AUTOLOAD
  187.  
  188.     Most options can be used from both the CLI and Workbench. The
  189.     only option that is used from the Workbench only is AUTOLOAD.
  190.     The tool type "AUTOLOAD=84545.1020" should always be present,
  191.     for upwards compatibility. Please note, I picked this number
  192.     myself. As soon as I manage to get an official Application ID
  193.     from Commodore (for free of coures), I'll change it immediately.
  194.     All remaining options can be used from the CLI as well.
  195.  
  196.     STATUS and CONTROL
  197.  
  198.     Especially for NTSC-users, the location of the status window and
  199.     the control window can be modified. In order to change the position
  200.     of the status window add the tool type or parameter "STATUS=(x,y)".
  201.     X and y are measured in pixels and represent the desired position.
  202.     The location of the control window is set alike: "CONTROL=(x,y)".
  203.     If the position of the status window is outside the screen's
  204.     dimensions, no status indication will be shown. Please note that
  205.     a low resolution graphics/text screen has a width of 320. If you
  206.     want a status window on this screen, you'll have to change the
  207.     default settings.
  208.  
  209.     SHIFT
  210.  
  211.     The current janus software does not tell the PC about changes
  212.     in the CapsLock key, while we are working in a non-PC-window.
  213.     Hence, it is possible that the CapsLock key does not reflect
  214.     it's actual state, while working in a PC window. The SHIFT
  215.     option fixes this. The tool type or parameter either contains
  216.     "SHIFT=ON" or "SHIFT=OFF". As long as Commodore hasn't fixed this
  217.     problem, you should use SHIFT=ON.
  218.  
  219.     QUIET
  220.  
  221.     The last Amiga option is called QUIET. Just like SHIFT it can
  222.     list either "QUIET=ON" or "QUIET=OFF". If you have added
  223.     PCStatus to the Startup-Sequence, you might want to choose
  224.     QUIET=ON. This way the Copyright requester won't show when
  225.     PCStatus is invoked.
  226.  
  227.     Just to show you how these parameters are used for real, here
  228.     is a CLI example, using all the default settings. The order of
  229.     the parameters is not significant.
  230.  
  231.     PCStatus Shift=On Quiet=Off Status=(388,226) Control=(424,0)
  232.  
  233.     The file PCStatus.info contains all the default tool types for
  234.     use from the workbench. Use the "Info" option from the workbench
  235.     menu to list them.
  236.  
  237.     INSTALLATION
  238.     ------------
  239.  
  240.     The installation of PCStatus is quite simple. Just follow the 
  241.     instructions and it should work.
  242.  
  243.     PCStatus exchanges data between the Amiga and the PC. In order
  244.     to get things working, you'll need two programs, one for the
  245.     Amiga and one for the PC. Unless you received this program on
  246.     two disks, one for the PC and one for the Amiga, you must move
  247.     one or more files to the other system. Here is how that is done:
  248.  
  249.       1) Make sure the file Config.Sys on the PC contains the line
  250.          DEVICE=C:\SYSTEM\JDISK.SYS. If you don't have a PC
  251.          (pseudo) harddisk or if JDISK.SYS isn't located in the
  252.          SYSTEM directory, you have to customize this line for
  253.          your system. In order for these changes to take effect,
  254.          you have to reboot the PC.
  255.  
  256.       2) The startup-sequence on the Amiga should contain the line
  257.          "Run PC/PCDisk". If your startup-sequence didn't contain
  258.          this line already, you should reboot the Amiga now!
  259.  
  260.       3) Now we can transfer the file between the systems. There
  261.          are two alternatives:
  262.            a) The files are on the Amiga. Type this command on the
  263.               PC: "ARead PCStatus.Exe C:\SYSTEM\PCStatus.Exe /b".
  264.               Again, you might have to change some drives or path
  265.               names.
  266.            b) The files are on the PC. Type these commands on the
  267.               PC: "AWrite PCStatus Df0:PC/Services/PCStatus /b" and
  268.               "AWrite PCStatus.info Df0:PC/Services/PCStatus.info /b".
  269.               You might have to change the drives and path names here
  270.               as well.
  271.  
  272.     The one thing remaining is installing PCStatus itself. I've
  273.     chosen for the solution where PCStatus is loaded automatically
  274.     when the system is booted. This installation is a two-step
  275.     procedure.
  276.  
  277.       1) The Amiga program, PCStatus, should be located in the
  278.          PC/Services directory. Once this is done, you should add
  279.          this line to the Startup-Sequence: "PC/Services/PCStatus".
  280.  
  281.       2) The PC program, PCStatus.Exe, should be located in the
  282.          SYSTEM directory (or whatever directory the ATIME and
  283.          JLINK command are in). Also, the line "SYSTEM\PCSTATUS"
  284.          must be added to the Autoexec.Bat file.
  285.  
  286.     If you have a PAL Amiga you can stop here with the
  287.     installation. After rebooting, a PCStatus window will pop-up
  288.     on every screen that contains a PCWindow. If you own a NTSC
  289.     Amiga, you must change some startup parameters first. Read the
  290.     section titled PARAMETERS how this is done.
  291.  
  292.     To operate properly, PCStatus needs some libraries and fonts.
  293.     Here is a complete lists:
  294.  
  295.               /-------------------------------------\
  296.               | Required libraries | Required fonts |
  297.               |-------------------------------------|
  298.               | Diskfont.library   | Topaz.font/8   |
  299.               | Dos.library        | Ruby.font/15   |
  300.               | Graphics.library   |                |
  301.               | Icon.library       |                |
  302.               | Intuition.Library  |                |
  303.               | Janus.library      |                |
  304.               \-------------------------------------/
  305.  
  306.     If any of these items isn't available, PCStatus will show an
  307.     error requester, telling you what went wrong. Correct the
  308.     problem and try again.
  309.  
  310.     BUGS
  311.     ----
  312.  
  313.     PCStatus has been tested very carefully. The testing on the XT
  314.     was done by myself. All testing on the AT was done by Arno
  315.     Griffioen.
  316.  
  317.     There is one known bug in PCStatus. If the PCStatus control
  318.     window is closed and the program is started again, the Amiga
  319.     will create a new service. Also, PCStatus.Exe on the PC has to
  320.     be started again. The previous service will sit and wait until
  321.     you reboot the Amiga. Having two services in memory will
  322.     slightly affect your PC's performance, although it will not
  323.     affect the performance of your Amiga.
  324.  
  325.     The PC/Amiga interface is a complex piece of software and
  326.     hardware. The file PC.Boot contains the interface software for
  327.     the PC. Unfortunately, old versions of this file contain several
  328.     serious bugs and some miner bugs. If PCStatus does not work
  329.     properly with your bridgeboard, contact Commodore in your
  330.     country or contact CATS for a Janus Software Update.
  331.  
  332.     SUPPORT
  333.     -------
  334.  
  335.     All questions and remarks can be send to:
  336.  
  337.         Drs. A.D. Hagen
  338.         Newtonstraat 20
  339.         4532 KH Terneuzen
  340.         The Netherlands
  341.  
  342.     If you prefer electronic mail, you can address your messages to:
  343.  
  344.         FIDO: 2:285/403.2 to Alexander Hagen
  345.         UUCP: ...!hp4nl!afa!eddysf!nucleus!alexhagn or
  346.               alexhagn@neabbs
  347.  
  348.     At the moment the first UUCP address does not seem to work very
  349.     reliable. If your message bounces or if you don't get an answer,
  350.     please resend the message to the second address. Reading your
  351.     messages costs me money, so keep them short and to-the-point.
  352.  
  353.     The Unregistered Amiga Bridgeboard Developer,
  354.  
  355.     Alexander Hagen
  356.