IMS Connector for Java   

------------------------------------------------------------------------- 

  Licensed Materials - Property of IBM

  IBM Confidential

  OCO Source Materials

             5655-K52

  (C) Copyright IBM Corp.   1998, 2004   All Rights Reserved. 

  US Government Users Restricted Rights - Use, duplication  
  or disclosure restricted by GSA ADP Schedule Contract  
  with IBM Corp.

------------------------------------------------------------------------- 

These files, available for download, allow you to install the
English and National Language versions of the runtime portion of IMS 
Connector for Java. IMS Connector for Java implements both IBM's Common 
Connector Framework Architecture (CCF) and Sun's J2EE Connector 
Architecture (J2C).  These files are for:

     IMS Connector for Java J2C packages Version 2.2.1 
     IMS Connector for Java CCF packages Version 4.0.1   

Note that IMS Connector for Java's J2C implementation is also referred          
to as the IBM WebSphere Adapter for IMS or, in general terms, as the            
IMS resource adapter.                                                           
                                                                                
Installation Instructions
-------------------------
  
The executables available for download place the files listed below 
in a target directory, for later deployment in an application server 
such as WebSphere Application Server.  To run the installation:

   a. Select the executable for the platform on which you are 
      performing the installation:

      For AIX               - select imsicosetup_aix_221 
      For HP-UX             - select imsicosetup_hpux_221
      For Linux             - select imsicosetup_linux_221
      For Linux for zSeries - select imsicosetup_linux390_221 
      For Sun Solaris       - select imsicosetup_solaris_221
      For Windows           - select imsicosetup_win_221.exe      
 
   b. Start the executable, then follow the instructions 
      in the installation wizard.

Successful completion of the installation places the following files
in directories /IBM/IMSICO/J2C and /IBM/IMSICO/CCF of a target directory of  
your choice (<target_dir>), or the default target directory.  The  
default target directory is c:\Program Files for Windows platforms. 
<lang_dir> represents language specific directories for countries for 
which translations are available.  

  <target_dir>/IBM/IMSICO/J2C/README    - Information about the files   
                                          in directory J2C.   
       
  <target_dir>/IBM/IMSICO/J2C/imsico.rar- Resource Adapter Archive file 
                                          for IMS Connector for Java (J2C). 
                                          See the section "Deploying IMS 
                                          Connector for Java's RAR File" in
                                          <target_dir>/IMSICO/J2C/README for 
                                          instructions on deploying this RAR  
                                          file in WebSphere Application Server. 

  <target_dir>/IBM/IMSICO/J2C/<lang_dir>/HowTo.html
                                        - Information about IMS Connector
                                          for Java.
    
  <target_dir>/IBM/IMSICO/J2C/<lang_dir>/IMSICOIVP.html
                                        - Information about the IVP.

  <target_dir>/IBM/IMSICO/J2C/IVP/IMSICOIVP.ear 
                                        - The Enterprise Application Archive 
                                          file for IMS Connector for Java's 
                                          Installation Verification Program 
                                          (IVP).  This IVP verifies the 
                                          deployment of IMS Connector for Java 
                                          in WebSphere Application Server.  

  <target_dir>/IBM/IMSICO/CCF/README    - Information about the files in 
                                          directory CCF.
  
  <target_dir>/IBM/IMSICO/CCF/imsconn.jar   
					- Java Archive file for IMS Connector
                                          for Java (CCF)

Deployment Instructions
-----------------------

See the README files in the IBM/IMSICO/J2C and IBM/IMSICO/CCF folders of the target 
installation directory for deployment instructions.

Uninstalling IMS Connector for Java  
----------------------------------- 

If you wish to uninstall IMS Connector for Java you have two choices:

	1. Remove the IMSICO folder from the target directory (<target_dir>), 
        
           - or -

	2. Use the uninstall.jar program provided in 
		<target_dir>/IBM/IMSICO/_uninst_IMSICO.
           This method requires that the java command be accessible; i.e., 
           JRE/JDK installed and classpath set appropriately.  For example:  	  	  

	   a. From a command prompt, change to <target_dir>\IBM\IMSICO
           b. Enter the command:

		java -jar _uninst_IMSICO\uninstall.jar

It is important to note that the above uninstall removes the IMS Connector
for Java files from the target directory, but DOES NOT remove IMS Connector
for Java from WebSphere Application Server if it has already been deployed to 
the application server.  See the WebSphere Application Server documentation 
for instructions on removing a resource adapter. 
		    
Late-breaking News
------------------

For late-breaking news about IMS Connector for Java, access the IMS             
Connector for Java Web site by going to the IMS home page at                    
www.ibm.com/ims and selecting "IMS Connector for Java".