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