home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / misc / amigalib.lha / edplayer.lha / edplayer / EdPlayer.DOCs / EdP2.0.ErrorCodes.DOC < prev    next >
Text File  |  1992-07-11  |  6KB  |  113 lines
  1. ============================================================================
  2.  
  3.                             E R R O R   C O D E S
  4.  
  5. ============================================================================
  6.  
  7. When EdPlayer gets an error, usually from an ARexx or telled command, it
  8. reports that error to the calling program.  If you use "telled", you will
  9. not see an error message in your CLI window, although errors with numbers
  10. 10 or higher may cause your script to abort.  If you use "cteled", a
  11. full error description should appear in your CLI window.  And finally, if
  12. you use an ARexx script, the error number will appear in the script's
  13. window (the script may halt for errors >= 10), but no discription will
  14. appear.  In ALL these cases, however, if the CD panel is open when the
  15. error occurs, an error number and description will appear in it.  This is
  16. useful for debugging things like DVideoIII presentations which do not even
  17. return the error number from a failed ARexx message.
  18.  
  19. If for some reason you can get an error number, but you would like a much
  20. fuller description, here are the codes:
  21.  
  22. 0  = No error.
  23.  
  24. 4  = Can't give response.  You sent an ARexx query through telled or
  25.      cteled, but EdPlayer can't answer your questions through those
  26.      programs.  You must use the AskEd.rexx script for queries.
  27.  
  28. 5  = Incorrect PowerPacker Password.  If you have a module that is
  29.      encrypted, and you give a wrong password, you get this!
  30.  
  31. 6  = No program!  PREV or NEXT was called, but there is no program there
  32.      to get the next songname from.
  33.  
  34. 7  = Illegal JUMP.  Someone tried to use the JUMP command to jump to a
  35.      pattern that wasn't in the song, and the command had to be ignored.
  36.  
  37. 8  = Can't continue.  CONT was called, but the song was STOPped, and could
  38.      not continue.
  39.  
  40. 9  = Nothing to PLAY!  Someone issued a PLAY with no filename and no song
  41.      or program currently loaded.
  42.  
  43. 10 = Syntax error.  The first four letters of the message did not make a
  44.      valid command.  Perhaps there were quotes in "telled" parameters,
  45.      or maybe you added extra letters to a command that didn't allow it.
  46.      Or maybe it was just garbage...
  47.      Note: This error also seems to be serving as my "illegal value"
  48.      error for several commands.
  49.  
  50. 11 = MIDI not available.  If the MIDI command returns this, then your
  51.      serial port is probably not free.  If the MIDL command returns this,
  52.      then maybe you don't have midi.library in your LIBS: directory or
  53.      something.
  54.  
  55. 12 = File not found.  A very common error.  Check spelling & path!
  56.      You must use a FULL PATH with EdPlayer, because EdPlayer's current
  57.      directory may not match the controlling program's current dir!
  58.      ALSO:  If you have two disks, both named "Empty" or both named
  59.      "ST-00" or something, EdPlayer can't tell them apart!  You will
  60.      end up seeing this error a lot.  RENAME your disks.  Make them UNIQUE!
  61.      Also, don't let req.library use "DF0:" instead of a volume name!
  62.      If you do, EdPlayer will think all your disks can be found in
  63.      drive DF0: all the time, and will report this error a lot.
  64.  
  65. 13 = Need PowerPacker.library.  EdPlayer came across a packed module,
  66.      and you need to install powerpacker.library in your LIBS: dir.
  67.  
  68. 14 = Disk error.  Maybe the file is corrupt, or there was a read/write
  69.      error or something.
  70.  
  71. 15 = Out of memory.  There is not enough CHIP RAM to load the module.
  72.      I know I got MegaBall 2.0 to load songs into FAST ram, but that is
  73.      ONLY because there are five songs, and the group of them go into
  74.      FAST together and get buffered into CHIP one song at a time.  This
  75.      method will obviously not work with EdPlayer which only loads one
  76.      song at a time anyway.  So we're stuck with CHIP RAM again.  :-(
  77.  
  78. 16 = Unknown module type, or corrupt module.  Perhaps you are trying to
  79.      play a MED 3.00 module with the MED 3.0 bug in it, or perhaps you
  80.      are trying to play an earlier format of MED modules, or even a song or
  81.      something instead of a module.  If the error happened because of a MED
  82.      mutant, just load it into MED *3.21!* and save as a MODULE.  This
  83.      should fix it.  If the tempo goes nuts, know that the MED author
  84.      changed the tempo commands and it's not my fault.  ;-)
  85. ***  Please stop sending me email that EdPlayer won't load MED sng+samples
  86.      format.  I know this!  It is VERY hard to load this format, and
  87.      EdPlayer currently won't do it.  SO, save your work as __MODULES__,
  88.      not as __SONGS__!
  89. ***  New for EdP 2.0:  EdPlayer now range-checks mem writes during
  90.      initialization of NT/PT mods.  This should trap some semi-corrupt mods
  91.      from destroying your mem list, but it will also make EdPlayer
  92.      unable to play these mods.  You can fix most such mods by loading
  93.      them into ProTracker and saving them back out.
  94.  
  95. 17 = Can't find LIBS:rexxsyslib.library.  To use the ARexx queries, you
  96.      _MUST_ have ARexx.  You can't use queries without ARexx, because
  97.      there is no other way for EdPlayer to answer you.  Well??  What
  98.      are you doing, just sitting there??  Go buy some ARexx!  Go on!!
  99.      Move it!  Right now!!  Whew.
  100.  
  101. 21 = If EdPlayer returns this, then it is exiting (shutting down). 
  102.      However, this error is much more often generated by telled itself when
  103.      it cannot find EdPlayer in the system.  For instance, if you have a
  104.      script file that starts EdPlayer, and immediately tries to send
  105.      commands to it, without waiting for it to load and get ready (open
  106.      it's port, etc.), then your script will probably die with this error
  107.      code.  You should wait for EdPlayer to start, and the best way to do
  108.      this is with the "wport" CLI command that I distribute in this
  109.      archive.  Example:  After starting EdPlayer, and before sending
  110.      commands, have the CLI execute "wport EDPLAYER".
  111.  
  112. * End of errors.
  113.