LookOut - Music-X Librarian Protocol Monitor.
    Music-X is a trademark of MicroIllusions.

    Written June 1988 by David Joiner a.k.a. Talin.
    Another ElfTech product!

    Warning - the following material is for advanced users only!

    LookOut is a program which allows to to monitor the commincations
    between the Music-X Librarian and the MIDI synthesizer. It is used
    primarily for debugging new protocols. A window is displayed which
    shows the various bytes transferred between Music-X and the
    synthesizer.

    To Run LookOut, double-click on it's icon, or from the CLI type
    'Run Lookout'. The LookOut window will open. Lookout may be quit
    at any time by clicking on the close box in it's window.

    Using LookOut:

    During Library transfers, Music-X will print out various status
    messages on the lookout window. An expanation of the various messages
    is given below. 

    "Library Task Ready."
        - this is printed at the start of Music-X.

    "** Send Patch **"
        - this is printed at the start of a patch send.

    "** Receive Patch **"
        - this is printed at the start of a patch receive.

    "Retrying..."
        - an error was encountered during the transfer. The librarian will
        attempt the transfer again. After 6 failed attempts, it gives up.

    "Data Remaining: XX"
        - this is printed after a patch send. It indicates if there was
        any data in that patch that didn't get sent. This usually indicates
        a bug in the sending protocol.

    "Can't read zero bytes!"
        - if a data field in the protocol specifies a length of zero
        bytes, this message will be printed.

    "No Data Transmitted."
        - similar to previous error, only occurs on a write rather
        than a read.

    "Read Errors!"
        - serial overrun errors on the MIDI port. Usually this means that
        there are so many tasks in the Amiga that Music-X didn't have time
        to capture a serial byte before the succeeding one came in, so a
        byte was lost. Note that each disk drive has it's own task, as
        well as each hard disk partition. (This is something that will be
        addressed in future revisions of the Amiga operating system).

    "Device Error XX"
        - indicates there was some kind of error with the MIDI.device.
        Error    Meaning:
        -2        data transfer was aborted.
        -3        device received an unrecognized command.
        -10       Device was not allocated

    "MIDI Unit Not Available."
        - inidicates that some other task is using the MIDI.device.

    "ABORTED: Command Aborted..."
        - indicates that the user canceled the library transfer.

    "ABORTED: Timeout..."
        - occurs if the librarian is expecting data from the synth
    and waits for more than 5 seconds without getting any.

    "Matching: [xx xx xx xx xx]"
        - indicates that the bytes inside the brackets were received
    from the synthesizer, and that they agree with the bytes that are
    supposed to be received as specified by the protocol.
        In addition, instead of hex bytes, there can be several other
    things printed inside the brackets:
        "(xx Normal Bytes)"
            - indicates a number of normal data bytes were tranferred.
        "(xx Nibbleized Bytes)"
            - indicates a number of 'nibbleized' (i.e., each bytes
            sent as two 4-bit packets) were transferred.
        "(xx Packed Bytes)"
            - indicates a number of 'packed' (i.e. bytes broken
            up into 7-bit chunks) were tranferred.
        "<Capture>"
            - indicates that this protocol requires user intervention.
            Timeout is disabled.
        "(**xx)"
            - indicates that a 'sentinel' code has been recognized.
        "(Back xx)"
            - only printed if a sentinel is used, indicates the number
            of bytes between the sentinel and the previous data block.

    "Sending:  [xx xx xx xx xx]"
        - indicates that the bytes inside the brackets were sent to the
        synthesizer. - see previous item for special entries.

    "FAILURE - Expected [xx] Received [yy]"
        - inidicates that the byte received from the synthesizer
        did not match the value specified in the protocol.