home *** CD-ROM | disk | FTP | other *** search
/ Java Developer's Companion / Java Developer's Companion.iso / binaries / Windows / JavaIDL-EA-win32.EXE / JavaIDL / README < prev   
Encoding:
Text File  |  1997-03-20  |  10.0 KB  |  280 lines
  1. Java(TM) IDL 1.1 Early Access Release README
  2. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  3.  
  4. Welcome to the Java IDL 1.1 Early Access release. Thank you for 
  5. your interest in this product and for taking the time to download 
  6. the software and documentation.
  7.  
  8. This Early Access release of Java IDL is a preliminary release 
  9. conforming to the proposed OMG Java IDL Specification. This
  10. specification is expected to be approved by the OMG in the near
  11. future. 
  12.  
  13. When using the JavaIDL 1.1 EA release, it is important to remember:
  14.     - This release is not intended for production level
  15.       development. 
  16.     - This release does not imply a commitment for any future
  17.       product releases or any future product release dates.
  18.     - This release does not imply any particular packaging or
  19.       release mechanism if JavaIDL is released in the future.
  20.  
  21. Included in this release are two examples, Hello World and Portfolio
  22. Manager. They can be found in the examples directory.
  23.  
  24. This README file contains information about:
  25.     Java IDL System Requirements
  26.     Java IDL Installation Guide
  27.     Java IDL Bug Report containing descriptions of known
  28.     problems in this release 
  29.  
  30. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  31.  
  32. Java IDL System Requirements
  33. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  34. SPARC/Solaris Platform
  35.     Solaris 2.3 or higher
  36.     JDK 1.0.2 or higher
  37.     To run Java IDL applets, one of:
  38.         HotJava 1.0 or higher
  39.         Netscape Navigator 3.0 or higher
  40.  
  41. Microsoft Win32 Platforms
  42.     Windows NT 3.5.1 or higher, or Windows 95
  43.     JDK 1.0.2 or higher
  44.     Visual C++ 4.0 or higher
  45.     To run Java IDL applets, one of:
  46.         HotJava 1.0 or higher
  47.         Netscape Navigator 3.0 or higher
  48.         Microsoft Internet Explorer 3.0 or higher
  49.  
  50. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  51.  
  52. Java IDL Installation Guide
  53. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  54. 1. These instructions assume that: 
  55.  
  56.    - You have successfully downloaded Java IDL from the website. 
  57.    - If you are using the Solaris version, you have untarred the files. 
  58.    - If you are using the NT/Windows 95 version, you have 
  59.      executed JavaIDL.exe.
  60.    - You have a JavaIDL installation directory, created by untarring 
  61.      or running JavaIDL.exe.  
  62.  
  63. Read these instructions carefully before beginning the installation. 
  64. Be sure you know the location of the Java interpreter, the
  65. Java CLASSPATH, and the location of your JavaIDL installation directory.
  66.  
  67. 2. Go to the "bin" directory of the "JavaIDL" directory:
  68.  
  69.    % cd JavaIDL
  70.    % cd bin
  71.  
  72. 3. Have the Java interpreter run the class installJavaIDL and answer
  73.    the installation questions. Examples are given in step 4. 
  74.  
  75.    The installJavaIDL program will ask for:
  76.    - the location of the Java interpreter (i.e., the full path to the
  77.      executable program),
  78.    - the Java CLASSPATH to be used, and
  79.    - the location of the JavaIDL installation. 
  80.  
  81.    The installJavaIDL program will then create a startup script for
  82.    the COS Name Server implementation (called "nameserv" for Solaris
  83.    and "nameserv.bat" for Windows). The script will reside in the
  84.    "bin" directory of the JavaIDL installation, and can be used to
  85.    start the Name Server.
  86.    
  87. 4. Installation Examples:
  88.  
  89.    The following installation scenarios assume that:  
  90.    -the Java interpreter can be found by searching the PATH 
  91.      (the actual name of the Java interpreter may vary, so 
  92.      substitute the real name for "java" where used below) 
  93.    - the CLASSPATH includes "." (the current directory). 
  94.  
  95.    In the scenarios below, the cursor is shown as _ (underscore), 
  96.    comments are shown indented and in parentheses.
  97.  
  98.    4.1 Solaris:
  99.  
  100.    For the example scenario, we are assuming that JDK is installed
  101.    under "/opt/java", and that JavaIDL has been unpacked as
  102.    "/opt/JavaIDL".
  103.  
  104.    % java installJavaIDL
  105.  
  106.    Welcome to the Installation of JavaIDL for Solaris.
  107.    Enter full path to Java interpreter executable
  108.     (JDK 1.0.2 or higher): _
  109.  
  110.         (Type the full path to the Java Interpreter executable,
  111.     e.g. "/opt/java/bin/java" and finish with RETURN. The full path
  112.     must exist as a file, otherwise the installJavaIDL program
  113.     will print out an error message and ask again for the full
  114.     path.)
  115.  
  116.         (The installJavaIDL program will then attempt to guess a
  117.     suitable CLASSPATH, based on the location of the Java
  118.     Interpreter. If it can, it will display its guess in brackets
  119.     [], and just hitting RETURN will select the guess.)
  120.  
  121.    Enter full Java classpath [/opt/java/lib/classes.zip]: _
  122.  
  123.         (If the suggested classpath is correct, just hit
  124.     RETURN. Otherwise, type in the correct CLASSPATH, which can be
  125.     multiple PATHs separated by ':',  and finish with RETURN.)
  126.  
  127.     (The installJavaIDL program will then attempt to guess the location
  128.     of the JavaIDL installation. If it can, it will display its
  129.     guess in brackets [], and just hitting RETURN will select the
  130.     guess.)
  131.  
  132.    Enter JavaIdl Path [/opt/JavaIDL]: _
  133.  
  134.         (If the suggested location is correct, just hit
  135.     RETURN. Otherwise, type in the correct location of JavaIDL,
  136.     and finish with RETURN. The installJavaIDL program then
  137.     verifies the entered location; if it is not correct the
  138.     program will prompt again for the correct location of the
  139.     JavaIDL installation.)
  140.  
  141.     (The installJavaIDL program then prints    out the selected paths
  142.     to be used when generating the script for the Name Server.) 
  143.  
  144.    Using:
  145.    Java Interpreter: /opt/java/bin/java
  146.    Java Classpath: /opt/java/lib/classes.zip
  147.    JavaIDL Path: /opt/JavaIDL
  148.  
  149.    Generating script...
  150.  
  151.    Installation for Solaris complete.
  152.  
  153.    The script "/opt/JavaIDL/bin/nameserv" can be used to start the COS Name Server.
  154.  
  155.         (The installJavaIDL program indicates that the installation is
  156.     complete, and prints out the name of the script that can be
  157.     used to start the Name Server, in this case
  158.     "/opt/JavaIDL/bin/nameserv").
  159.  
  160. ********
  161. NOTE: There are two issues to keep in mind when running nameserv:
  162.     1. On Solaris, you must be root to run nameserv since it
  163.     uses port 900 as the initial port by default. If this is
  164.         not acceptable, a portnumber greater than 1023 must be
  165.         specified (see note 2).
  166.         2. When starting the Name Server, if the default port is
  167.         not acceptable, a different initial port number can be
  168.     given with:
  169.         nameserv -ORBInitialPort <port number>
  170.     
  171.    4.2 Windows NT:   
  172.  
  173.    This example scenario assumes that JDK is installed
  174.    under "c:\jdk", and that JavaIDL has been unpacked as
  175.    "c:\JavaIDL".
  176.  
  177.    > java installJavaIDL
  178.  
  179.    Welcome to the Installation of JavaIDL for Windows NT.
  180.  
  181.    Enter full path to Java interpreter executable
  182.     (JDK 1.0.2 or higher): _
  183.  
  184.         (Type the full path to the Java Interpreter executable,
  185.     e.g. "c:\jdk\bin\java" and finish with RETURN. The full path
  186.     must exist as a file, or as a file with ".exe" or ".bat"
  187.     appended to the name, otherwise the installJavaIDL program
  188.     will print out an error message and ask again for the full
  189.     path.)
  190.  
  191.         (The installJavaIDL program will then attempt to guess a
  192.     suitable CLASSPATH, based on the location of the Java
  193.     Interpreter. If it can, it will display its guess in brackets
  194.     [], and just hitting RETURN will select the guess.)
  195.  
  196.    Enter full Java classpath [c:\jdk\lib\classes.zip]: _
  197.  
  198.         (If the suggested classpath is correct, just hit
  199.     RETURN. Otherwise, type in the correct CLASSPATH, which can be
  200.     multiple PATHs separated by ';',  and finish with RETURN.)
  201.  
  202.     (The installJavaIDL program will then attempt to guess the location
  203.     of the JavaIDL installation. If it can, it will display its
  204.     guess in brackets [], and just hitting RETURN will select the
  205.     guess.)
  206.  
  207.    Enter JavaIdl Path [c:\JavaIDL]: _
  208.  
  209.         (If the suggested location is correct, just hit
  210.     RETURN. Otherwise, type in the correct location of JavaIDL,
  211.     and finish with RETURN. The installJavaIDL program then
  212.     verifies the entered location; if it is not correct the
  213.     program will prompt again for the correct location of the
  214.     JavaIDL installation.
  215.  
  216.     (The installJavaIDL program then prints    out the selected paths
  217.     to be used when generating the script for the Name Server.) 
  218.  
  219.    Using:
  220.    Java Interpreter: c:\jdk\bin\java
  221.    Java Classpath: c:\jdk\lib\classes.zip
  222.    JavaIDL Path: c:\JavaIDL
  223.  
  224.    Generating script...
  225.  
  226.    Installation for Windows NT complete.
  227.  
  228.    The script "c:\JavaIDL\bin\nameserv" can be used to start the COS Name Server.
  229.  
  230.         (The installJavaIDL program indicates that the installation is
  231.     complete, and prints out the name of the script that can be
  232.     used to start the Name Server, in this case
  233.     "c:\JavaIDL\bin\nameserv").
  234.  
  235.  
  236. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  237.  
  238. Java IDL Bug Report
  239. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  240. The following is a list of known bugs/limitations in the JavaIDL EA
  241. release.
  242.  
  243.   o The IDL to Java compiler does not handle declarations nested inside IDL 
  244.     structs, unions and exceptions. However, declarations can be nested
  245.     inside IDL interfaces.
  246.     
  247.   o #pragma ID, and #pragma version are not supported; #pragma prefix 
  248.     can appear only at the global scope. 
  249.  
  250.   o IDL module reopening is not supported by the IDL compiler.
  251.  
  252.   o Of the recently added type extensions to IDL, only longlong (signed and 
  253.     unsigned) is supported.
  254.  
  255.   o Multiple DII Request operations like send_multiple_requests_deferred,
  256.     send_multiple_requests_oneway, poll_next_response, get_next_response
  257.     are not supported.
  258.  
  259.   o DSI is not supported as it is under discussion as part of the ORB
  260.     Enhanced Portability RFP.
  261.   
  262.   o Unions inside Any and Unions with boolean discriminators are not 
  263.     supported.
  264.  
  265.   o Recursive typecodes are not supported.
  266.  
  267.   o The Principal pseudo object has attribute "identity" instead of "name".
  268.  
  269.   o The "_request(String s)" operation on org.omg.CORBA.Object for DII
  270.      support is missing.
  271.  
  272.   o The add_in_arg(), add_out_arg() and add_inout_arg() operations on
  273.      org.omg.CORBA.Request that take a string argument should be called
  274.      add_named_in_arg(), add_named_out_arg() and add_named_inout_arg().
  275.  
  276.   o  methods "except()" and "except(Exception e)" on
  277.      org.omg.CORBA.Environment should both be called "exception" instead
  278.      of "except"
  279.  
  280.