/**
 * JASMINe
 * Copyright (C) 2008 Bull S.A.S.
 * Contact: jasmine@ow2.org
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307
 * USA
 *
 * --------------------------------------------------------------------------
 * $Id: IJMXConnectionServer.java 1398 2008-06-10 14:28:31Z renaultgu $
 * --------------------------------------------------------------------------
 */

Find here a ResourceAdapter providing a pool of JMX connections. The lookup on the JNDI server will
give you a factory, on wich you can get JMX Connections. On these connection, you'll be able to release
it (free in the pool, but not physically closed) or close (physically closed and free in the pool).

Two main steps to use this RA:
    - A generic RA (the one which is compiled) has to be deployed. The JNDI name is JMXConnectionRA.
    - generate a new RA using generate-ra.sh which will be specific to one jmx url to monitor.
        The jndi name will have to be this way : the jmx url where all ':' and '/' are replaced by
        '_' .
            example :

            if you want to deploy a jmx connection pool for the following url

                service:jmx:rmi:///jndi/rmi://localhost:1099/jrmpconnector_jonas

            the jndi name of the RA will have to be

                service_jmx_rmi____jndi_rmi___localhost_1099_jrmpconnector_jonas

        This is this specific RA just generated which will be really use. If only the "main" RA is
        deployed, it's as if none was.

To use the script generate-ra.sh which is in fact a wrapper of the RAConfig script, you may look at
the help of the script. However, here is an example of how to use it :

            example to generate a new RA :

     ./generate-ra.sh -j service_jmx_rmi____jndi_rmi___localhost_1099_jrmpconnector_jonas -o JMXConnectionRA_1 -d

WARNING : if the JOnAS version is 4.8.6, 4.9.2, 5.0.3 or older, use the '-l' option of the script to enable the 
legacy mode

