/[svn]/jlscp/trunk/src/org/linuxsampler/lscp/Client.java

Diff of /jlscp/trunk/src/org/linuxsampler/lscp/Client.java

Parent Directory | Revision Log | View Patch Patch

-revision 1139 by iliev,
Mon Apr  2 20:43:58 2007 UTC
+revision 2190 by iliev,
Fri Jun 24 20:18:03 2011 UTC
 Line 1
  /*
   *   jlscp - a java LinuxSampler control protocol API
   *
-  *   Copyright (C) 2005-2007 Grigor Iliev <grigor@grigoriliev.com>
+  *   Copyright (C) 2005-2011 Grigor Iliev <grigor@grigoriliev.com>
   *
   *   This file is part of jlscp.
   *
 Line 28 
 import java.io.OutputStream;
  import java.net.InetSocketAddress;
  import java.net.Socket;
  import java.net.SocketTimeoutException;
- import java.net.UnknownHostException;
+ import java.util.ArrayList;
  import java.util.Vector;
  import java.util.logging.Level;
  import java.util.logging.Logger;
- import static org.linuxsampler.lscp.Parser.*;
  import org.linuxsampler.lscp.event.*;
+ import static org.linuxsampler.lscp.Parser.*;
  /**
   * This class is the abstraction representing a client endpoint for communication with LinuxSampler
-  * instance. Since it implements all commands specified in the LSCP protocol v1.1, for more
+  * instance. Since it implements all commands specified in the LSCP protocol v1.5, for more
   * information look at the
-  * <a href=http://www.linuxsampler.org/api/lscp-1.1.html>LSCP</a> specification.
+  * <a href=http://www.linuxsampler.org/api/lscp-1.5.html>LSCP</a> specification.
   *
   * <p> The following code establishes connection to LinuxSampler instance and gets the
   * LinuxSampler version:
-Line 69 
 public class Client {
+Line 70 
 public class Client {
          private String address;
          private int port;
          private Socket sock = null;
-         private int soTimeout = 10000;
+         private int soTimeout = 20000;
          private LscpInputStream in = null;
          private LscpOutputStream out = null;
-Line 77 
 public class Client {
+Line 78 
 public class Client {
          private EventThread eventThread;
          private boolean printOnlyMode = false;
+         public enum ResultSetType {
+                 EMPTY, SINGLE_LINE, MULTI_LINE
+         }
+         private static class ResultSetEntry {
+                 public ResultSetType type;
+                 public
+                 ResultSetEntry(ResultSetType type) {
+                         this.type = type;
+                 }
+         }
+         private Vector<ResultSetEntry> resultSetQueue = new Vector<ResultSetEntry>();
          class EventThread extends Thread {
+                 private Vector<String> queue = new Vector<String>();
                  private boolean terminate = false;
                  EventThread() { super("LSCP-Event-Thread"); }
+                 @Override
                  public void
                  run() {
                          while(!mustTerminate()) {
-                                 try { processNotifications(); }
+                                 try {
-                                 catch(Exception x) {
+                                         processQueue();
+                                         processNotifications();
+                                 } catch(Exception x) {
                                          getLogger().log(Level.FINE, x.getMessage(), x);
                                  }
                                  try { synchronized(this) { wait(100); } }
-Line 105 
 public class Client {
+Line 125 
 public class Client {
                          terminate = true;
                          this.notifyAll();
                  }
+                 public synchronized void
+                 scheduleNotification(String s) { queue.add(s); }
+                 private void
+                 processQueue() {
+                         String[] notifications = popAllNotifications();
+                         for(String n : notifications) fireEvent(n);
+                 }
+                 private synchronized String[]
+                 popAllNotifications() {
+                         String[] notifications = queue.toArray(new String[queue.size()]);
+                         queue.removeAllElements();
+                         return notifications;
+                 }
          }
          /**
-Line 144 
 public class Client {
+Line 180 
 public class Client {
                  if(printOnlyMode) setPrintOnlyMode(true);
          }
+         private boolean extendedCharacterEscaping = true;
+         /**
+          * Sets whether strings sent to LinuxSampler should be more aggressively escaped.
+          */
+         public synchronized void
+         setExtendedCharacterEscaping(boolean b) { extendedCharacterEscaping = b; }
+         /**
+          * Determines whether strings sent to LinuxSampler should be more aggressively escaped.
+          */
+         public synchronized boolean
+         getExtendedCharacterEscaping() { return extendedCharacterEscaping; }
+         /**
+          * @see java.net.Socket#setSoTimeout
+          */
+         public synchronized void
+         setSoTimeout(int timeout) {
+                 soTimeout = timeout;
+                 try { if(sock != null) sock.setSoTimeout(timeout); }
+                 catch(Exception x) { getLogger().log(Level.INFO, "Unable to set timeout", x); }
+         }
+         private String
+         toEscapedText(String s) {
+                 s = toEscapedString(s);
+                 return conv(s);
+         }
+         private String
+         toEscapedFsEntry(String s) {
+                 s = toEscapedFileName(s);
+                 return conv(s);
+         }
+         /**
+          * Applies an extended character escaping to the specified string if needed.
+          */
+         private String
+         conv(String s) {
+                 return getExtendedCharacterEscaping() ? toExtendedEscapeSequence(s) : s;
+         }
          /**
           * Determines whether the client is in print-only mode.
           * Print-only mode means that the client will just print all
-Line 324 
 public class Client {
+Line 405 
 public class Client {
                  if(!llFSI.isEmpty()) subscribe("FX_SEND_INFO");
                  if(!llSC.isEmpty()) subscribe("STREAM_COUNT");
                  if(!llVC.isEmpty()) subscribe("VOICE_COUNT");
+                 if(!llTSC.isEmpty()) subscribe("TOTAL_STREAM_COUNT");
                  if(!llTVC.isEmpty()) subscribe("TOTAL_VOICE_COUNT");
                  if(!llMIMC.isEmpty()) subscribe("MIDI_INSTRUMENT_MAP_COUNT");
                  if(!llMIMI.isEmpty()) subscribe("MIDI_INSTRUMENT_MAP_INFO");
                  if(!llMIC.isEmpty()) subscribe("MIDI_INSTRUMENT_COUNT");
                  if(!llMII.isEmpty()) subscribe("MIDI_INSTRUMENT_INFO");
+                 if(!llDMD.isEmpty()) subscribe("DEVICE_MIDI");
+                 if(!llCMD.isEmpty()) subscribe("CHANNEL_MIDI");
+                 if(!llID.isEmpty()) {
+                         subscribe("DB_INSTRUMENT_DIRECTORY_COUNT");
+                         subscribe("DB_INSTRUMENT_DIRECTORY_INFO");
+                         subscribe("DB_INSTRUMENT_COUNT");
+                         subscribe("DB_INSTRUMENT_INFO");
+                         subscribe("DB_INSTRUMENTS_JOB_INFO");
+                 }
                  if(!llGI.isEmpty()) subscribe("GLOBAL_INFO");
+                 if(!llEIC.isEmpty()) subscribe("EFFECT_INSTANCE_COUNT");
+                 if(!llEII.isEmpty()) subscribe("EFFECT_INSTANCE_INFO");
+                 if(!llSECC.isEmpty()) subscribe("SEND_EFFECT_CHAIN_COUNT");
+                 if(!llSECI.isEmpty()) subscribe("SEND_EFFECT_CHAIN_INFO");
          }
          /**
-Line 376 
 public class Client {
+Line 471 
 public class Client {
                  String s;
                  for(;;) {
                          s = in.readLine();
-                         if(s.startsWith("NOTIFY:")) fireEvent(s.substring("NOTIFY:".length()));
+                         if(s.startsWith("NOTIFY:")) {
+                                 eventThread.scheduleNotification(s.substring("NOTIFY:".length()));
+                         }
                          else break;
                  }
                  return s;
-Line 391 
 public class Client {
+Line 488 
 public class Client {
                          else getLogger().severe("Unknown notification format: " + s);
                  }
          }
+         private synchronized void
+         processResultSetQueue() {
+                 for(int i = 0; i < resultSetQueue.size(); i++) {
+                         try {
+                                 switch(resultSetQueue.get(i).type) {
+                                         case EMPTY:
+                                                 getEmptyResultSet();
+                                                 break;
+                                         case SINGLE_LINE:
+                                                 getSingleLineResultSet();
+                                                 break;
+                                         case MULTI_LINE:
+                                                 getMultiLineResultSet();
+                                                 break;
+                                         default:
+                                                 getLogger().severe("Unknown result set type");
+                                 }
+                         } catch(Exception x) {
+                                 getLogger().log(Level.FINE, "Error while processing result set queue", x);
+                         }
+                 }
+                 resultSetQueue.removeAllElements();
+         }
          /**
           * Gets empty result set.
           * @return <code>ResultSet</code> instance.
           */
          private ResultSet
          getEmptyResultSet() throws IOException, LscpException, LSException {
+                 processResultSetQueue();
                  return parseEmptyResultSet(getLine());
          }
          private ResultSet
          getSingleLineResultSet() throws IOException, LscpException, LSException {
+                 processResultSetQueue();
                  ResultSet rs = new ResultSet();
                  String ln = getLine();
-Line 421 
 public class Client {
+Line 545 
 public class Client {
          private ResultSet
          getMultiLineResultSet() throws IOException, LscpException, LSException {
+                 processResultSetQueue();
                  ResultSet rs = new ResultSet();
                  String ln = getLine();
-Line 457 
 public class Client {
+Line 582 
 public class Client {
          private final Vector<ItemInfoListener> llMIDI = new Vector<ItemInfoListener>();
          private final Vector<StreamCountListener> llSC = new Vector<StreamCountListener>();
          private final Vector<VoiceCountListener> llVC = new Vector<VoiceCountListener>();
+         private final Vector<TotalStreamCountListener> llTSC = new Vector<TotalStreamCountListener>();
          private final Vector<TotalVoiceCountListener> llTVC = new Vector<TotalVoiceCountListener>();
          /** MIDI instrument map count listeners */
-Line 469 
 public class Client {
+Line 595 
 public class Client {
          /** MIDI instrument info listeners */
          private final Vector<MidiInstrumentInfoListener> llMII =
                  new Vector<MidiInstrumentInfoListener>();
+         private final Vector<DeviceMidiDataListener> llDMD = new Vector<DeviceMidiDataListener>();
+         private final Vector<ChannelMidiDataListener> llCMD = new Vector<ChannelMidiDataListener>();
+         private final Vector<InstrumentsDbListener> llID = new Vector<InstrumentsDbListener>();
          private final Vector<GlobalInfoListener> llGI = new Vector<GlobalInfoListener>();
+         private final ArrayList<EffectInstanceCountListener> llEIC = new ArrayList<EffectInstanceCountListener>();
+         private final Vector<EffectInstanceInfoListener> llEII = new Vector<EffectInstanceInfoListener>();
+         private final Vector<SendEffectChainCountListener> llSECC = new Vector<SendEffectChainCountListener>();
+         private final Vector<SendEffectChainInfoListener> llSECI = new Vector<SendEffectChainInfoListener>();
          /**
-Line 493 
 public class Client {
+Line 626 
 public class Client {
                          !llMIDI.isEmpty() ||
                          !llSC.isEmpty()   ||
                          !llVC.isEmpty()   ||
+                         !llTSC.isEmpty()  ||
                          !llTVC.isEmpty()  ||
                          !llMIMC.isEmpty() ||
                          !llMIMI.isEmpty() ||
                          !llMIC.isEmpty()  ||
                          !llMII.isEmpty()  ||
-                         !llGI.isEmpty();
+                         !llDMD.isEmpty()  ||
+                         !llCMD.isEmpty()  ||
+                         !llID.isEmpty()   ||
+                         !llGI.isEmpty()   ||
+                         !llEIC.isEmpty()  ||
+                         !llEII.isEmpty()  ||
+                         !llSECC.isEmpty() ||
+                         !llSECI.isEmpty();
          }
-         private void
+         private synchronized void
+         fireDeviceMidiDataEvent(String s) {
+                 try {
+                         String[] list = parseList(s, ' ');
+                         if(list.length != 5) {
+                                 getLogger().warning("Unknown DEVICE_MIDI format");
+                                 return;
+                         }
+                         int dev = parseInt(list[0]);
+                         int port = parseInt(list[1]);
+                         MidiDataEvent.Type type = parseMidiDataType(list[2]);
+                         if(type == null) return;
+                         int note = parseInt(list[3]);
+                         int velocity = parseInt(list[4]);
+                         DeviceMidiDataEvent e = new DeviceMidiDataEvent(this, type, note, velocity);
+                         e.setDeviceId(dev);
+                         e.setPortId(port);
+                         for(DeviceMidiDataListener l : llDMD) l.midiDataArrived(e);
+                 } catch(LscpException x) {
+                         getLogger().log (
+                                 Level.WARNING, LscpI18n.getLogMsg("CommandFailed!"), x
+                         );
+                 }
+         }
+         private synchronized void
+         fireChannelMidiDataEvent(String s) {
+                 try {
+                         String[] list = parseList(s, ' ');
+                         if(list.length != 4) {
+                                 getLogger().warning("Unknown CHANNEL_MIDI format");
+                                 return;
+                         }
+                         int channel = parseInt(list[0]);
+                         MidiDataEvent.Type type = parseMidiDataType(list[1]);
+                         if(type == null) return;
+                         int note = parseInt(list[2]);
+                         int velocity = parseInt(list[3]);
+                         ChannelMidiDataEvent e = new ChannelMidiDataEvent(this, type, note, velocity);
+                         e.setChannelId(channel);
+                         for(ChannelMidiDataListener l : llCMD) l.midiDataArrived(e);
+                 } catch(LscpException x) {
+                         getLogger().log (
+                                 Level.WARNING, LscpI18n.getLogMsg("CommandFailed!"), x
+                         );
+                 }
+         }
+         private MidiDataEvent.Type
+         parseMidiDataType(String s) {
+                 if("NOTE_ON".equals(s)) return MidiDataEvent.Type.NOTE_ON;
+                 if("NOTE_OFF".equals(s)) return MidiDataEvent.Type.NOTE_OFF;
+                 if("CC".equals(s)) return MidiDataEvent.Type.CC;
+                 getLogger().warning("Unknown MIDI data type: " + s);
+                 return null;
+         }
+         private synchronized void
          fireEvent(String s) {
-                 if(s.startsWith("CHANNEL_COUNT:")) {
+                 // Sort by priority
+                  if(s.startsWith("CHANNEL_MIDI:")) {
+                         s = s.substring("CHANNEL_MIDI:".length());
+                         fireChannelMidiDataEvent(s);
+                 } else if(s.startsWith("DEVICE_MIDI:")) {
+                         s = s.substring("DEVICE_MIDI:".length());
+                         fireDeviceMidiDataEvent(s);
+                 } else if(s.startsWith("DB_INSTRUMENT_DIRECTORY_COUNT:")) {
+                         s = s.substring("DB_INSTRUMENT_DIRECTORY_COUNT:".length());
+                         InstrumentsDbEvent e = new InstrumentsDbEvent(this, s);
+                         for(InstrumentsDbListener l : llID) l.directoryCountChanged(e);
+                 } else if(s.startsWith("DB_INSTRUMENT_DIRECTORY_INFO:")) {
+                         InstrumentsDbEvent e;
+                         s = s.substring("DB_INSTRUMENT_DIRECTORY_INFO:".length());
+                         if(s.startsWith("NAME ")) {
+                                 String[] list;
+                                 try {
+                                         s = s.substring("NAME ".length());
+                                         list = parseEscapedStringList(s, ' ');
+                                         if(list.length != 2) throw new LscpException();
+                                         list[1] = toNonEscapedString(list[1]);
+                                         e = new InstrumentsDbEvent(this, list[0], list[1]);
+                                         for(InstrumentsDbListener l : llID) {
+                                                 l.directoryNameChanged(e);
+                                         }
+                                 } catch(LscpException x) {
+                                         getLogger().log (
+                                                 Level.WARNING,
+                                                 LscpI18n.getLogMsg("CommandFailed!"),
+                                                 x
+                                         );
+                                 }
+                         } else {
+                                 e = new InstrumentsDbEvent(this, s);
+                                 for(InstrumentsDbListener l : llID) l.directoryInfoChanged(e);
+                         }
+                 } else if(s.startsWith("DB_INSTRUMENT_COUNT:")) {
+                         s = s.substring("DB_INSTRUMENT_COUNT:".length());
+                         InstrumentsDbEvent e = new InstrumentsDbEvent(this, s);
+                         for(InstrumentsDbListener l : llID) l.instrumentCountChanged(e);
+                 } else if(s.startsWith("DB_INSTRUMENT_INFO:")) {
+                         InstrumentsDbEvent e;
+                         s = s.substring("DB_INSTRUMENT_INFO:".length());
+                         if(s.startsWith("NAME ")) {
+                                 String[] list;
+                                 try {
+                                         s = s.substring("NAME ".length());
+                                         list = parseEscapedStringList(s, ' ');
+                                         if(list.length != 2) throw new LscpException();
+                                         list[1] = toNonEscapedString(list[1]);
+                                         e = new InstrumentsDbEvent(this, list[0], list[1]);
+                                         for(InstrumentsDbListener l : llID) {
+                                                 l.instrumentNameChanged(e);
+                                         }
+                                 } catch(LscpException x) {
+                                         getLogger().log (
+                                                 Level.WARNING,
+                                                 LscpI18n.getLogMsg("CommandFailed!"),
+                                                 x
+                                         );
+                                 }
+                         } else {
+                                 e = new InstrumentsDbEvent(this, s);
+                                 for(InstrumentsDbListener l : llID) l.instrumentInfoChanged(e);
+                         }
+                 } else if(s.startsWith("DB_INSTRUMENTS_JOB_INFO:")) {
+                         s = s.substring("DB_INSTRUMENTS_JOB_INFO:".length());
+                         try {
+                                 int i = Integer.parseInt(s);
+                                 InstrumentsDbEvent e = new InstrumentsDbEvent(this, i);
+                                 for(InstrumentsDbListener l : llID) l.jobStatusChanged(e);
+                         } catch(NumberFormatException x) {
+                                 s = "Unknown DB_INSTRUMENTS_JOB_INFO format";
+                                 getLogger().log(Level.WARNING, s, x);
+                         }
+                 } else if(s.startsWith("CHANNEL_COUNT:")) {
                          try {
                                  int i = Integer.parseInt(s.substring("CHANNEL_COUNT:".length()));
                                  ChannelCountEvent e = new ChannelCountEvent(this, i);
-Line 563 
 public class Client {
+Line 847 
 public class Client {
                          } catch(NumberFormatException x) {
                                  getLogger().log(Level.WARNING, "Unknown CHANNEL_INFO format", x);
                          }
+                 } else if(s.startsWith("TOTAL_STREAM_COUNT:")) {
+                         try {
+                                 s = s.substring("TOTAL_STREAM_COUNT:".length());
+                                 int i = Integer.parseInt(s);
+                                 TotalStreamCountEvent e = new TotalStreamCountEvent(this, i);
+                                 for(TotalStreamCountListener l : llTSC) l.totalStreamCountChanged(e);
+                         } catch(NumberFormatException x) {
+                                 getLogger().log (
+                                         Level.WARNING, "Unknown TOTAL_STREAM_COUNT format", x
+                                 );
+                         }
                  } else if(s.startsWith("TOTAL_VOICE_COUNT:")) {
                          try {
                                  s = s.substring("TOTAL_VOICE_COUNT:".length());
-Line 710 
 public class Client {
+Line 1005 
 public class Client {
                          } catch(Exception x) {
                                  getLogger().log(Level.WARNING, "Unknown FX_SEND_INFO format", x);
                          }
+                 } else if(s.startsWith("EFFECT_INSTANCE_COUNT:")) {
+                         try {
+                                 s = s.substring("EFFECT_INSTANCE_COUNT:".length());
+                                 int i = Integer.parseInt(s);
+                                 EffectInstanceCountEvent e = new EffectInstanceCountEvent(this, i);
+                                 for(EffectInstanceCountListener l : llEIC) {
+                                         l.effectInstanceCountChanged(e);
+                                 }
+                         } catch(Exception x) {
+                                 getLogger().log(Level.WARNING, "Unknown EFFECT_INSTANCE_COUNT format", x);
+                         }
+                 } else if(s.startsWith("EFFECT_INSTANCE_INFO:")) {
+                         try {
+                                 s = s.substring("EFFECT_INSTANCE_INFO:".length());
+                                 int i = Integer.parseInt(s);
+                                 EffectInstanceInfoEvent e = new EffectInstanceInfoEvent(this, i);
+                                 for(EffectInstanceInfoListener l : llEII) {
+                                         l.effectInstanceInfoChanged(e);
+                                 }
+                         } catch(Exception x) {
+                                 getLogger().log(Level.WARNING, "Unknown EFFECT_INSTANCE_INFO format", x);
+                         }
+                 } else if(s.startsWith("SEND_EFFECT_CHAIN_COUNT:")) {
+                         try {
+                                 s = s.substring("SEND_EFFECT_CHAIN_COUNT:".length());
+                                 Integer[] i = parseIntList(s, ' ');
+                                 if(i.length != 2) {
+                                         getLogger().warning("Unknown SEND_EFFECT_CHAIN_COUNT format");
+                                         return;
+                                 }
+                                 SendEffectChainCountEvent e =
+                                         new SendEffectChainCountEvent(this, i[0], i[1]);
+                                 for(SendEffectChainCountListener l : llSECC) {
+                                         l.sendEffectChainCountChanged(e);
+                                 }
+                         } catch(Exception x) {
+                                 getLogger().log(Level.WARNING, "Unknown SEND_EFFECT_CHAIN_COUNT format", x);
+                         }
+                 } else if(s.startsWith("SEND_EFFECT_CHAIN_INFO:")) {
+                         try {
+                                 s = s.substring("SEND_EFFECT_CHAIN_INFO:".length());
+                                 Integer[] i = parseIntList(s, ' ');
+                                 if(i.length != 3) {
+                                         getLogger().warning("Unknown SEND_EFFECT_CHAIN_INFO format");
+                                         return;
+                                 }
+                                 SendEffectChainInfoEvent e =
+                                         new SendEffectChainInfoEvent(this, i[0], i[1], i[2]);
+                                 for(SendEffectChainInfoListener l : llSECI) {
+                                         l.sendEffectChainInfoChanged(e);
+                                 }
+                         } catch(Exception x) {
+                                 getLogger().log(Level.WARNING, "Unknown SEND_EFFECT_CHAIN_INFO format", x);
+                         }
                  } else if(s.startsWith("GLOBAL_INFO:")) {
                          handleGlobalInfoEvent(s.substring("GLOBAL_INFO:".length()));
                  } else if(s.startsWith("MISCELLANEOUS:")) {
-Line 726 
 public class Client {
+Line 1081 
 public class Client {
                                  float f = Float.parseFloat(s.substring("VOLUME ".length()));
                                  GlobalInfoEvent e = new GlobalInfoEvent(this, f);
                                  for(GlobalInfoListener l : llGI) l.volumeChanged(e);
+                         } else if(s.startsWith("VOICES ")) {
+                                 int i = Integer.parseInt(s.substring("VOICES ".length()));
+                                 GlobalInfoEvent e = new GlobalInfoEvent(this, i, -1);
+                                 for(GlobalInfoListener l : llGI) l.voiceLimitChanged(e);
+                         } else if(s.startsWith("STREAMS ")) {
+                                 int i = Integer.parseInt(s.substring("STREAMS ".length()));
+                                 GlobalInfoEvent e = new GlobalInfoEvent(this, -1, i);
+                                 for(GlobalInfoListener l : llGI) l.streamLimitChanged(e);
+                         } else {
+                                 getLogger().info("Unknown GLOBAL_INFO format: " + s);
                          }
                  } catch(NumberFormatException x) {
                          getLogger().log(Level.WARNING, "Unknown GLOBAL_INFO format", x);
-Line 1035 
 public class Client {
+Line 1400 
 public class Client {
          /**
           * Registers the specified listener for receiving event messages.
           * Listeners can be registered regardless of the connection state.
+          * @param l The <code>TotalStreamCountListener</code> to register.
+          */
+         public synchronized void
+         addTotalStreamCountListener(TotalStreamCountListener l) {
+                 if(llTSC.isEmpty()) subscribe("TOTAL_STREAM_COUNT");
+                 llTSC.add(l);
+         }
+         /**
+          * Removes the specified listener.
+          * Listeners can be removed regardless of the connection state.
+          * @param l The <code>TotalStreamCountListener</code> to remove.
+          */
+         public synchronized void
+         removeTotalStreamCountListener(TotalStreamCountListener l) {
+                 boolean b = llTSC.remove(l);
+                 if(b && llTSC.isEmpty()) unsubscribe("TOTAL_STREAM_COUNT");
+         }
+         /**
+          * Registers the specified listener for receiving event messages.
+          * Listeners can be registered regardless of the connection state.
           * @param l The <code>TotalVoiceCountListener</code> to register.
           */
          public synchronized void
-Line 1145 
 public class Client {
+Line 1532 
 public class Client {
          /**
           * Registers the specified listener for receiving event messages.
           * Listeners can be registered regardless of the connection state.
+          * @param l The <code>DeviceMidiDataListener</code> to register.
+          */
+         public synchronized void
+         addDeviceMidiDataListener(DeviceMidiDataListener l) {
+                 if(llDMD.isEmpty()) subscribe("DEVICE_MIDI");
+                 llDMD.add(l);
+         }
+         /**
+          * Removes the specified listener.
+          * Listeners can be removed regardless of the connection state.
+          * @param l The <code>DeviceMidiDataListener</code> to remove.
+          */
+         public synchronized void
+         removeDeviceMidiDataListener(DeviceMidiDataListener l) {
+                 boolean b = llDMD.remove(l);
+                 if(b && llDMD.isEmpty()) unsubscribe("DEVICE_MIDI");
+         }
+         /**
+          * Registers the specified listener for receiving event messages.
+          * Listeners can be registered regardless of the connection state.
+          * @param l The <code>ChannelMidiDataListener</code> to register.
+          */
+         public synchronized void
+         addChannelMidiDataListener(ChannelMidiDataListener l) {
+                 if(llCMD.isEmpty()) subscribe("CHANNEL_MIDI");
+                 llCMD.add(l);
+         }
+         /**
+          * Removes the specified listener.
+          * Listeners can be removed regardless of the connection state.
+          * @param l The <code>ChannelMidiDataListener</code> to remove.
+          */
+         public synchronized void
+         removeChannelMidiDataListener(ChannelMidiDataListener l) {
+                 boolean b = llCMD.remove(l);
+                 if(b && llCMD.isEmpty()) unsubscribe("CHANNEL_MIDI");
+         }
+         /**
+          * Registers the specified listener for receiving event messages.
+          * Listeners can be registered regardless of the connection state.
+          * @param l The <code>InstrumentsDbListener</code> to register.
+          */
+         public synchronized void
+         addInstrumentsDbListener(InstrumentsDbListener l) {
+                 if(llID.isEmpty()) {
+                         subscribe("DB_INSTRUMENT_DIRECTORY_COUNT");
+                         subscribe("DB_INSTRUMENT_DIRECTORY_INFO");
+                         subscribe("DB_INSTRUMENT_COUNT");
+                         subscribe("DB_INSTRUMENT_INFO");
+                         subscribe("DB_INSTRUMENTS_JOB_INFO");
+                 }
+                 llID.add(l);
+         }
+         /**
+          * Removes the specified listener.
+          * Listeners can be removed regardless of the connection state.
+          * @param l The <code>InstrumentsDbListener</code> to remove.
+          */
+         public synchronized void
+         removeInstrumentsDbListener(InstrumentsDbListener l) {
+                 boolean b = llID.remove(l);
+                 if(b && llID.isEmpty()) {
+                         unsubscribe("DB_INSTRUMENT_DIRECTORY_COUNT");
+                         unsubscribe("DB_INSTRUMENT_DIRECTORY_INFO");
+                         unsubscribe("DB_INSTRUMENT_COUNT");
+                         unsubscribe("DB_INSTRUMENT_INFO");
+                         unsubscribe("DB_INSTRUMENTS_JOB_INFO");
+                 }
+         }
+         /**
+          * Registers the specified listener for receiving event messages.
+          * Listeners can be registered regardless of the connection state.
           * @param l The <code>GlobalInfoListener</code> to register.
           */
          public synchronized void
-Line 1165 
 public class Client {
+Line 1630 
 public class Client {
          }
          /**
+          * Registers the specified listener for receiving event messages.
+          * Listeners can be registered regardless of the connection state.
+          * @param l The <code>EffectInstanceCountListener</code> to register.
+          */
+         public synchronized void
+         addEffectInstanceCountListener(EffectInstanceCountListener l) {
+                 if(llEIC.isEmpty()) subscribe("EFFECT_INSTANCE_COUNT");
+                 llEIC.add(l);
+         }
+         /**
+          * Removes the specified listener.
+          * Listeners can be removed regardless of the connection state.
+          * @param l The <code>EffectInstanceCountListener</code> to remove.
+          */
+         public synchronized void
+         removeEffectInstanceCountListener(EffectInstanceCountListener l) {
+                 boolean b = llEIC.remove(l);
+                 if(b && llEIC.isEmpty()) unsubscribe("EFFECT_INSTANCE_COUNT");
+         }
+         /**
+          * Registers the specified listener for receiving event messages.
+          * Listeners can be registered regardless of the connection state.
+          * @param l The <code>EffectInstanceInfoListener</code> to register.
+          */
+         public synchronized void
+         addEffectInstanceInfoListener(EffectInstanceInfoListener l) {
+                 if(llEII.isEmpty()) subscribe("EFFECT_INSTANCE_INFO");
+                 llEII.add(l);
+         }
+         /**
+          * Removes the specified listener.
+          * Listeners can be removed regardless of the connection state.
+          * @param l The <code>EffectInstanceInfoListener</code> to remove.
+          */
+         public synchronized void
+         removeEffectInstanceInfoListener(EffectInstanceInfoListener l) {
+                 boolean b = llEII.remove(l);
+                 if(b && llEII.isEmpty()) unsubscribe("EFFECT_INSTANCE_INFO");
+         }
+         /**
+          * Registers the specified listener for receiving event messages.
+          * Listeners can be registered regardless of the connection state.
+          * @param l The <code>SendEffectChainCountListener</code> to register.
+          */
+         public synchronized void
+         addSendEffectChainCountListener(SendEffectChainCountListener l) {
+                 if(llSECC.isEmpty()) subscribe("SEND_EFFECT_CHAIN_COUNT");
+                 llSECC.add(l);
+         }
+         /**
+          * Removes the specified listener.
+          * Listeners can be removed regardless of the connection state.
+          * @param l The <code>SendEffectChainCountListener</code> to remove.
+          */
+         public synchronized void
+         removeSendEffectChainCountListener(SendEffectChainCountListener l) {
+                 boolean b = llSECC.remove(l);
+                 if(b && llSECC.isEmpty()) unsubscribe("SEND_EFFECT_CHAIN_COUNT");
+         }
+         /**
+          * Registers the specified listener for receiving event messages.
+          * Listeners can be registered regardless of the connection state.
+          * @param l The <code>SendEffectChainInfoListener</code> to register.
+          */
+         public synchronized void
+         addSendEffectChainInfoListener(SendEffectChainInfoListener l) {
+                 if(llSECI.isEmpty()) subscribe("SEND_EFFECT_CHAIN_INFO");
+                 llSECI.add(l);
+         }
+         /**
+          * Removes the specified listener.
+          * Listeners can be removed regardless of the connection state.
+          * @param l The <code>SendEffectChainInfoListener</code> to remove.
+          */
+         public synchronized void
+         removeSendEffectChainInfoListener(SendEffectChainInfoListener l) {
+                 boolean b = llSECI.remove(l);
+                 if(b && llSECI.isEmpty()) unsubscribe("SEND_EFFECT_CHAIN_INFO");
+         }
+         /**
           * Gets the number of all audio output drivers currently
           * available for the LinuxSampler instance.
           * @return The number of all audio output drivers currently
-          * available for the LinuxSampler instance.
+          * available for the LinuxSampler instance or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getAudioOutputDriverCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET AVAILABLE_AUDIO_OUTPUT_DRIVERS");
-                 out.writeLine("GET AVAILABLE_AUDIO_OUTPUT_DRIVERS");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 1227 
 public class Client {
+Line 1774 
 public class Client {
          /**
           * Gets detailed information about a specific audio output driver.
           * @param driverName The name of the audio output driver.
-          *
+          * @param depList An optional list of dependences parameters.
           * @return An <code>AudioOutputDriver</code> object containing
           * information about the specified audio output driver.
           *
-Line 1237 
 public class Client {
+Line 1784 
 public class Client {
           *
           * @see #getAudioOutputDriverNames
           */
-         private synchronized AudioOutputDriver
+         public synchronized AudioOutputDriver
-         getAudioOutputDriverInfo(String driverName) throws IOException, LscpException, LSException {
+         getAudioOutputDriverInfo(String driverName, Parameter... depList)
-                 verifyConnection();
+                                         throws IOException, LscpException, LSException {
-                 out.writeLine("GET AUDIO_OUTPUT_DRIVER INFO " + driverName);
-                 if(getPrintOnlyMode()) return null;
+                 AudioOutputDriver aod = new AudioOutputDriver();
+                 if(!retrieveInfo("GET AUDIO_OUTPUT_DRIVER INFO " + driverName, aod)) return null;
-                 ResultSet rs = getMultiLineResultSet();
-                 AudioOutputDriver aod = new AudioOutputDriver(rs.getMultiLineResult());
                  aod.setName(driverName);
                  for(String s : aod.getParameterNames())
-                         aod.addParameter(getAudioOutputDriverParameterInfo(driverName, s));
+                         aod.addParameter(getAudioOutputDriverParameterInfo(driverName, s, depList));
                  return aod;
          }
-Line 1282 
 public class Client {
+Line 1827 
 public class Client {
                  StringBuffer args = new StringBuffer(driver);
                  args.append(' ').append(param);
-                 for(Parameter p : deplist)
+                 for(Parameter p : deplist) {
+                         if(p == null || p.getName() == null || p.getValue() == null) continue;
                          args.append(' ').append(p.getName()).append('=').append(p.getStringValue());
+                 }
                  out.writeLine("GET AUDIO_OUTPUT_DRIVER_PARAMETER INFO " + args.toString());
                  if(getPrintOnlyMode()) return null;
-Line 1341 
 public class Client {
+Line 1888 
 public class Client {
          createAudioOutputDevice(String aoDriver, Parameter... paramList)
                                          throws IOException, LSException, LscpException {
-                 verifyConnection();
                  StringBuffer args = new StringBuffer(aoDriver);
-                 for(Parameter p : paramList)
+                 for(Parameter p : paramList) {
+                         if(p == null || p.getName() == null || p.getValue() == null) continue;
                          args.append(' ').append(p.getName()).append('=').append(p.getStringValue());
+                 }
-                 out.writeLine("CREATE AUDIO_OUTPUT_DEVICE " + args.toString());
-                 if(getPrintOnlyMode()) return -1;
+                 return retrieveIndex("CREATE AUDIO_OUTPUT_DEVICE " + args.toString());
-                 ResultSet rs = getEmptyResultSet();
-                 return rs.getIndex();
          }
          /**
-Line 1365 
 public class Client {
+Line 1908 
 public class Client {
           */
          public synchronized void
          destroyAudioOutputDevice(int deviceId) throws IOException, LSException, LscpException {
-                 verifyConnection();
+                 retrieveIndex("DESTROY AUDIO_OUTPUT_DEVICE " + deviceId);
-                 out.writeLine("DESTROY AUDIO_OUTPUT_DEVICE " + deviceId);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 1391 
 public class Client {
+Line 1930 
 public class Client {
          /**
           * Gets the current number of all created audio output devices.
-          * @return The current number of all created audio output devices.
+          * @return The current number of all created audio output devices
+          *  or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getAudioOutputDeviceCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET AUDIO_OUTPUT_DEVICES");
-                 out.writeLine("GET AUDIO_OUTPUT_DEVICES");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 1437 
 public class Client {
+Line 1972 
 public class Client {
           */
          public synchronized Integer[]
          getAudioOutputDeviceIDs() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return getIntegerList("LIST AUDIO_OUTPUT_DEVICES");
-                 out.writeLine("LIST AUDIO_OUTPUT_DEVICES");
-                 if(getPrintOnlyMode()) return null;
-                 return parseIntList(getSingleLineResultSet().getResult());
          }
          /**
-Line 1544 
 public class Client {
+Line 2075 
 public class Client {
           */
          public synchronized void
          setAudioOutputDeviceParameter(int deviceId, Parameter prm)
-                                                 throws IOException, LscpException, LSException {
+                                         throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String kv = prm.getName() + '=' + prm.getStringValue();
-                 out.writeLine("SET AUDIO_OUTPUT_DEVICE_PARAMETER " + deviceId + ' ' + kv);
+                 retrieveIndex("SET AUDIO_OUTPUT_DEVICE_PARAMETER " + deviceId + ' ' + kv);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 1735 
 public class Client {
+Line 2262 
 public class Client {
           */
          public synchronized void
          setAudioOutputChannelParameter(int devId, int chn,  Parameter prm)
-                                                 throws IOException, LscpException, LSException {
+                                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String args = devId + " " + chn + " " + prm.getName() + '=' + prm.getStringValue();
-                 out.writeLine("SET AUDIO_OUTPUT_CHANNEL_PARAMETER " + args);
+                 retrieveIndex("SET AUDIO_OUTPUT_CHANNEL_PARAMETER " + args);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
           * Gets the current number of all MIDI input drivers.
-          * @return The current number of all MIDI input drivers.
+          * @return The current number of all MIDI input drivers or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getMidiInputDriverCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET AVAILABLE_MIDI_INPUT_DRIVERS");
-                 out.writeLine("GET AVAILABLE_MIDI_INPUT_DRIVERS");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 1806 
 public class Client {
+Line 2324 
 public class Client {
          /**
           * Gets detailed information about a specific MIDI input driver.
           * @param driverName The name of the MIDI input driver.
-          *
+          * @param depList An optional list of dependences parameters.
           * @return A <code>MidiInputDriver</code> object containing
           * information about the specified MIDI input driver.
           *
-Line 1816 
 public class Client {
+Line 2334 
 public class Client {
           *
           * @see #getMidiInputDriverNames
           */
-         private synchronized MidiInputDriver
+         public synchronized MidiInputDriver
-         getMidiInputDriverInfo(String driverName) throws IOException, LscpException, LSException {
+         getMidiInputDriverInfo(String driverName, Parameter... depList)
-                 verifyConnection();
+                                         throws IOException, LscpException, LSException {
-                 out.writeLine("GET MIDI_INPUT_DRIVER INFO " + driverName);
-                 if(getPrintOnlyMode()) return null;
+                 MidiInputDriver mid = new MidiInputDriver();
+                 if(!retrieveInfo("GET MIDI_INPUT_DRIVER INFO " + driverName, mid)) return null;
-                 ResultSet rs = getMultiLineResultSet();
-                 MidiInputDriver mid = new MidiInputDriver(rs.getMultiLineResult());
                  mid.setName(driverName);
                  for(String s : mid.getParameterNames())
-                         mid.addParameter(getMidiInputDriverParameterInfo(driverName, s));
+                         mid.addParameter(getMidiInputDriverParameterInfo(driverName, s, depList));
                  return mid;
          }
-Line 1862 
 public class Client {
+Line 2377 
 public class Client {
                  StringBuffer args = new StringBuffer(driver);
                  args.append(' ').append(param);
-                 for(Parameter p : deplist)
+                 for(Parameter p : deplist) {
+                         if(p == null || p.getName() == null || p.getValue() == null) continue;
                          args.append(' ').append(p.getName()).append('=').append(p.getStringValue());
+                 }
                  out.writeLine("GET MIDI_INPUT_DRIVER_PARAMETER INFO " + args.toString());
                  if(getPrintOnlyMode()) return null;
-Line 1920 
 public class Client {
+Line 2437 
 public class Client {
           */
          public synchronized int
          createMidiInputDevice(String miDriver, Parameter... paramList)
-                                         throws IOException, LSException, LscpException {
+                                         throws IOException, LSException, LscpException
+         {
-                 verifyConnection();
                  StringBuffer args = new StringBuffer(miDriver);
-                 for(Parameter p : paramList)
+                 for(Parameter p : paramList) {
+                         if(p == null || p.getName() == null || p.getValue() == null) continue;
                          args.append(' ').append(p.getName()).append('=').append(p.getStringValue());
+                 }
-                 out.writeLine("CREATE MIDI_INPUT_DEVICE " + args.toString());
-                 if(getPrintOnlyMode()) return -1;
+                 return retrieveIndex("CREATE MIDI_INPUT_DEVICE " + args.toString());
-                 ResultSet rs = getEmptyResultSet();
-                 return rs.getIndex();
          }
          /**
-Line 1947 
 public class Client {
+Line 2460 
 public class Client {
           */
          public synchronized void
          destroyMidiInputDevice(int deviceId) throws IOException, LSException, LscpException {
-                 verifyConnection();
+                 retrieveIndex("DESTROY MIDI_INPUT_DEVICE " + deviceId);
-                 out.writeLine("DESTROY MIDI_INPUT_DEVICE " + deviceId);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 1973 
 public class Client {
+Line 2482 
 public class Client {
          /**
           * Gets the current number of all created MIDI input devices.
-          * @return The current number of all created MIDI input devices.
+          * @return The current number of all created MIDI input
+          * devices or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getMidiInputDeviceCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET MIDI_INPUT_DEVICES");
-                 out.writeLine("GET MIDI_INPUT_DEVICES");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 2025 
 public class Client {
+Line 2530 
 public class Client {
           */
          public synchronized Integer[]
          getMidiInputDeviceIDs() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return getIntegerList("LIST MIDI_INPUT_DEVICES");
-                 out.writeLine("LIST MIDI_INPUT_DEVICES");
-                 if(getPrintOnlyMode()) return null;
-                 return parseIntList(getSingleLineResultSet().getResult());
          }
          /**
-Line 2071 
 public class Client {
+Line 2572 
 public class Client {
                                  mid.setActive(Boolean.parseBoolean(s));
                          } else if(s.startsWith("PORTS: ")) {
                                  s = s.substring("PORTS: ".length());
-                                 int ports = Parser.parseInt(s);
-                                 MidiPort[] midiPorts = new MidiPort[ports > 0 ? ports : 0];
+                                 Parameter<Integer> ports = (Parameter<Integer>)
+                                         getMidiInputDriverParameterInfo(drv, "PORTS");
+                                 ports.parseValue(s);
+                                 mid.setPortsParameter(ports);
+                                 int j = ports.getValue();
+                                 MidiPort[] midiPorts = new MidiPort[j > 0 ? j : 0];
                                  for(int i = 0; i < midiPorts.length; i++)
                                          midiPorts[i] = getMidiInputPortInfo(deviceId, i);
-Line 2119 
 public class Client {
+Line 2627 
 public class Client {
           */
          public synchronized void
          setMidiInputDeviceParameter(int deviceId, Parameter prm)
-                                                 throws IOException, LscpException, LSException {
+                                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String kv = prm.getName() + '=' + prm.getStringValue();
-                 out.writeLine("SET MIDI_INPUT_DEVICE_PARAMETER " + deviceId + ' ' + kv);
+                 retrieveIndex("SET MIDI_INPUT_DEVICE_PARAMETER " + deviceId + ' ' + kv);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-          * Changes the port number of the speicified MIDI input device.
+          * Changes the port number of the specified MIDI input device.
           * @param deviceId The numerical ID of the MIDI input device.
           * @param ports The new number of MIDI input ports.
           *
-Line 2292 
 public class Client {
+Line 2796 
 public class Client {
           */
          public synchronized void
          setMidiInputPortParameter(int deviceId, int port,  Parameter prm)
-                                                 throws IOException, LscpException, LSException {
+                                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String args = deviceId + " " + port + " " +
                          prm.getName() + '=' + prm.getStringValue();
-                 out.writeLine("SET MIDI_INPUT_PORT_PARAMETER " + args);
+                 retrieveIndex("SET MIDI_INPUT_PORT_PARAMETER " + args);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 2314 
 public class Client {
+Line 2814 
 public class Client {
           */
          public synchronized int
          addMidiInstrumentMap(String name) throws IOException, LSException, LscpException {
-                 verifyConnection();
+                 return retrieveIndex("ADD MIDI_INSTRUMENT_MAP '" + toEscapedText(name) + "'");
-                 out.writeLine("ADD MIDI_INSTRUMENT_MAP '" + name + "'");
-                 if(getPrintOnlyMode()) return -1;
-                 ResultSet rs = getEmptyResultSet();
-                 return rs.getIndex();
          }
          /**
-Line 2334 
 public class Client {
+Line 2828 
 public class Client {
           */
          public synchronized void
          removeMidiInstrumentMap(int mapId) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 retrieveIndex("REMOVE MIDI_INSTRUMENT_MAP " + mapId);
-                 out.writeLine("REMOVE MIDI_INSTRUMENT_MAP " + mapId);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 2349 
 public class Client {
+Line 2839 
 public class Client {
           */
          public synchronized void
          removeAllMidiInstrumentMaps() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 retrieveIndex("REMOVE MIDI_INSTRUMENT_MAP ALL");
-                 out.writeLine("REMOVE MIDI_INSTRUMENT_MAP ALL");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
           * Gets the current number of all MIDI instrument maps.
-          * @return The current number of all MIDI instrument maps.
+          * @return The current number of all MIDI instrument maps
+          *  or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getMidiInstrumentMapCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET MIDI_INSTRUMENT_MAPS");
-                 out.writeLine("GET MIDI_INSTRUMENT_MAPS");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 2385 
 public class Client {
+Line 2867 
 public class Client {
           */
          public synchronized Integer[]
          getMidiInstrumentMapIDs() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return getIntegerList("LIST MIDI_INSTRUMENT_MAPS");
-                 out.writeLine("LIST MIDI_INSTRUMENT_MAPS");
-                 if(getPrintOnlyMode()) return null;
-                 return parseIntList(getSingleLineResultSet().getResult());
          }
          /**
-Line 2418 
 public class Client {
+Line 2896 
 public class Client {
                  for(String s : lnS) {
                          if(s.startsWith("NAME: ")) {
-                                 name = s.substring("NAME: ".length());
+                                 name = toNonEscapedString(s.substring("NAME: ".length()));
                          } else if(s.startsWith("DEFAULT: ")) {
                                  b = Boolean.parseBoolean(s.substring("DEFAULT: ".length()));
                          } else {
-Line 2463 
 public class Client {
+Line 2941 
 public class Client {
           */
          public synchronized void
          setMidiInstrumentMapName(int mapId, String name)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
+                 name = toEscapedText(name);
-                 out.writeLine("SET MIDI_INSTRUMENT_MAP NAME " +  + mapId + " '" + name + "'");
+                 retrieveIndex("SET MIDI_INSTRUMENT_MAP NAME " +  + mapId + " '" + name + "'");
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
           * Creates or replaces a MIDI instrument map entry.
           * @param mapId The ID of the map, where this instrument should be mapped.
-Line 2486 
 public class Client {
+Line 2963 
 public class Client {
          public synchronized void
          mapMidiInstrument(int mapId, MidiInstrumentEntry entry, MidiInstrumentInfo info)
                                          throws IOException, LSException, LscpException {
+                 mapMidiInstrument(mapId, entry, info, false);
+         }
+         /**
+          * Creates or replaces a MIDI instrument map entry.
+          * @param mapId The ID of the map, where this instrument should be mapped.
+          * @param entry Specifies the position of the MIDI instrument in the MIDI instrument map.
+          * @param info Provides the needed information of the
+          * MIDI instrument, which will be mapped to the specified MIDI instrument map.
+          * @param nonModal If <code>true</code> the function returns immediately
+          * and the mapping is established in the background.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the mapping failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #unmapMidiInstrument
+          */
+         public synchronized void
+         mapMidiInstrument(int mapId, MidiInstrumentEntry entry, MidiInstrumentInfo info, boolean nonModal)
+                                         throws IOException, LSException, LscpException {
                  verifyConnection();
                  StringBuffer cmd = new StringBuffer("MAP MIDI_INSTRUMENT ");
+                 if(nonModal) cmd.append("NON_MODAL ");
                  cmd.append(mapId).append(' ');
                  cmd.append(entry.getMidiBank()).append(' ');
                  cmd.append(entry.getMidiProgram()).append(' ');
                  cmd.append(info.getEngine()).append(" '");
-                 cmd.append(info.getFileName()).append("' ");
+                 cmd.append(conv(info.getFilePath())).append("' ");
                  cmd.append(info.getInstrumentIndex()).append(' ');
                  cmd.append(info.getVolume());
                  if(!info.getLoadMode().name().equals("DEFAULT")) {
                          cmd.append(' ').append(info.getLoadMode().name());
                  }
-                 if(info.getName() != null) cmd.append(" '").append(info.getName()).append("'");
+                 if(info.getName() != null) {
+                         String s = toEscapedText(info.getName());
+                         cmd.append(" '").append(s).append("'");
+                 }
                  out.writeLine(cmd.toString());
                  if(getPrintOnlyMode()) return;
-Line 2519 
 public class Client {
+Line 3020 
 public class Client {
           */
          public synchronized void
          unmapMidiInstrument(int mapId, MidiInstrumentEntry entry)
-                                         throws IOException, LSException, LscpException {
+                                         throws IOException, LSException, LscpException
+         {
-                 verifyConnection();
                  StringBuffer cmd = new StringBuffer("UNMAP MIDI_INSTRUMENT ");
                  cmd.append(mapId).append(' ');
                  cmd.append(entry.getMidiBank()).append(' ');
                  cmd.append(entry.getMidiProgram());
-                 out.writeLine(cmd.toString());
+                 retrieveIndex(cmd.toString());
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
           * Gets the current number of all MIDI instrument in all maps.
-          * @return The current number of all MIDI instrument in all maps.
+          * @return The current number of all MIDI instrument in all maps
+          * or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getMidiInstrumentCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET MIDI_INSTRUMENTS ALL");
-                 out.writeLine("GET MIDI_INSTRUMENTS ALL");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
           * Gets the current number of MIDI instrument in the specified map.
           * @param mapId The ID of the map.
-          * @return The current number of MIDI instrument in the specified map.
+          * @return The current number of MIDI instrument in the
+          * specified map or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getMidiInstrumentCount(int mapId) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET MIDI_INSTRUMENTS " + String.valueOf(mapId));
-                 out.writeLine("GET MIDI_INSTRUMENTS " + String.valueOf(mapId));
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 2588 
 public class Client {
+Line 3077 
 public class Client {
          }
          /**
-          * Gets all MIDI instrument contained int the specified MIDI instrument map.
+          * Gets all MIDI instrument entries contained int the specified MIDI instrument map.
+          * @param mapId The ID of the map, which instruments should be obtained.
+          * @return An int array providing all MIDI instrument entries
+          * in the specified MIDI instrument map.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int[][]
+         getMidiInstrumentEntries(int mapId) throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 out.writeLine("LIST MIDI_INSTRUMENTS " + String.valueOf(mapId));
+                 if(getPrintOnlyMode()) return null;
+                 String[] entries = parseArray(getSingleLineResultSet().getResult());
+                 int[][] e = new int[entries.length][3];
+                 for(int i = 0; i < entries.length; i++) {
+                         Integer[] vals = parseIntList(entries[i]);
+                         if(vals.length != 3) {
+                                 throw new LscpException(LscpI18n.getLogMsg("CommandFailed!"));
+                         }
+                         e[i][0] = vals[0];
+                         e[i][1] = vals[1];
+                         e[i][2] = vals[2];
+                 }
+                 return e;
+         }
+         /**
+          * Gets all MIDI instruments contained int the specified MIDI instrument map.
           * @param mapId The ID of the map, which instruments should be obtained.
           * @return A <code>MidiInstrumentInfo</code> array providing
-          * all MIDI instruments from all MIDI instrument maps.
+          * all MIDI instruments in the specified MIDI instrument map.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
-Line 2639 
 public class Client {
+Line 3160 
 public class Client {
                                          throws IOException, LscpException, LSException {
                  verifyConnection();
+                 requestMidiInstrumentInfo(mapId, bank, program);
+                 return getMidiInstrumentInfoResponse(mapId, bank, program);
+         }
+         private void
+         requestMidiInstrumentInfo(int mapId, int bank, int program) throws IOException {
                  StringBuffer cmd = new StringBuffer("GET MIDI_INSTRUMENT INFO ");
                  cmd.append(mapId).append(' ');
                  cmd.append(bank).append(' ');
                  cmd.append(program);
                  out.writeLine(cmd.toString());
-                 if(getPrintOnlyMode()) return null;
+         }
+         private MidiInstrumentInfo
+         getMidiInstrumentInfoResponse(int mapId, int bank, int program)
+                                         throws IOException, LscpException, LSException {
+                 if(getPrintOnlyMode()) return null;
                  ResultSet rs = getMultiLineResultSet();
                  MidiInstrumentEntry entry = new MidiInstrumentEntry(bank, program);
                  return new MidiInstrumentInfo(mapId, entry, rs.getMultiLineResult());
-Line 2693 
 public class Client {
+Line 3225 
 public class Client {
           */
          public synchronized void
          loadInstrument(String filename, int instrIdx, int samplerChn, boolean nonModal)
-                                                 throws IOException, LscpException, LSException {
+                                                 throws IOException, LscpException, LSException
+         {
                  String cmd = nonModal ? "LOAD INSTRUMENT NON_MODAL " : "LOAD INSTRUMENT ";
-                 String args = '\'' + filename + "' " + instrIdx + ' ' + samplerChn;
+                 String args = '\'' + conv(filename) + "' " + instrIdx + ' ' + samplerChn;
-                 out.writeLine(cmd + args);
+                 retrieveIndex(cmd + args);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 2718 
 public class Client {
+Line 3247 
 public class Client {
           */
          public synchronized void
          loadSamplerEngine(String engineName, int samplerChn)
-                                         throws IOException, LscpException, LSException {
+                                         throws IOException, LscpException, LSException
+         { retrieveIndex("LOAD ENGINE " + engineName + ' ' + samplerChn); }
-                 verifyConnection();
-                 out.writeLine("LOAD ENGINE " + engineName + ' ' + samplerChn);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Gets the current number of all created sampler channels.
-          * @return The current number of all created sampler channels.
+          * @return The current number of all created sampler
+          * channels or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getSamplerChannelCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET CHANNELS");
-                 out.writeLine("GET CHANNELS");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 2765 
 public class Client {
+Line 3284 
 public class Client {
                  return channels;
          }
+         /**
+          * Gets a list of the specified sampler channels.
+          * @return A <code>SamplerChannel</code> array providing all created sampler channels.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          * @see #addSamplerChannel
+          * @see #removeSamplerChannel
+          */
+         public synchronized SamplerChannel[]
+         getSamplerChannels(final Integer[] ids) throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 int count = 0;
+                 for(int i = 0; i < ids.length; i++) {
+                         if(ids[i] >= 0) {
+                                 int tmp = ids[i]; // to avoid overlapping
+                                 ids[i] = -1;
+                                 ids[count++] = tmp;
+                         }
+                 }
+                 if(getPrintOnlyMode()) return null;
+                 final SamplerChannel[] channels = new SamplerChannel[count];
+                 new CmdListIterator(count) {
+                         @Override
+                         protected void
+                         writeOutput(int index) throws IOException {
+                                 channels[index] = new SamplerChannel();
+                                 out.writeLine("GET CHANNEL INFO " + ids[index]);
+                                 channels[index].setChannelId(ids[index]);
+                         }
+                         @Override
+                         protected void
+                         readInput(int index) throws IOException, LscpException, LSException {
+                                 if(getPrintOnlyMode()) return;
+                                 ResultSet rs = getMultiLineResultSet();
+                                 for(String s : rs.getMultiLineResult()) {
+                                         if(!channels[index].parse(s)) {
+                                                 String msg = LscpI18n.getLogMsg("unknownLine", s);
+                                                 Client.getLogger().info(msg);
+                                         }
+                                 }
+                         }
+                 }.run();
+                 for(SamplerChannel sc : channels) {
+                         if(sc.getEngine() != null) {
+                                 sc.setEngine(getEngineInfo(sc.getEngine().getName()));
+                         }
+                 }
+                 return channels;
+         }
+         private static abstract class CmdListIterator {
+                 private final int cmdCount;
+                 private final int cmdsPerStep;
+                 CmdListIterator(int cmdCount) {
+                         this(cmdCount, 100);
+                 }
+                 CmdListIterator(int cmdCount, int cmdsPerStep) {
+                         this.cmdCount = cmdCount;
+                         this.cmdsPerStep = cmdsPerStep;
+                 }
+                 public void
+                 run() throws IOException, LscpException, LSException {
+                         int currentStep = 0;
+                         int stepCount = cmdCount / cmdsPerStep;
+                         for(currentStep = 0; currentStep < stepCount; currentStep++) {
+                                 for(int j = 0; j < cmdsPerStep; j++) {
+                                         int idx = (currentStep * cmdsPerStep) + j;
+                                         writeOutput(idx);
+                                 }
+                                 for(int j = 0; j < cmdsPerStep; j++) {
+                                         int idx = (currentStep * cmdsPerStep) + j;
+                                         readInput(idx);
+                                 }
+                         }
+                         int cmdsLeft = cmdCount % cmdsPerStep;
+                         if(cmdsLeft > 0) {
+                                 for(int j = 0; j < cmdsLeft; j++) {
+                                         int idx = stepCount * cmdsPerStep + j;
+                                         writeOutput(idx);
+                                 }
+                                 for(int j = 0; j < cmdsLeft; j++) {
+                                         int idx = stepCount * cmdsPerStep + j;
+                                         readInput(idx);
+                                 }
+                         }
+                 }
+                 protected abstract void writeOutput(int index) throws IOException;
+                 protected abstract void readInput(int index) throws IOException, LscpException, LSException;
+         }
          /**
           * Gets a list with numerical IDs of all created sampler channels.
-Line 2778 
 public class Client {
+Line 3406 
 public class Client {
           */
          public synchronized Integer[]
          getSamplerChannelIDs() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return getIntegerList("LIST CHANNELS");
-                 out.writeLine("LIST CHANNELS");
-                 if(getPrintOnlyMode()) return null;
-                 return parseIntList(getSingleLineResultSet().getResult());
          }
          /**
-Line 2797 
 public class Client {
+Line 3421 
 public class Client {
           */
          public synchronized int
          addSamplerChannel() throws IOException, LSException, LscpException {
-                 verifyConnection();
+                 return retrieveIndex("ADD CHANNEL");
-                 out.writeLine("ADD CHANNEL");
-                 if(getPrintOnlyMode()) return -1;
-                 ResultSet rs = getEmptyResultSet();
-                 return rs.getIndex();
          }
          /**
-Line 2819 
 public class Client {
+Line 3437 
 public class Client {
           */
          public synchronized void
          removeSamplerChannel(int samplerChn) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 retrieveIndex("REMOVE CHANNEL " + samplerChn);
-                 out.writeLine("REMOVE CHANNEL " + samplerChn);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
           * Gets the number of all available engines.
-          * @return The number of all available engines.
+          * @return The number of all available engines or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getEngineCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET AVAILABLE_ENGINES");
-                 out.writeLine("GET AVAILABLE_ENGINES");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 2894 
 public class Client {
+Line 3503 
 public class Client {
           */
          private synchronized SamplerEngine
          getEngineInfo(String engineName) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 SamplerEngine se = new SamplerEngine();
-                 out.writeLine("GET ENGINE INFO " + engineName);
+                 if(!retrieveInfo("GET ENGINE INFO " + engineName, se)) return null;
-                 if(getPrintOnlyMode()) return null;
-                 ResultSet rs = getMultiLineResultSet();
-                 SamplerEngine se = new SamplerEngine(rs.getMultiLineResult());
                  se.setName(engineName);
                  return se;
          }
-Line 2918 
 public class Client {
+Line 3524 
 public class Client {
           */
          public synchronized SamplerChannel
          getSamplerChannelInfo(int samplerChn) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 SamplerChannel sc = new SamplerChannel();
-                 out.writeLine("GET CHANNEL INFO " + samplerChn);
+                 if(!retrieveInfo("GET CHANNEL INFO " + samplerChn, sc)) return null;
-                 if(getPrintOnlyMode()) return null;
-                 ResultSet rs = getMultiLineResultSet();
-                 SamplerChannel sc = new SamplerChannel(rs.getMultiLineResult());
                  sc.setChannelId(samplerChn);
                  if(sc.getEngine() != null) sc.setEngine(getEngineInfo(sc.getEngine().getName()));
-Line 2934 
 public class Client {
+Line 3536 
 public class Client {
           * Gets the current number of active voices on the specified sampler channel.
           *
           * @param samplerChn The sampler channel number.
-          * @return The current number of active voices on the specified sampler channel.
+          * @return The current number of active voices on the
+          * specified sampler channel or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If there is no sampler channel with number <code>samplerChn</code>.
-Line 2942 
 public class Client {
+Line 3545 
 public class Client {
           */
          public synchronized int
          getChannelVoiceCount(int samplerChn) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET CHANNEL VOICE_COUNT " + samplerChn);
-                 out.writeLine("GET CHANNEL VOICE_COUNT " + samplerChn);
-                 if(getPrintOnlyMode()) return -1;
-                 ResultSet rs = getSingleLineResultSet();
-                 return parseInt(rs.getResult());
          }
          /**
-Line 3088 
 public class Client {
+Line 3685 
 public class Client {
           */
          public synchronized void
          setChannelAudioOutputDevice(int samplerChn, int devId)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         { retrieveIndex("SET CHANNEL AUDIO_OUTPUT_DEVICE " + samplerChn + ' ' + devId); }
-                 verifyConnection();
-                 out.writeLine("SET CHANNEL AUDIO_OUTPUT_DEVICE " + samplerChn + ' ' + devId);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Sets the audio output channel on the specified sampler channel.
-Line 3118 
 public class Client {
+Line 3709 
 public class Client {
           */
          public synchronized void
          setChannelAudioOutputChannel(int samplerChn, int audioOut, int audioIn)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String args = " " + samplerChn + ' ' + audioOut + ' ' + audioIn;
-                 out.writeLine("SET CHANNEL AUDIO_OUTPUT_CHANNEL" + args);
+                 retrieveIndex("SET CHANNEL AUDIO_OUTPUT_CHANNEL" + args);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 3147 
 public class Client {
+Line 3734 
 public class Client {
           */
          public synchronized void
          setChannelMidiInputDevice(int samplerChn, int devId)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         { retrieveIndex("SET CHANNEL MIDI_INPUT_DEVICE " + samplerChn + ' ' + devId); }
-                 verifyConnection();
-                 out.writeLine("SET CHANNEL MIDI_INPUT_DEVICE " + samplerChn + ' ' + devId);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Sets the MIDI input port on the specified sampler channel.
-Line 3170 
 public class Client {
+Line 3751 
 public class Client {
           */
          public synchronized void
          setChannelMidiInputPort(int samplerChn, int port)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         { retrieveIndex("SET CHANNEL MIDI_INPUT_PORT " + samplerChn + ' ' + port); }
-                 verifyConnection();
-                 out.writeLine("SET CHANNEL MIDI_INPUT_PORT " + samplerChn + ' ' + port);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Sets the MIDI input channel the specified sampler channel should listen to.
-Line 3193 
 public class Client {
+Line 3768 
 public class Client {
           */
          public synchronized void
          setChannelMidiInputChannel(int samplerChn, int midiChn)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String args = String.valueOf(samplerChn) + ' ';
                  args += (midiChn == -1 ? "ALL" : String.valueOf(midiChn));
-                 out.writeLine("SET CHANNEL MIDI_INPUT_CHANNEL " + args);
+                 retrieveIndex("SET CHANNEL MIDI_INPUT_CHANNEL " + args);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 3225 
 public class Client {
+Line 3796 
 public class Client {
           */
          public synchronized void
          setChannelMidiInstrumentMap(int samplerChn, int mapId)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String s;
                  if(mapId == -1) {
                          s = " NONE";
-Line 3236 
 public class Client {
+Line 3806 
 public class Client {
                  } else {
                          s = " " + String.valueOf(mapId);
                  }
-                 out.writeLine("SET CHANNEL MIDI_INSTRUMENT_MAP " + samplerChn + s);
-                 if(getPrintOnlyMode()) return;
+                 retrieveIndex("SET CHANNEL MIDI_INSTRUMENT_MAP " + samplerChn + s);
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 3256 
 public class Client {
+Line 3824 
 public class Client {
           */
          public synchronized void
          setChannelVolume(int samplerChn, float volume)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         { retrieveIndex("SET CHANNEL VOLUME " + samplerChn + ' ' + volume); }
-                 verifyConnection();
-                 out.writeLine("SET CHANNEL VOLUME " + samplerChn + ' ' + volume);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Mute/unmute the specified sampler channel.
-Line 3280 
 public class Client {
+Line 3842 
 public class Client {
           */
          public synchronized void
          setChannelMute(int samplerChn, boolean mute)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         { retrieveIndex("SET CHANNEL MUTE " + samplerChn + ' ' + (mute ? 1 : 0)); }
-                 verifyConnection();
-                 out.writeLine("SET CHANNEL MUTE " + samplerChn + ' ' + (mute ? 1 : 0));
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Solo/unsolo the specified sampler channel.
-Line 3304 
 public class Client {
+Line 3860 
 public class Client {
           */
          public synchronized void
          setChannelSolo(int samplerChn, boolean solo)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         { retrieveIndex("SET CHANNEL SOLO " + samplerChn + ' ' + (solo ? 1 : 0)); }
-                 verifyConnection();
-                 out.writeLine("SET CHANNEL SOLO " + samplerChn + ' ' + (solo ? 1 : 0));
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
-         }
          /**
           * Creates an additional effect send on the specified sampler channel.
-Line 3344 
 public class Client {
+Line 3894 
 public class Client {
           */
          public synchronized int
          createFxSend(int channel, int midiCtrl, String name)
-                         throws IOException, LSException, LscpException {
+                         throws IOException, LSException, LscpException
+         {
-                 verifyConnection();
                  String s = String.valueOf(channel) + " " + String.valueOf(midiCtrl);
-                 if(name != null) s += " '" + name + "'";
+                 if(name != null) s += " '" + toEscapedText(name) + "'";
-                 out.writeLine("CREATE FX_SEND " + s);
-                 if(getPrintOnlyMode()) return -1;
+                 return retrieveIndex("CREATE FX_SEND " + s);
-                 ResultSet rs = getEmptyResultSet();
-                 return rs.getIndex();
          }
          /**
-Line 3368 
 public class Client {
+Line 3913 
 public class Client {
           */
          public synchronized void
          destroyFxSend(int channel, int fxSend)
-                         throws IOException, LSException, LscpException {
+                         throws IOException, LSException, LscpException
+         {
-                 verifyConnection();
                  String s = String.valueOf(channel) + " " + String.valueOf(fxSend);
-                 out.writeLine("DESTROY FX_SEND " + s);
+                 retrieveIndex("DESTROY FX_SEND " + s);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 3387 
 public class Client {
+Line 3928 
 public class Client {
           * @throws LSException If some other error occurs.
           */
          public synchronized int
-         getFxSoundCount(int channel) throws IOException, LscpException, LSException {
+         getFxSendCount(int channel) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET FX_SENDS " + String.valueOf(channel));
-                 out.writeLine("GET FX_SENDS " + String.valueOf(channel));
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 3433 
 public class Client {
+Line 3969 
 public class Client {
           */
          public synchronized Integer[]
          getFxSendIDs(int channel) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return getIntegerList("LIST FX_SENDS " + channel);
-                 out.writeLine("LIST FX_SENDS " + channel);
-                 if(getPrintOnlyMode()) return null;
-                 return parseIntList(getSingleLineResultSet().getResult());
          }
          /**
-Line 3452 
 public class Client {
+Line 3984 
 public class Client {
           */
          public synchronized FxSend
          getFxSendInfo(int channel, int fxSend) throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 FxSend fxs = new FxSend();
                  String s = String.valueOf(channel) + " " + String.valueOf(fxSend);
-                 out.writeLine("GET FX_SEND INFO " + s);
+                 if(!retrieveInfo("GET FX_SEND INFO " + s, fxs)) return null;
-                 if(getPrintOnlyMode()) return null;
-                 ResultSet rs = getMultiLineResultSet();
-                 FxSend fxs = new FxSend(rs.getMultiLineResult());
                  fxs.setFxSendId(fxSend);
                  return fxs;
-Line 3476 
 public class Client {
+Line 4004 
 public class Client {
           */
          public synchronized void
          setFxSendName(int channel, int fxSend, String name)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
+                 String args = " " + channel + " " + fxSend + " '" + toEscapedText(name) + "'";
-                 String args = " " + channel + " " + fxSend + " '" + name + "'";
+                 retrieveIndex("SET FX_SEND NAME" + args);
-                 out.writeLine("SET FX_SEND NAME" + args);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 3506 
 public class Client {
+Line 4030 
 public class Client {
           */
          public synchronized void
          setFxSendAudioOutputChannel(int channel, int fxSend, int audioSrc, int audioDst)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String args = " " + channel + " " + fxSend + " " + audioSrc + " " + audioDst;
-                 out.writeLine("SET FX_SEND AUDIO_OUTPUT_CHANNEL" + args);
+                 retrieveIndex("SET FX_SEND AUDIO_OUTPUT_CHANNEL" + args);
-                 if(getPrintOnlyMode()) return;
+         }
-                 ResultSet rs = getEmptyResultSet();
+         /**
+          * Assign a destination effect to an effect send.
+          * @param channel The sampler channel number.
+          * @param fxSend The numerical ID of the effect send entity.
+          * @param fxChainId The numerical ID of the destination effect chain.
+          * @param chainPos The exact effect chain position in the effect
+          * chain which hosts the actual destination effect.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If
+          * <ul>
+          * <li><code>channel</code> is not a valid channel number;
+          * <li><code>fxSend</code> is not a valid effect send ID;
+          * <li><code>fxChainId</code> is not a valid effect chain ID;
+          * <li><code>chainPos</code> is out of bounds;
+          * <li>There is no engine assigned yet to the specified sampler channel;
+          * <li>There is no audio output device connected to the specified sampler channel.
+          * </ul>
+          */
+         public synchronized void
+         setFxSendEffect(int channel, int fxSend, int fxChainId, int chainPos)
+                                 throws IOException, LscpException, LSException
+         {
+                 String args = " " + channel + " " + fxSend + " " + fxChainId + " " + chainPos;
+                 retrieveIndex("SET FX_SEND EFFECT" + args);
+         }
+         /**
+          * Removes destination effect from an effect send.
+          * @param channel The sampler channel number.
+          * @param fxSend The numerical ID of the effect send entity.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If other error occurs.
+          */
+         public synchronized void
+         removeFxSendEffect(int channel, int fxSend) throws IOException, LscpException, LSException {
+                 String args = " " + channel + " " + fxSend;
+                 retrieveIndex("REMOVE FX_SEND EFFECT" + args);
          }
          /**
-Line 3534 
 public class Client {
+Line 4095 
 public class Client {
           */
          public synchronized void
          setFxSendMidiController(int channel, int fxSend, int midiCtrl)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String args = " " + channel + " " + fxSend + " " + midiCtrl;
-                 out.writeLine("SET FX_SEND MIDI_CONTROLLER" + args);
+                 retrieveIndex("SET FX_SEND MIDI_CONTROLLER" + args);
-                 if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
          }
          /**
-Line 3557 
 public class Client {
+Line 4114 
 public class Client {
           */
          public synchronized void
          setFxSendLevel(int channel, int fxSend, float volume)
-                                 throws IOException, LscpException, LSException {
+                                 throws IOException, LscpException, LSException
+         {
-                 verifyConnection();
                  String args = " " + channel + " " + fxSend + " " + String.valueOf(volume);
-                 out.writeLine("SET FX_SEND LEVEL" + args);
+                 retrieveIndex("SET FX_SEND LEVEL" + args);
-                 if(getPrintOnlyMode()) return;
+         }
-                 ResultSet rs = getEmptyResultSet();
+         /**
+          * Gets the current amount of internal effects available to the sampler.
+          * @return The current amount of internal effects available to the sampler.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int
+         getEffectCount() throws IOException, LscpException, LSException
+         { return retrieveInt("GET AVAILABLE_EFFECTS"); }
+         /**
+          * Gets the list of internal effects available to the sampler.
+          * Note that the set of available internal effects can change at runtime.
+          * @return An <code>Effect</code> array providing the current list of internal effects.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized Effect[]
+         getEffects() throws IOException, LscpException, LSException {
+                 Integer[] idS = getEffectIDs();
+                 if(getPrintOnlyMode()) return null;
+                 Effect[] effects = new Effect[idS.length];
+                 for(int i = 0; i < effects.length; i++)
+                         effects[i] = getEffectInfo(idS[i]);
+                 return effects;
+         }
+         /**
+          * Retrieves the list of available internal effects.
+          * Note that the set of available internal effects can change at runtime.
+          * @return An <code>Integer</code> array providing
+          * the numerical IDs of all available internal effects.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized Integer[]
+         getEffectIDs() throws IOException, LscpException, LSException
+         { return getIntegerList("LIST AVAILABLE_EFFECTS"); }
+         /**
+          * Gets general informations about the specified effect.
+          * @param effect The numerical ID of the effect entity.
+          * @return <code>Effect</code> instance containing
+          * general informations about the specified effect.
+          * @throws IOException If an I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the effect ID is invalid.
+          */
+         public synchronized Effect
+         getEffectInfo(int effect) throws IOException, LscpException, LSException {
+                 Effect e = new Effect();
+                 if(!retrieveInfo("GET EFFECT INFO " + effect, e)) return null;
+                 e.setEffectId(effect);
+                 return e;
+         }
+         /**
+          * Creates an instance of the desired effect.
+          * @param id The unique ID of the effect.
+          * @return The unique ID of the newly created effect instance.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the creation of the effect instance failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #getEffectIDs
+          * @see #getEffectInfo
+          * @see #destroyEffectInstance
+          */
+         public synchronized int
+         createEffectInstanceById(int id) throws IOException, LSException, LscpException
+         { return retrieveIndex("CREATE EFFECT_INSTANCE " + String.valueOf(id)); }
+         /**
+          * Creates an instance of the desired effect.
+          * @return The unique ID of the newly created effect instance.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the creation of the effect instance failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #getEffectInfo
+          * @see #destroyEffectInstance
+          */
+         public synchronized int
+         createEffectInstance(Effect effect) throws IOException, LSException, LscpException
+         { return createEffectInstanceById(effect.getEffectId()); }
+         /**
+          * Creates an instance of the desired effect.
+          * @return The unique ID of the newly created effect instance.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the creation of the effect instance failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #getEffectInfo
+          * @see #destroyEffectInstance
+          */
+         public synchronized int
+         createEffectInstance(String system, String module, String name)
+                         throws IOException, LSException, LscpException
+         {
+                 String s = system + " '" + toEscapedText(module) + "' '" + toEscapedText(name) + "'";
+                 return retrieveIndex("CREATE EFFECT_INSTANCE " + s);
+         }
+         /**
+          * Destroys the specified unused effect instance.
+          * @param instanceId The numerical ID of the effect instance.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          * @see #createEffectInstance
+          */
+         public synchronized void
+         destroyEffectInstance(int instanceId) throws IOException, LSException, LscpException
+         { retrieveIndex("DESTROY EFFECT_INSTANCE " + String.valueOf(instanceId)); }
+         /**
+          * Gets the current amount of effect instances available to the sampler.
+          * @return The current amount of effect instances available to the sampler.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int
+         getEffectInstanceCount() throws IOException, LscpException, LSException
+         { return retrieveInt("GET EFFECT_INSTANCES"); }
+         /**
+          * Gets the current list of effect instances.
+          * @return An <code>EffectInstance</code> array
+          * providing the current list of effect instances.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized EffectInstance[]
+         getEffectInstances() throws IOException, LscpException, LSException {
+                 Integer[] idS = getEffectInscanceIDs();
+                 if(getPrintOnlyMode()) return null;
+                 EffectInstance[] eis = new EffectInstance[idS.length];
+                 for(int i = 0; i < eis.length; i++)
+                         eis[i] = getEffectInstanceInfo(idS[i]);
+                 return eis;
+         }
+         /**
+          * Retrieves the current list of effect instances.
+          * @return An <code>Integer</code> array providing
+          * the numerical IDs of all available effect instances.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized Integer[]
+         getEffectInscanceIDs() throws IOException, LscpException, LSException
+         { return getIntegerList("LIST EFFECT_INSTANCES"); }
+         /**
+          * Gets the current informations about the specified effect instance.
+          * @param id The numerical ID of the effect instance.
+          * @return <code>EffectInstance</code> object containing
+          * the current informations about the specified effect instance.
+          * @throws IOException If an I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the effect instance ID is invalid.
+          */
+         public synchronized EffectInstance
+         getEffectInstanceInfo(int id) throws IOException, LscpException, LSException {
+                 EffectInstance ei = new EffectInstance();
+                 if(!retrieveInfo("GET EFFECT_INSTANCE INFO " + id, ei)) return null;
+                 ei.setInstanceId(id);
+                 for(int i = 0; i < ei.getParameterCount(); i++) {
+                         ei.addParameter(getEffectInstanceParameterInfo(id, i));
+                 }
+                 return ei;
+         }
+         /**
+          * Gets information about the specified effect parameter.
+          * @param id The numerical ID of the effect instance.
+          * @param parameter The parameter index.
+          * @return <code>EffectParameter</code> object containing
+          * information about the specified effect parameter.
+          * Note that only the following fields are used - description,
+          * value, rangeMin, rangeMax, possibilities and default.
+          * @throws IOException If an I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the effect instance ID or the parameter index is invalid.
+          */
+         public synchronized EffectParameter
+         getEffectInstanceParameterInfo(int instanceId, int parameter)
+                                 throws IOException, LscpException, LSException
+         {
+                 EffectParameter prm = new EffectParameter();
+                 String s = String.valueOf(instanceId) + " " + String.valueOf(parameter);
+                 if(!retrieveInfo("GET EFFECT_INSTANCE_INPUT_CONTROL INFO " + s, prm)) return null;
+                 return prm;
+         }
+         /**
+          * Alters the current value of an effect parameter.
+          * @param instanceId The numerical ID of the effect instance.
+          * @param prmIndex The index of the parameter to alter.
+          * @param value The new value for this parameter.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If
+          * <ul>
+          * <li>There is no effect instance with numerical ID <code>instanceId</code>;
+          * <li>There parameter index is invalid;
+          * <li>The new value is out of range;
+          * </ul>
+          *
+          * @see #getEffectInstanceInfo
+          * @see #getEffectInstanceParameterInfo
+          */
+         public synchronized void
+         setEffectInstanceParameter(int instanceId, int prmIndex, float value)
+                                         throws IOException, LscpException, LSException
+         {
+                 String s = " " + instanceId + " " + prmIndex + " " + value;
+                 retrieveIndex("SET EFFECT_INSTANCE_INPUT_CONTROL VALUE" + s);
+         }
+         /**
+          * Gets the current amount of send effect chains on the specified audio output device.
+          * @param audioDeviceId numerical ID of the audio output device.
+          * @return The current amount of send effect chains or -1 if in "print only" mode.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int
+         getSendEffectChainCount(int audioDeviceId) throws IOException, LscpException, LSException
+         { return retrieveInt("GET SEND_EFFECT_CHAINS " + audioDeviceId); }
+         /**
+          * Gets the current list of send effect chains on the specified audio output device.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @return An <code>EffectInstance</code> array
+          * providing the current list of effect instances.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized EffectChain[]
+         getSendEffectChains(int audioDeviceId) throws IOException, LscpException, LSException {
+                 Integer[] idS = getSendEffectChainIDs(audioDeviceId);
+                 if(getPrintOnlyMode()) return null;
+                 EffectChain[] ecs = new EffectChain[idS.length];
+                 for(int i = 0; i < ecs.length; i++) {
+                         ecs[i] = getSendEffectChainInfo(audioDeviceId, idS[i]);
+                         ecs[i].setChainId(idS[i]);
+                 }
+                 return ecs;
+         }
+         /**
+          * Retrieves the current list of send effect
+          * chains on the specified audio output device.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @return An <code>Integer</code> array providing the numerical
+          * IDs of all send effect chains on the specified audio output device.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized Integer[]
+         getSendEffectChainIDs(int audioDeviceId) throws IOException, LscpException, LSException
+         { return getIntegerList("LIST SEND_EFFECT_CHAINS " + audioDeviceId); }
+         /**
+          * Adds a send effect chain to the specified audio output device.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @return The numerical ID of the new send effect chain.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the creation of the effect chain failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #removeSendEffectChain
+          * @see #getSendEffectChainInfo
+          */
+         public synchronized int
+         addSendEffectChain(int audioDeviceId) throws IOException, LSException, LscpException
+         { return retrieveIndex("ADD SEND_EFFECT_CHAIN " + audioDeviceId); }
+         /**
+          * Removes a send effect chain from an audio output device.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @param chainId The numerical ID of the send effect chain to remove.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          * @see #addSendEffectChain
+          */
+         public synchronized void
+         removeSendEffectChain(int audioDeviceId, int chainId) throws IOException, LSException, LscpException
+         { retrieveIndex("REMOVE SEND_EFFECT_CHAIN " + audioDeviceId + " " + chainId); }
+         /**
+          * Gets the current information of a send effect chain.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @param chainId The numerical ID of the send effect chain.
+          * @return <code>EffectChain</code> object containing
+          * the current informations about the specified effect chain.
+          * @throws IOException If an I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the audio device ID or the effect chain ID is invalid.
+          */
+         public synchronized EffectChain
+         getSendEffectChainInfo(int audioDeviceId, int chainId)
+                                 throws IOException, LscpException, LSException
+         {
+                 verifyConnection();
+                 String str = " " + audioDeviceId + " " + chainId;
+                 out.writeLine("GET SEND_EFFECT_CHAIN INFO" + str);
+                 if(getPrintOnlyMode()) return null;
+                 ResultSet rs = getMultiLineResultSet();
+                 EffectChain chain = null;
+                 for(String s : rs.getMultiLineResult()) {
+                         if(s.startsWith("EFFECT_SEQUENCE: ")) {
+                                 s = s.substring("EFFECT_SEQUENCE: ".length());
+                                 Integer[] eis = parseIntList(s);
+                                 EffectInstance[] instances = new EffectInstance[eis.length];
+                                 for(int i = 0; i < eis.length; i++) {
+                                         instances[i] = getEffectInstanceInfo(eis[i]);
+                                 }
+                                 chain = new EffectChain(instances);
+                                 chain.setChainId(chainId);
+                         }
+                 }
+                 return chain;
+         }
+         /**
+          * Adds an unused effect instance to the end of a send effect chain.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @param chainId The numerical ID of the send effect chain.
+          * @param fxInstanceId The numerical ID of the effect instance to add.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If invalid index is specified.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #addSendEffectChain
+          * @see #createEffectInstance
+          */
+         public synchronized void
+         appendEffectInstance(int audioDeviceId, int chainId, int fxInstanceId)
+                         throws IOException, LSException, LscpException
+         {
+                 String s = " " + audioDeviceId + " " + chainId + " " + fxInstanceId;
+                 retrieveIndex("APPEND SEND_EFFECT_CHAIN EFFECT" + s);
+         }
+         /**
+          * Adds an unused effect instance at a certain position of a send effect chain.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @param chainId The numerical ID of the send effect chain.
+          * @param pos The exact position in the effect chain where
+          * the supplied effect shall be inserted to.
+          * @param fxInstanceId The numerical ID of the effect instance to insert.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If invalid index is specified.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #addSendEffectChain
+          * @see #createEffectInstance
+          */
+         public synchronized void
+         insertEffectInstance(int audioDeviceId, int chainId, int pos, int fxInstanceId)
+                         throws IOException, LSException, LscpException
+         {
+                 String s = " " + audioDeviceId + " " + chainId + " " + pos + " " + fxInstanceId;
+                 retrieveIndex("INSERT SEND_EFFECT_CHAIN EFFECT" + s);
+         }
+         /**
+          * Removes an effect instance from a certain position of a send effect chain.
+          * @param audioDeviceId The numerical ID of the audio output device.
+          * @param chainId The numerical ID of the send effect chain.
+          * @param pos The exact position of the effect
+          * instance to be removed from the effect chain.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If invalid index is specified.
+          * @see #appendEffectInstance
+          * @see #insertEffectInstance
+          */
+         public synchronized void
+         removeEffectInstanceFromChain(int audioDeviceId, int chainId, int pos)
+                         throws IOException, LSException, LscpException
+         {
+                 String s = " " + audioDeviceId + " " + chainId + " " + pos;
+                 retrieveIndex("REMOVE SEND_EFFECT_CHAIN EFFECT" + s);
+         }
+         /**
+          * Starts an instrument editor for editing the loaded instrument
+          * on the specified sampler channel.
+          * @param samplerChn The sampler channel number.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If <code>samplerChn</code> is not a valid channel number or if
+          * there is no instrument loaded on the specified sampler channel.
+          * @see #getSamplerChannels
+          */
+         public synchronized void
+         editChannelInstrument(int samplerChn) throws IOException, LscpException, LSException
+         { retrieveIndex("EDIT CHANNEL INSTRUMENT " + samplerChn); }
+         /**
+          * Sends a MIDI event to this sampler channel.
+          * @param samplerChn The sampler channel number.
+          * @param type The type of MIDI message to send.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If <code>samplerChn</code> is not a valid channel number or if
+          * there is no instrument loaded on the specified sampler channel.
+          * @see #getSamplerChannels
+          */
+         public synchronized void
+         sendChannelMidiData(int samplerChn, MidiDataEvent.Type type, int arg1, int arg2)
+                                                 throws IOException, LscpException, LSException
+         {
+                 StringBuffer sb = new StringBuffer();
+                 sb.append("SEND CHANNEL MIDI_DATA ");
+                 sb.append(type).append(" ").append(samplerChn).append(" ");
+                 sb.append(arg1).append(" ").append(arg2);
+                 retrieveIndex(sb.toString());
          }
          /**
-Line 3579 
 public class Client {
+Line 4568 
 public class Client {
           * @see #getSamplerChannels
           */
          public synchronized void
-         resetChannel(int samplerChn) throws IOException, LscpException, LSException {
+         resetChannel(int samplerChn) throws IOException, LscpException, LSException
+         { retrieveIndex("RESET CHANNEL " + samplerChn); }
+         /**
+          * Adds the specified directory to the instruments database.
+          * @param dir The absolute (escaped) path name of the directory to add.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the creation of the directory failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         addDbDirectory(String dir) throws IOException, LSException, LscpException
+         { retrieveIndex("ADD DB_INSTRUMENT_DIRECTORY '" + conv(dir) + "'"); }
+         /**
+          * Removes the specified directory from the instruments database.
+          * @param dir The absolute (escaped) path name of the directory to remove.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified directory is not
+          * empty or if the removal of the directory failed.
+          */
+         public synchronized void
+         removeDbDirectory(String dir) throws IOException, LscpException, LSException
+         { removeDbDirectory(dir, false); }
+         /**
+          * Removes the specified directory from the instruments database.
+          * @param dir The absolute path name of the directory to remove.
+          * @param force If <code>true</code> forces the removal of non-empty
+          * directory and all its content.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the removing of the directory failed.
+          */
+         public synchronized void
+         removeDbDirectory(String dir, boolean force)
+                                 throws IOException, LscpException, LSException
+         {
+                 String s = "REMOVE DB_INSTRUMENT_DIRECTORY ";
+                 if(force) s += "FORCE ";
+                 retrieveIndex(s + "'" + conv(dir) + "'");
+         }
+         /**
+          * Removes the specified directories from the instruments database.
+          * @param dirs The absolute (escaped) path names of the directories to remove.
+          * @param force If <code>true</code> forces the removal of non-empty
+          * directories.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the removing of the directores failed.
+          */
+         public synchronized void
+         removeDbDirectories(String[] dirs, boolean force)
+                                 throws IOException, LscpException, LSException {
                  verifyConnection();
-                 out.writeLine("RESET CHANNEL " + samplerChn);
+                 String cmd = "REMOVE DB_INSTRUMENT_DIRECTORY ";
+                 if(force) cmd += "FORCE ";
+                 for(String s : dirs) out.writeLine(cmd + "'" + conv(s) + "'");
                  if(getPrintOnlyMode()) return;
-                 ResultSet rs = getEmptyResultSet();
+                 getEmptyResultSets(dirs.length, "Client.dirDeletionFailed!");
+         }
+         /**
+          * Gets the number of directories in the specified directory.
+          * @return The current number of directories in the specified directory.
+          * @param dir The absolute path name of the directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int
+         getDbDirectoryCount(String dir) throws IOException, LscpException, LSException {
+                 return getDbDirectoryCount(dir, false);
+         }
+         /**
+          * Gets the number of directories in the specified directory.
+          * @return The current number of directories in the specified directory.
+          * @param dir The absolute path name of the directory.
+          * @param recursive If <code>true</code>, the number of all directories
+          * in the specified subtree will be returned.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int
+         getDbDirectoryCount(String dir, boolean recursive)
+                                 throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 String s;
+                 if(recursive) s = "GET DB_INSTRUMENT_DIRECTORIES RECURSIVE '";
+                 else s = "GET DB_INSTRUMENT_DIRECTORIES '";
+                 out.writeLine(s + conv(dir) + "'");
+                 if(getPrintOnlyMode()) return -1;
+                 s = getSingleLineResultSet().getResult();
+                 return parseInt(s);
+         }
+         /**
+          * Gets the list of directories in the specified directory.
+          * @param dir The absolute path name of the directory.
+          * @return A <code>String</code> array providing the names of
+          * all directories in the specified directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified path name is invalid.
+          */
+         public synchronized String[]
+         getDbDirectoryNames(String dir) throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 out.writeLine("LIST DB_INSTRUMENT_DIRECTORIES '" + conv(dir) + "'");
+                 if(getPrintOnlyMode()) return null;
+                 String[] names = parseEscapedStringList(getSingleLineResultSet().getResult());
+                 for(int i = 0; i < names.length; i++) {
+                         names[i] = toNonEscapedString(names[i]);
+                 }
+                 return names;
+         }
+         /**
+          * Gets information about the specified directory.
+          * @param dir The absolute path name of the directory.
+          * @return A <code>DbDirectoryInfo</code> instance providing information
+          * about the specified directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified directory is not found.
+          */
+         public synchronized DbDirectoryInfo
+         getDbDirectoryInfo(String dir) throws IOException, LscpException, LSException {
+                 DbDirectoryInfo info = new DbDirectoryInfo();
+                 if(!retrieveInfo("GET DB_INSTRUMENT_DIRECTORY INFO '" + conv(dir) + "'", info)) return null;
+                 if(dir.equals("/")) {
+                         info.setName("/");
+                 } else {
+                         dir = removeEndingFileSeparator(dir);
+                 }
+                 String s = getFileName(dir);
+                 if(s != null) info.setName(toNonEscapedFileName(s));
+                 s = getParentDirectory(dir);
+                 if(s != null) info.setParentDirectoryPath(s);
+                 return info;
+         }
+         /**
+          * Gets the list of directories in the specified directory.
+          * @param dir The absolute path name of the directory.
+          * @return A <code>DbDirectoryInfo</code> array providing
+          * information about all directories in the specified directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified path name is invalid.
+          */
+         public synchronized DbDirectoryInfo[]
+         getDbDirectories(String dir) throws IOException, LscpException, LSException {
+                 String[] dirS = getDbDirectoryNames(dir);
+                 if(!hasEndingFileSeparator(dir)) dir += "/";
+                 DbDirectoryInfo[] infoS = new DbDirectoryInfo[dirS.length];
+                 for(int i = 0; i < dirS.length; i++) {
+                         infoS[i] = getDbDirectoryInfo(conv(dir) + toEscapedFsEntry(dirS[i]));
+                 }
+                 return infoS;
+         }
+         /**
+          * Gets the list of directories in the specified directory.
+          * @param dir The absolute path name of the directory.
+          * @return A <code>DbDirectoryInfo</code> array providing
+          * information about all directories in the specified directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified path name is invalid.
+          *
+         public synchronized DbDirectoryInfo[]
+         getDbDirectories(String dir) throws IOException, LscpException, LSException {
+                 String[] dirS = getDbDirectoryNames(conv(dir));
+                 if(dirS.length == 0) return new DbDirectoryInfo[0];
+                 if(dir.charAt(dir.length() - 1) != '/') dir += "/"; // FIXME:
+                 for(int i = 0; i < dirS.length; i++) {
+                         out.writeLine("GET DB_INSTRUMENT_DIRECTORY INFO '" + conv(dir + dirS[i]) + "'");
+                 }
+                 if(getPrintOnlyMode()) return null;
+                 if(dir.length() > 1) dir = dir.substring(0, dir.length() - 1);
+                 StringBuffer sb = new StringBuffer();
+                 DbDirectoryInfo[] infoS = new DbDirectoryInfo[dirS.length];
+                 for(int i = 0; i < dirS.length; i++) {
+                         try {
+                                 ResultSet rs = getMultiLineResultSet();
+                                 infoS[i] = new DbDirectoryInfo(rs.getMultiLineResult());
+                                 infoS[i].setName(dirS[i]);
+                                 infoS[i].setParentDirectoryPath(dir);
+                         } catch (SocketTimeoutException e) {
+                                 getLogger().log(Level.FINE, e.getMessage(), e);
+                                 sb.append(e.getMessage()).append("\n");
+                                 break;
+                         } catch (Exception e) {
+                                 getLogger().log(Level.FINE, e.getMessage(), e);
+                                 sb.append(e.getMessage()).append("\n");
+                         }
+                 }
+                 String details = sb.toString();
+                 if(details.length() > 0) {
+                         String err = LscpI18n.getLogMsg("Client.getInstrsInfoFailed!");
+                         throw new LSException(0, err, details);
+                 }
+                 return infoS;
+         }*/
+         /**
+          * Renames the specified directory.
+          * @param dir The absolute path name of the directory to rename.
+          * @param name The new name for the directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the renaming of the directory failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         renameDbDirectory(String dir, String name) throws IOException, LSException, LscpException {
+                 name = toEscapedText(name);
+                 retrieveIndex("SET DB_INSTRUMENT_DIRECTORY NAME '" + conv(dir) + "' '" + conv(name) + "'");
+         }
+         /**
+          * Moves the specified directory into the specified location.
+          * @param dir The absolute path name of the directory to move.
+          * @param dst The location where the directory will be moved to.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         moveDbDirectory(String dir, String dst) throws IOException, LSException, LscpException
+         { retrieveIndex("MOVE DB_INSTRUMENT_DIRECTORY '" + conv(dir) + "' '" + conv(dst) + "'"); }
+         /**
+          * Moves the specified directories into the specified location.
+          * @param dirs The absolute path names of the directories to move.
+          * @param dst The location where the directories will be moved to.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         moveDbDirectories(String dirs[], String dst) throws IOException, LSException, LscpException {
+                 verifyConnection();
+                 for(String s : dirs) {
+                         out.writeLine("MOVE DB_INSTRUMENT_DIRECTORY '" + conv(s) + "' '" + conv(dst) + "'");
+                 }
+                 if(getPrintOnlyMode()) return;
+                 getEmptyResultSets(dirs.length, "Client.dirMovingFailed!");
+         }
+         /**
+          * Copies the specified directory into the specified location.
+          * @param dir The absolute path name of the directory to copy.
+          * @param dst The location where the directory will be copied to.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         copyDbDirectory(String dir, String dst) throws IOException, LSException, LscpException
+         { retrieveIndex("COPY DB_INSTRUMENT_DIRECTORY '" + conv(dir) + "' '" + conv(dst) + "'"); }
+         /**
+          * Copies the specified directories into the specified location.
+          * @param dirs The absolute path names of the directories to copy.
+          * @param dst The location where the directories will be copied to.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         copyDbDirectories(String[] dirs, String dst) throws IOException, LSException, LscpException {
+                 verifyConnection();
+                 for(String s : dirs) {
+                         out.writeLine("COPY DB_INSTRUMENT_DIRECTORY '" + conv(s) + "' '" + conv(dst) + "'");
+                 }
+                 if(getPrintOnlyMode()) return;
+                 getEmptyResultSets(dirs.length, "Client.dirCopyingFailed!");
+         }
+         /**
+          * Changes the description of the specified directory.
+          * @param dir The absolute path name of the directory.
+          * @param desc The new description for the directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If failed to change the description.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         setDbDirectoryDescription(String dir, String desc)
+                                 throws IOException, LSException, LscpException
+         {
+                 String s = "SET DB_INSTRUMENT_DIRECTORY DESCRIPTION '";
+                 retrieveIndex(s + conv(dir) + "' '" + toEscapedText(desc) + "'");
+         }
+         public static enum ScanMode {
+                 RECURSIVE, NON_RECURSIVE, FLAT
+         }
+         /**
+          * Adds the specified instrument to the specified instruments database directory.
+          * @param dbDir The absolute path name of the database directory in which the
+          * specified instrument will be added.
+          * @param filePath The absolute path name of the instrument file.
+          * @param instrIndex The index of the instrument (in the given instrument file) to add.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         addDbInstrument(String dbDir, String filePath, int instrIndex)
+                                         throws IOException, LSException, LscpException {
+                 addDbInstrument(dbDir, filePath, instrIndex, false);
+         }
+         /**
+          * Adds the specified instrument to the specified instruments database directory.
+          * @param dbDir The absolute path name of the database directory in which the
+          * specified instrument will be added.
+          * @param filePath The absolute path name of the instrument file.
+          * @param instrIndex The index of the instrument (in the given instrument file) to add.
+          * @param background If <code>true</code>, the scan will be done
+          * in background and this method may return before the job is finished.
+          * @return If <code>background</code> is <code>true</code>, the ID
+          * of the scan job.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #addInstrumentsDbListener
+          */
+         public synchronized int
+         addDbInstrument(String dbDir, String filePath, int instrIndex, boolean background)
+                                         throws IOException, LSException, LscpException
+         {
+                 String s = "ADD DB_INSTRUMENTS";
+                 if(background) s += " NON_MODAL";
+                 s += " '" + conv(dbDir) + "' '" + conv(filePath) + "' ";
+                 return retrieveIndex(s + String.valueOf(instrIndex));
+         }
+         /**
+          * Adds the instruments in the specified file to the specified
+          * instruments database directory.
+          * @param dbDir The absolute path name of the database directory
+          * in which the the supported instruments will be added.
+          * @param filePath The absolute path name of the file to scan for instruments.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         addDbInstruments(String dbDir, String filePath)
+                                         throws IOException, LSException, LscpException {
+                 addDbInstruments(dbDir, filePath, false);
+         }
+         /**
+          * Adds the instruments in the specified file to the specified
+          * instruments database directory.
+          * @param dbDir The absolute path name of the database directory
+          * in which the the supported instruments will be added.
+          * @param filePath The absolute path name of the file to scan for instruments.
+          * @param background If <code>true</code>, the scan will be done
+          * in background and this method may return before the job is finished.
+          * @return If <code>background</code> is <code>true</code>, the ID
+          * of the scan job.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #addInstrumentsDbListener
+          */
+         public synchronized int
+         addDbInstruments(String dbDir, String filePath, boolean background)
+                                         throws IOException, LSException, LscpException
+         {
+                 String s = "ADD DB_INSTRUMENTS";
+                 if(background) s += " NON_MODAL";
+                 return retrieveIndex(s + " '" + conv(dbDir) + "' '" + conv(filePath) + "'");
+         }
+         /**
+          * Adds the instruments in the specified file system directory
+          * to the specified instruments database directory.
+          * @param mode Determines the scanning mode. If RECURSIVE is
+          * specified, all supported instruments in the specified file system
+          * direcotry will be added to the specified instruments database
+          * directory, including the instruments in subdirectories
+          * of the supplied directory. If NON_RECURSIVE is specified,
+          * the instruments in the subdirectories will not be processed.
+          * If FLAT is specified, all supported instruments in the specified
+          * file system direcotry will be added, including the instruments in
+          * subdirectories of the supplied directory, but the respective
+          * subdirectory structure will not be recreated in the instruments
+          * database and all instruments will be added directly in the
+          * specified database directory.
+          * @param dbDir The absolute path name of the database directory
+          * in which the supported instruments will be added.
+          * @param fsDir The absolute path name of the file system directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         addDbInstruments(ScanMode mode, String dbDir, String fsDir)
+                                         throws IOException, LSException, LscpException {
+                 addDbInstruments(mode, dbDir, fsDir, false);
+         }
+         /**
+          * Adds the instruments in the specified file system directory
+          * to the specified instruments database directory.
+          * @param mode Determines the scanning mode. If RECURSIVE is
+          * specified, all supported instruments in the specified file system
+          * direcotry will be added to the specified instruments database
+          * directory, including the instruments in subdirectories
+          * of the supplied directory. If NON_RECURSIVE is specified,
+          * the instruments in the subdirectories will not be processed.
+          * If FLAT is specified, all supported instruments in the specified
+          * file system direcotry will be added, including the instruments in
+          * subdirectories of the supplied directory, but the respective
+          * subdirectory structure will not be recreated in the instruments
+          * database and all instruments will be added directly in the
+          * specified database directory.
+          * @param dbDir The absolute path name of the database directory
+          * in which the supported instruments will be added.
+          * @param fsDir The absolute path name of the file system directory.
+          * @param background If <code>true</code>, the scan will be done
+          * in background and this method may return before the job is finished.
+          * @return If <code>background</code> is <code>true</code>, the ID
+          * of the scan job.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #addInstrumentsDbListener
+          */
+         public synchronized int
+         addDbInstruments(ScanMode mode, String dbDir, String fsDir, boolean background)
+                                         throws IOException, LSException, LscpException {
+                 return addDbInstruments(mode, dbDir, fsDir, background, false);
+         }
+         /**
+          * Adds the instruments in the specified file system directory
+          * to the specified instruments database directory.
+          * @param mode Determines the scanning mode. If RECURSIVE is
+          * specified, all supported instruments in the specified file system
+          * direcotry will be added to the specified instruments database
+          * directory, including the instruments in subdirectories
+          * of the supplied directory. If NON_RECURSIVE is specified,
+          * the instruments in the subdirectories will not be processed.
+          * If FLAT is specified, all supported instruments in the specified
+          * file system direcotry will be added, including the instruments in
+          * subdirectories of the supplied directory, but the respective
+          * subdirectory structure will not be recreated in the instruments
+          * database and all instruments will be added directly in the
+          * specified database directory.
+          * @param dbDir The absolute path name of the database directory
+          * in which the supported instruments will be added.
+          * @param fsDir The absolute path name of the file system directory.
+          * @param background If <code>true</code>, the scan will be done
+          * in background and this method may return before the job is finished.
+          * @param insDir If <code>true</code> a drieectory is created for each
+          * instrument file.
+          * @return If <code>background</code> is <code>true</code>, the ID
+          * of the scan job.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @see #addInstrumentsDbListener
+          */
+         public synchronized int
+         addDbInstruments(ScanMode mode, String dbDir, String fsDir, boolean background, boolean insDir)
+                                         throws IOException, LSException, LscpException
+         {
+                 StringBuffer sb = new StringBuffer("ADD DB_INSTRUMENTS");
+                 if(background) sb.append(" NON_MODAL");
+                 switch(mode) {
+                         case RECURSIVE:
+                                 sb.append(" RECURSIVE");
+                                 break;
+                         case NON_RECURSIVE:
+                                 sb.append(" NON_RECURSIVE");
+                                 break;
+                         case FLAT:
+                                 sb.append(" FLAT");
+                                 break;
+                 }
+                 if(insDir)
+                         sb.append(" FILE_AS_DIR");
+                 sb.append(" '").append(conv(dbDir)).append("' '");
+                 sb.append(conv(fsDir)).append("'");
+                 return retrieveIndex(sb.toString());
+         }
+         /**
+          * Removes the specified instrument from the instruments database.
+          * @param instr The absolute path name of the instrument to remove.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the removing of the instrument failed.
+          */
+         public synchronized void
+         removeDbInstrument(String instr) throws IOException, LscpException, LSException
+         { retrieveIndex("REMOVE DB_INSTRUMENT '" + conv(instr) + "'"); }
+         /**
+          * Removes the specified instruments from the instruments database.
+          * @param instrs The absolute path names of the instruments to remove.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the removing of the instruments failed.
+          */
+         public synchronized void
+         removeDbInstruments(String[] instrs) throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 for(String s : instrs) {
+                         out.writeLine("REMOVE DB_INSTRUMENT '" + conv(s) + "'");
+                 }
+                 if(getPrintOnlyMode()) return;
+                 getEmptyResultSets(instrs.length, "Client.instrDeletionFailed!");
+         }
+         /**
+          * Gets the number of instruments in the specified directory.
+          * @return The current number of instruments in the specified directory.
+          * @param dir The absolute path name of the directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int
+         getDbInstrumentCount(String dir) throws IOException, LscpException, LSException {
+                 return getDbInstrumentCount(dir, false);
+         }
+         /**
+          * Gets the number of instruments in the specified directory.
+          * @return The current number of instruments in the specified directory.
+          * @param dir The absolute path name of the directory.
+          * @param recursive If <code>true</code>, the number of all instruments
+          * in the specified subtree will be returned.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int
+         getDbInstrumentCount(String dir, boolean recursive)
+                                 throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 String s;
+                 if(recursive) s = "GET DB_INSTRUMENTS RECURSIVE '";
+                 else s = "GET DB_INSTRUMENTS '";
+                 out.writeLine(s + conv(dir) + "'");
+                 if(getPrintOnlyMode()) return -1;
+                 s = getSingleLineResultSet().getResult();
+                 return parseInt(s);
+         }
+         /**
+          * Gets the list of instruments in the specified directory.
+          * @param dir The absolute path name of the directory.
+          * @return A <code>String</code> array providing the names of
+          * all instruments in the specified directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified path name is invalid.
+          */
+         public synchronized String[]
+         getDbInstrumentNames(String dir) throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 out.writeLine("LIST DB_INSTRUMENTS '" + conv(dir) + "'");
+                 if(getPrintOnlyMode()) return null;
+                 String[] names = parseEscapedStringList(getSingleLineResultSet().getResult());
+                 for(int i = 0; i < names.length; i++) {
+                         names[i] = toNonEscapedString(names[i]);
+                 }
+                 return names;
+         }
+         /**
+          * Gets information about the specified instrument.
+          * @param instr The absolute path name of the instrument.
+          * @return A <code>DbInstrumentInfo</code> instance providing information
+          * about the specified instrument.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified instrument is not found.
+          */
+         public synchronized DbInstrumentInfo
+         getDbInstrumentInfo(String instr) throws IOException, LscpException, LSException {
+                 DbInstrumentInfo info = new DbInstrumentInfo();
+                 if(!retrieveInfo("GET DB_INSTRUMENT INFO '" + conv(instr) + "'", info)) return null;
+                 String s = getParentDirectory(instr);
+                 if(s != null) info.setDirectoryPath(s);
+                 s = getFileName(instr);
+                 if(s != null) info.setName(toNonEscapedFileName(s));
+                 return info;
+         }
+         /**
+          * Gets the list of instruments in the specified directory.
+          * @param dir The absolute path name of the directory.
+          * @return A <code>DbInstrumentInfo</code> array providing
+          * information about all instruments in the specified directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified path name is invalid.
+          */
+         public synchronized DbInstrumentInfo[]
+         getDbInstruments(String dir) throws IOException, LscpException, LSException {
+                 String[] instrS = getDbInstrumentNames(dir);
+                 if(!hasEndingFileSeparator(dir)) dir += "/";
+                 DbInstrumentInfo[] infoS = new DbInstrumentInfo[instrS.length];
+                 for(int i = 0; i < instrS.length; i++) {
+                         infoS[i] = getDbInstrumentInfo(conv(dir) + toEscapedFsEntry(instrS[i]));
+                 }
+                 return infoS;
+         }
+         /**
+          * Gets the list of instruments in the specified directory.
+          * @param dir The absolute path name of the directory.
+          * @return A <code>DbInstrumentInfo</code> array providing
+          * information about all instruments in the specified directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified path name is invalid.
+          *
+         public synchronized DbInstrumentInfo[]
+         getDbInstruments(String dir) throws IOException, LscpException, LSException {
+                 String[] instrS = getDbInstrumentNames(dir);
+                 if(instrS.length == 0) return new DbInstrumentInfo[0];
+                 if(dir.charAt(dir.length() - 1) != '/') dir += "/"; FIXME:
+                 for(int i = 0; i < instrS.length; i++) {
+                         out.writeLine("GET DB_INSTRUMENT INFO '" + conv(dir) + instrS[i] + "'");
+                 }
+                 if(getPrintOnlyMode()) return null;
+                 if(dir.length() > 1) dir = dir.substring(0, dir.length() - 1);
+                 StringBuffer sb = new StringBuffer();
+                 DbInstrumentInfo[] infoS = new DbInstrumentInfo[instrS.length];
+                 for(int i = 0; i < instrS.length; i++) {
+                         try {
+                                 ResultSet rs = getMultiLineResultSet();
+                                 infoS[i] = new DbInstrumentInfo(rs.getMultiLineResult());
+                                 infoS[i].setName(instrS[i]);
+                                 infoS[i].setDirectoryPath(dir);
+                         } catch (SocketTimeoutException e) {
+                                 getLogger().log(Level.FINE, e.getMessage(), e);
+                                 sb.append(e.getMessage()).append("\n");
+                                 break;
+                         } catch (Exception e) {
+                                 getLogger().log(Level.FINE, e.getMessage(), e);
+                                 sb.append(e.getMessage()).append("\n");
+                         }
+                 }
+                 String details = sb.toString();
+                 if(details.length() > 0) {
+                         String err = LscpI18n.getLogMsg("Client.getInstrsInfoFailed!");
+                         throw new LSException(0, err, details);
+                 }
+                 return infoS;
+         }*/
+         /**
+          * Renames the specified instrument.
+          * @param instr The absolute path name of the instrument to rename.
+          * @param name The new name for the instrument.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the renaming of the instrument failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         renameDbInstrument(String instr, String name)
+                                 throws IOException, LSException, LscpException
+         {
+                 name = toEscapedText(name);
+                 retrieveIndex("SET DB_INSTRUMENT NAME '" + conv(instr) + "' '" + conv(name) + "'");
+         }
+         /**
+          * Moves the specified instrument into the specified location.
+          * @param instr The absolute path name of the instrument to move.
+          * @param dst The directory where the specified instrument will be moved to.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         moveDbInstrument(String instr, String dst) throws IOException, LSException, LscpException
+         { retrieveIndex("MOVE DB_INSTRUMENT '" + conv(instr) + "' '" + conv(dst) + "'"); }
+         /**
+          * Moves the specified instruments into the specified location.
+          * @param instrs The absolute path names of the instruments to move.
+          * @param dst The directory where the specified instruments will be moved to.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         moveDbInstruments(String[] instrs, String dst) throws IOException, LSException, LscpException {
+                 verifyConnection();
+                 for(String s : instrs) {
+                         out.writeLine("MOVE DB_INSTRUMENT '" + conv(s) + "' '" + conv(dst) + "'");
+                 }
+                 if(getPrintOnlyMode()) return;
+                 getEmptyResultSets(instrs.length, "Client.instrMovingFailed!");
+         }
+         /**
+          * Copies the specified instrument into the specified location.
+          * @param instr The absolute path name of the instrument to copy.
+          * @param dst The directory where the specified instrument will be copied to.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         copyDbInstrument(String instr, String dst) throws IOException, LSException, LscpException
+         { retrieveIndex("COPY DB_INSTRUMENT '" + conv(instr) + "' '" + conv(dst) + "'"); }
+         /**
+          * Copies the specified instruments into the specified location.
+          * @param instrs The absolute path name of the instruments to copy.
+          * @param dst The directory where the specified instruments will be copied to.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         copyDbInstruments(String[] instrs, String dst) throws IOException, LSException, LscpException {
+                 verifyConnection();
+                 for(String s : instrs) {
+                         out.writeLine("COPY DB_INSTRUMENT '" + conv(s) + "' '" + conv(dst) + "'");
+                 }
+                 if(getPrintOnlyMode()) return;
+                 getEmptyResultSets(instrs.length, "Client.instrCopyingFailed!");
+         }
+         /**
+          * Changes the description of the specified instrument.
+          * @param instr The absolute path name of the instrument.
+          * @param desc The new description for the instrument.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If failed to change the description.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         setDbInstrumentDescription(String instr, String desc)
+                                 throws IOException, LSException, LscpException
+         {
+                 desc = toEscapedText(desc);
+                 retrieveIndex("SET DB_INSTRUMENT DESCRIPTION '" + conv(instr) + "' '" + desc + "'");
+         }
+         /**
+          * Substitutes all occurrences of the instrument file
+          * <code>oldPath</code> in the database, with <code>newPath</code>.
+          * @param oldPath The absolute path name of the instrument file to substitute.
+          * @param newPath The new absolute path name.
+          * @throws IOException If some I/O error occurs.
+          * @throws LSException If the operation failed.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         public synchronized void
+         setDbInstrumentFilePath(String oldPath, String newPath)
+                                 throws IOException, LSException, LscpException
+         { retrieveIndex("SET DB_INSTRUMENT FILE_PATH '" + conv(oldPath) + "' '" + conv(newPath) + "'"); }
+         /**
+          * Finds all directories in the specified directory
+          * that corresponds to the specified search criterias.
+          * @param dir The absolute path name of the directory to search.
+          * @param query Provides the search criterias.
+          * @return A <code>DbDirectoryInfo</code> array providing
+          * information about all directories that are found in the specified directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified path name is invalid.
+          */
+         public synchronized DbDirectoryInfo[]
+         findDbDirectories(String dir, DbSearchQuery query)
+                                 throws IOException, LscpException, LSException {
+                 return findDbDirectories(dir, query, false);
          }
          /**
+          * Finds all directories in the specified directory
+          * that corresponds to the specified search criterias.
+          * @param dir The absolute path name of the directory to search.
+          * @param query Provides the search criterias.
+          * @param nonRecursive If <code>true</code>, the search will be non-recursive.
+          * @return A <code>DbDirectoryInfo</code> array providing
+          * information about all directories that are found in the specified directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified path name is invalid.
+          */
+         public synchronized DbDirectoryInfo[]
+         findDbDirectories(String dir, DbSearchQuery query, boolean nonRecursive)
+                                 throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 StringBuffer sb = new StringBuffer();
+                 sb.append("FIND DB_INSTRUMENT_DIRECTORIES");
+                 if(nonRecursive) sb.append(" NON_RECURSIVE");
+                 sb.append(" '").append(conv(dir)).append("'");
+                 if(query.name != null && query.name.length() > 0) {
+                         sb.append(" NAME='").append(toEscapedText(query.name)).append("'");
+                 }
+                 String s = query.getCreatedAfter();
+                 String s2 = query.getCreatedBefore();
+                 if(s != null || s2 != null) {
+                         sb.append(" CREATED='");
+                         if(s != null) sb.append(s);
+                         sb.append("..");
+                         if(s2 != null) sb.append(s2);
+                         sb.append("'");
+                 }
+                 s = query.getModifiedAfter();
+                 s2 = query.getModifiedBefore();
+                 if(s != null || s2 != null) {
+                         sb.append(" MODIFIED='");
+                         if(s != null) sb.append(s);
+                         sb.append("..");
+                         if(s2 != null) sb.append(s2);
+                         sb.append("'");
+                 }
+                 if(query.description != null && query.description.length() > 0) {
+                         sb.append(" DESCRIPTION='");
+                         sb.append(toEscapedText(query.description)).append("'");
+                 }
+                 out.writeLine(sb.toString());
+                 if(getPrintOnlyMode()) return null;
+                 String[] dirS = parseEscapedStringList(getSingleLineResultSet().getResult());
+                 DbDirectoryInfo[] infoS = new DbDirectoryInfo[dirS.length];
+                 for(int i = 0; i < dirS.length; i++) {
+                         infoS[i] = getDbDirectoryInfo(dirS[i]);
+                 }
+                 return infoS;
+         }
+         /**
+          * Finds all instruments in the specified directory
+          * that corresponds to the specified search criterias.
+          * @param dir The absolute path name of the directory to search.
+          * @param query Provides the search criterias.
+          * @return A <code>DbInstrumentInfo</code> array providing
+          * information about all instruments that are found in the specified directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified path name is invalid.
+          */
+         public synchronized DbInstrumentInfo[]
+         findDbInstruments(String dir, DbSearchQuery query)
+                                 throws IOException, LscpException, LSException {
+                 return findDbInstruments(dir, query, false);
+         }
+         /**
+          * Finds all instruments in the specified directory
+          * that corresponds to the specified search criterias.
+          * @param dir The absolute path name of the directory to search.
+          * @param query Provides the search criterias.
+          * @param nonRecursive If <code>true</code>, the search will be non-recursive.
+          * @return A <code>DbInstrumentInfo</code> array providing
+          * information about all instruments that are found in the specified directory.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified path name is invalid.
+          */
+         public synchronized DbInstrumentInfo[]
+         findDbInstruments(String dir, DbSearchQuery query, boolean nonRecursive)
+                                 throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 StringBuffer sb = new StringBuffer();
+                 sb.append("FIND DB_INSTRUMENTS");
+                 if(nonRecursive) sb.append(" NON_RECURSIVE");
+                 sb.append(" '").append(conv(dir)).append("'");
+                 if(query.name != null && query.name.length() > 0) {
+                         sb.append(" NAME='").append(toEscapedText(query.name)).append("'");
+                 }
+                 if(query.formatFamilies.size() > 0) {
+                         sb.append(" FORMAT_FAMILIES='").append(query.formatFamilies.get(0));
+                         for(int i = 1; i < query.formatFamilies.size(); i++) {
+                                 sb.append(',').append(query.formatFamilies.get(i));
+                         }
+                         sb.append("'");
+                 }
+                 if(query.minSize != -1 || query.maxSize != -1) {
+                         sb.append(" SIZE='");
+                         if(query.minSize != -1) sb.append(query.minSize);
+                         sb.append("..");
+                         if(query.maxSize != -1) sb.append(query.maxSize);
+                         sb.append("'");
+                 }
+                 String s = query.getCreatedAfter();
+                 String s2 = query.getCreatedBefore();
+                 if(s != null || s2 != null) {
+                         sb.append(" CREATED='");
+                         if(s != null) sb.append(s);
+                         sb.append("..");
+                         if(s2 != null) sb.append(s2);
+                         sb.append("'");
+                 }
+                 s = query.getModifiedAfter();
+                 s2 = query.getModifiedBefore();
+                 if(s != null || s2 != null) {
+                         sb.append(" MODIFIED='");
+                         if(s != null) sb.append(s);
+                         sb.append("..");
+                         if(s2 != null) sb.append(s2);
+                         sb.append("'");
+                 }
+                 if(query.description != null && query.description.length() > 0) {
+                         sb.append(" DESCRIPTION='");
+                         sb.append(toEscapedText(query.description)).append("'");
+                 }
+                 if(query.instrumentType != DbSearchQuery.InstrumentType.BOTH) {
+                         sb.append(" IS_DRUM=");
+                         if(query.instrumentType == DbSearchQuery.InstrumentType.DRUM) {
+                                 sb.append("'true'");
+                         } else {
+                                 sb.append("'false'");
+                         }
+                 }
+                 if(query.product != null && query.product.length() > 0) {
+                         sb.append(" PRODUCT='").append(toEscapedText(query.product)).append("'");
+                 }
+                 if(query.artists != null && query.artists.length() > 0) {
+                         sb.append(" ARTISTS='").append(toEscapedText(query.artists)).append("'");
+                 }
+                 if(query.keywords != null && query.keywords.length() > 0) {
+                         sb.append(" KEYWORDS='");
+                         sb.append(toEscapedText(query.keywords)).append("'");
+                 }
+                 out.writeLine(sb.toString());
+                 if(getPrintOnlyMode()) return null;
+                 String[] instrS = parseEscapedStringList(getSingleLineResultSet().getResult());
+                 DbInstrumentInfo[] infoS = new DbInstrumentInfo[instrS.length];
+                 for(int i = 0; i < instrS.length; i++) {
+                         infoS[i] = getDbInstrumentInfo(instrS[i]);
+                 }
+                 return infoS;
+         }
+         /**
+          * Returns a list of all instrument files in the database
+          * that that don't exist in the filesystem.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If other error occurs.
+          */
+         public synchronized String[]
+         findLostDbInstrumentFiles() throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 out.writeLine("FIND LOST DB_INSTRUMENT_FILES");
+                 if(getPrintOnlyMode()) return null;
+                 return parseEscapedStringList(getSingleLineResultSet().getResult());
+         }
+         /**
+          * Gets status information about the specified job.
+          * @param jobId The ID of the job.
+          * @return A <code>ScanJobInfo</code> instance providing information
+          * about the specified job.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified job is not found.
+          */
+         public synchronized ScanJobInfo
+         getDbInstrumentsJobInfo(int jobId) throws IOException, LscpException, LSException {
+                 ScanJobInfo info = new ScanJobInfo();
+                 if(!retrieveInfo("GET DB_INSTRUMENTS_JOB INFO " + String.valueOf(jobId), info)) return null;
+                 return info;
+         }
+         /**
+          * Removes all instruments and directories and re-creates
+          * the instruments database structure.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the formatting of the instruments database failed.
+          */
+         public synchronized void
+         formatInstrumentsDb() throws IOException, LscpException, LSException
+         { retrieveIndex("FORMAT INSTRUMENTS_DB"); }
+         /**
           * Resets the whole sampler.
           *
           * @throws IOException If some I/O error occurs.
-Line 3604 
 public class Client {
+Line 5644 
 public class Client {
          }
          /**
+          * Gets the current number of all active streams.
+          * @return The current number of all active streams or -1 if in "print only" mode.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int
+         getTotalStreamCount() throws IOException, LscpException, LSException {
+                 return retrieveInt("GET TOTAL_STREAM_COUNT");
+         }
+         /**
           * Gets the current number of all active voices.
-          * @return The current number of all active voices.
+          * @return The current number of all active voices or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getTotalVoiceCount() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET TOTAL_VOICE_COUNT");
-                 out.writeLine("GET TOTAL_VOICE_COUNT");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
           * Gets the maximum number of active voices.
-          * @return The maximum number of active voices.
+          * @return The maximum number of active voices or -1 if in "print only" mode.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
           */
          public synchronized int
          getTotalVoiceCountMax() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 return retrieveInt("GET TOTAL_VOICE_COUNT_MAX");
-                 out.writeLine("GET TOTAL_VOICE_COUNT_MAX");
-                 if(getPrintOnlyMode()) return -1;
-                 String s = getSingleLineResultSet().getResult();
-                 return parseInt(s);
          }
          /**
-Line 3649 
 public class Client {
+Line 5691 
 public class Client {
           */
          public synchronized ServerInfo
          getServerInfo() throws IOException, LscpException, LSException {
-                 verifyConnection();
+                 ServerInfo info = new ServerInfo();
-                 out.writeLine("GET SERVER INFO");
+                 if(!retrieveInfo("GET SERVER INFO", info)) return null;
-                 if(getPrintOnlyMode()) return null;
-                 ResultSet rs = getMultiLineResultSet();
+                 return info;
-                 return new ServerInfo(rs.getMultiLineResult());
          }
          /**
-          * Gets the golobal volume of the sampler.
+          * Gets the global volume of the sampler.
-          * @return The golobal volume of the sampler.
+          * @return The global volume of the sampler.
           * @throws IOException If some I/O error occurs.
           * @throws LscpException If LSCP protocol corruption occurs.
           * @throws LSException If some other error occurs.
-Line 3683 
 public class Client {
+Line 5723 
 public class Client {
           * @see #getVolume
           */
          public synchronized void
-         setVolume(float volume) throws IOException, LscpException, LSException {
+         setVolume(float volume) throws IOException, LscpException, LSException
+         { retrieveIndex("SET VOLUME " + volume); }
-                 verifyConnection();
+         /**
-                 out.writeLine("SET VOLUME " + volume);
+          * Gets the global sampler-wide limit of maximum voices.
-                 if(getPrintOnlyMode()) return;
+          * @return The global sampler-wide limit of maximum voices or -1 if in "print only" mode.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int
+         getGlobalVoiceLimit() throws IOException, LscpException, LSException {
+                 return retrieveInt("GET VOICES");
+         }
+         /**
+          * Sets the global sampler-wide limit of maximum voices.
+          * @param maxVoices The new global limit of maximum voices.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          * @see #getVolume
+          */
+         public synchronized void
+         setGlobalVoiceLimit(int maxVoices) throws IOException, LscpException, LSException
+         { retrieveIndex("SET VOICES " + maxVoices); }
+         /**
+          * Gets the global sampler-wide limit of maximum disk streams.
+          * @return The global sampler-wide limit of maximum disk streams
+          *  or -1 if in "print only" mode.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          */
+         public synchronized int
+         getGlobalStreamLimit() throws IOException, LscpException, LSException {
+                 return retrieveInt("GET STREAMS");
+         }
+         /**
+          * Sets the global sampler-wide limit for maximum disk streams.
+          * @param maxVoices The new global limit of maximum disk streams.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If some other error occurs.
+          * @see #getVolume
+          */
+         public synchronized void
+         setGlobalStreamLimit(int maxStreams) throws IOException, LscpException, LSException
+         { retrieveIndex("SET STREAMS " + maxStreams); }
+         /**
+          * Gets the number of instruments in the specified instrument file.
+          * @param filename The absolute path name of the instrument file.
+          * @return The number of instruments in the specified instrument file
+          *  or -1 if in "print only" mode.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the file is not found, or other error occur.
+          */
+         public synchronized int
+         getFileInstrumentCount(String filename) throws IOException, LscpException, LSException {
+                 return retrieveInt("GET FILE INSTRUMENTS '" + conv(filename) +"'");
+         }
+         /**
+          * Gets information about the instrument with index
+          * <code>instrIdx</code> in the specified instrument file.
+          * @param filename The absolute path name of the instrument file.
+          * @param instrIdx The index of the instrument in the specified instrument file.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If failed to retrieve information.
+          */
+         public synchronized Instrument
+         getFileInstrumentInfo(String filename, int instrIdx)
+                                 throws IOException, LscpException, LSException {
+                 FileInstrument instr = new FileInstrument();
+                 String cmd = "GET FILE INSTRUMENT INFO '" + conv(filename) + "' " + String.valueOf(instrIdx);
+                 if(!retrieveInfo(cmd, instr)) return null;
-                 ResultSet rs = getEmptyResultSet();
+                 return instr;
+         }
+         /**
+          * Gets the list of instruments in the specified instrument file.
+          * @param filename The absolute path name of the instrument file.
+          * @return An <code>Instrument</code> array providing
+          * information about all instruments in the specified instrument file.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          * @throws LSException If the specified file name is invalid.
+          */
+         public synchronized Instrument[]
+         getFileInstruments(String filename) throws IOException, LscpException, LSException {
+                 int l = getFileInstrumentCount(filename);
+                 if(l < 0) return null;
+                 Instrument[] instrS = new FileInstrument[l];
+                 for(int i = 0; i < instrS.length; i++) {
+                         instrS[i] = getFileInstrumentInfo(filename, i);
+                 }
+                 return instrS;
+         }
+         private static class FileInstrument extends AbstractInstrument {
+                 FileInstrument() { }
+                 public String
+                 getEngine() {
+                         // TODO: engine lookup?
+                         return getFormatFamily();
+                 }
+                 @Override
+                 public boolean
+                 parse(String s) throws LscpException {
+                         if(s.startsWith("PRODUCT: ") || s.startsWith("ARTISTS: ")) return true;
+                         return super.parse(s);
+                 }
+         }
+         private void
+         getEmptyResultSets(int count, String err) throws LSException {
+                 StringBuffer sb = new StringBuffer();
+                 for(int i = 0; i < count; i++) {
+                         try { getEmptyResultSet(); }
+                         catch (SocketTimeoutException e) {
+                                 getLogger().log(Level.FINE, e.getMessage(), e);
+                                 sb.append(e.getMessage()).append("\n");
+                                 break;
+                         } catch (Exception e) {
+                                 getLogger().log(Level.FINE, e.getMessage(), e);
+                                 sb.append(e.getMessage()).append("\n");
+                         }
+                 }
+                 String details = sb.toString();
+                 if(details.length() > 0) {
+                         String s = LscpI18n.getLogMsg(err);
+                         throw new LSException(0, s, details);
+                 }
+         }
+         /**
+          * Retrieves a list of integers.
+          * @throws IOException If some I/O error occurs.
+          * @throws LscpException If LSCP protocol corruption occurs.
+          */
+         private Integer[]
+         getIntegerList(String lscpCmd) throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 out.writeLine(lscpCmd);
+                 if(getPrintOnlyMode()) return null;
+                 return parseIntList(getSingleLineResultSet().getResult());
+         }
+         private boolean
+         retrieveInfo(String lscpCmd, Parseable p) throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 out.writeLine(lscpCmd);
+                 if(getPrintOnlyMode()) return false;
+                 ResultSet rs = getMultiLineResultSet();
+                 for(String s : rs.getMultiLineResult()) {
+                         if(!p.parse(s)) Client.getLogger().info(LscpI18n.getLogMsg("unknownLine", s));
+                 }
+                 return true;
+         }
+         private int
+         retrieveInt(String lscpCmd) throws IOException, LscpException, LSException {
+                 verifyConnection();
+                 out.writeLine(lscpCmd);
+                 if(getPrintOnlyMode()) return -1;
+                 String s = getSingleLineResultSet().getResult();
+                 return parseInt(s);
+         }
+         private int
+         retrieveIndex(String lscpCmd) throws IOException, LSException, LscpException {
+                 verifyConnection();
+                 out.writeLine(lscpCmd);
+                 if(getPrintOnlyMode()) return -1;
+                 return getEmptyResultSet().getIndex();
          }
          /**

 Legend:



Removed from v.1139
 


changed lines


 
Added in v.2190
 Legend:



Removed from v.1139
 


changed lines


 
Added in v.2190
-Removed from v.1139
+Added in v.2190

	ViewVC Help
Powered by ViewVC