Merge from V5_1_4_BR 07/05/2010

[modules/kernel.git] / idl / SALOME_Component.idl

diff --git a/idl/SALOME_Component.idl b/idl/SALOME_Component.idl
index d12f1e1909aaff5bd03d21820c7888f66f78a32c..e91c8b0463e4604c05257dee00d91819eeed31dd 100644 (file)
--- a/idl/SALOME_Component.idl
+++ b/idl/SALOME_Component.idl
@@ -1,4 +1,4 @@
-//  Copyright (C) 2007-2008  CEA/DEN, EDF R&D, OPEN CASCADE
+//  Copyright (C) 2007-2010  CEA/DEN, EDF R&D, OPEN CASCADE

 //
 //  Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
 //  CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
 //
 //  Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
 //  CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS


@@ -19,6 +19,7 @@
 //
 //  See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
 //
 //
 //  See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
 //

+

 //  File   : SALOME_Component.idl
 //  Author : Paul RASCLE, EDF
 //  $Header: 
 //  File   : SALOME_Component.idl
 //  Author : Paul RASCLE, EDF
 //  $Header: 


@@ -28,6 +29,10 @@
 
 #include "SALOMEDS.idl"
 #include "SALOME_Exception.idl"
 
 #include "SALOMEDS.idl"
 #include "SALOME_Exception.idl"

+#include "SALOME_PyNode.idl"
+
+/*! \file SALOME_Component.idl \brief interfaces for Component and Container
+*/

 
 /*! \brief
 This is a package of interfaces used for connecting new components to %SALOME
 
 /*! \brief
 This is a package of interfaces used for connecting new components to %SALOME


@@ -42,15 +47,19 @@ module Engines
   */
   typedef sequence<octet> TMPFile;  
   
   */
   typedef sequence<octet> TMPFile;  
   

-  /*!
-    General Key Value Structure to set or get properties, for component
-  */
+  //!  General Key Value Structure to set or get properties, for component

   struct KeyValuePair
   {
     string key;
     any value;
   };
 
   struct KeyValuePair
   {
     string key;
     any value;
   };
 

+  //!  Structure data type to hold reference on data 
+  struct dataref
+  {
+    string ref;
+  };
+

   typedef sequence<KeyValuePair> FieldsDict;
 
   interface Component ;
   typedef sequence<KeyValuePair> FieldsDict;
 
   interface Component ;


@@ -66,17 +75,18 @@ module Engines
   interface Container
   {
 
   interface Container
   {
 

-    /*!
-      Loads a new component class (dynamic library).
+    /*! \brief Loads a new component class (dynamic library).
+

       \param componentName like COMPONENT, (Python or C++ implementation)
                            try to make a Python import of COMPONENT,
                            then a lib open of libCOMPONENTEngine.so
       \param componentName like COMPONENT, (Python or C++ implementation)
                            try to make a Python import of COMPONENT,
                            then a lib open of libCOMPONENTEngine.so

+      \param reason      in case of error (return false) a string explaining the error

       \return true if load successfull or already done, false otherwise
     */
       \return true if load successfull or already done, false otherwise
     */

-    boolean load_component_Library(in string componentName);
+    boolean load_component_Library(in string componentName, out string reason);

 
 

+    //! Create a new servant instance of a component.

     /*!
     /*!

-      Creates a new servant instance of a component.

       Component library must be loaded.
       \param componentName Name of the component which will be registered
                            in Registry and Name Service,
       Component library must be loaded.
       \param componentName Name of the component which will be registered
                            in Registry and Name Service,


@@ -88,8 +98,23 @@ module Engines
     Engines::Component create_component_instance(in string componentName,
                                                  in long studyId);
 
     Engines::Component create_component_instance(in string componentName,
                                                  in long studyId);
 

+    //! Create a new servant instance of a component with environment variables specified.
+    /*!
+      Component library must be loaded.
+      \param componentName Name of the component which will be registered
+                           in Registry and Name Service,
+                         (instance number suffix added to the registered name)
+      \param studyId        0 if instance is not associated to a study, 
+                            >0 otherwise (== study id)
+      \param env         a dict of env variables
+      \param reason      in case of error (return nil) a string explaining the error
+      \return a loaded component
+    */
+    Engines::Component create_component_instance_env(in string componentName,
+                                                     in long studyId, in FieldsDict env,
+                                                     out string reason);
+    //! Find a servant instance of a component

     /*!
     /*!

-      Finds a servant instance of a component

       \param registeredName  Name of the component in Registry or Name Service,
                              without instance suffix number
       \param studyId        0 if instance is not associated to a study, 
       \param registeredName  Name of the component in Registry or Name Service,
                              without instance suffix number
       \param studyId        0 if instance is not associated to a study, 


@@ -99,8 +124,8 @@ module Engines
     Component find_component_instance(in string registeredName,
                                      in long studyId);
 
     Component find_component_instance(in string registeredName,
                                      in long studyId);
 

+    //! Find a servant instance of a component, or create a new one.

     /*!
     /*!

-      Find a servant instance of a component, or create a new one.

       Loads the component library if needed.
       Only applicable to multiStudy components.
       \param nameToRegister Name of the component which will be registered
       Loads the component library if needed.
       Only applicable to multiStudy components.
       \param nameToRegister Name of the component which will be registered


@@ -112,52 +137,37 @@ module Engines
     Component load_impl(in string nameToRegister,
                        in string componentName);
 
     Component load_impl(in string nameToRegister,
                        in string componentName);
 

+    //! Remove the component servant, and deletes all related objects

     /*!
     /*!

-      Stops the component servant, and deletes all related objects

       \param component_i     Component to be removed
     */
     void remove_impl(in Component component_i);
 
       \param component_i     Component to be removed
     */
     void remove_impl(in Component component_i);
 

-    /*!
-      Discharges all components from the container.
-    */
+    //!  Unload component libraries from the container. 

     void finalize_removal() ;
 
     void finalize_removal() ;
 

-    /*!
-      Determines whether the server has been loaded or not.
-    */
+    //!  Determines whether the server has been loaded or not.

     void ping();
 
     void ping();
 

-    /*!
-      Name of the %container
-    */
+    //!  Name of the %container

     readonly attribute string name ;
 
     readonly attribute string name ;
 

-    /*!
-      working directory of the %container
-    */
+    //!  working directory of the %container

     readonly attribute string workingdir ;
 
     readonly attribute string workingdir ;
 

-    /*!
-      name of the %container log file (this has been set by the launcher)
-    */
+    //!  name of the %container log file (this has been set by the launcher)

     attribute string logfilename ;
 
     attribute string logfilename ;
 

-    /*!
-      Shutdown the Container process.
-    */
+    //!  Shutdown the Container process.

     void Shutdown();
 
     void Shutdown();
 

-    /*!
-      Returns the hostname of the container
-    */
+    //!  Returns the hostname of the container

     string getHostName();
 
     string getHostName();
 

-    /*!
-      Returns the PID of the container
-    */
+    //!  Returns the PID of the container

     long getPID();
 
     long getPID();
 

+    //! Kill the container 

     /*!
       Returns True if the %container has been killed.
       Kept for Superv compilation but can't work, unless oneway...
     /*!
       Returns True if the %container has been killed.
       Kept for Superv compilation but can't work, unless oneway...


@@ -165,6 +175,7 @@ module Engines
     */
     boolean Kill_impl() ;
 
     */
     boolean Kill_impl() ;
 

+    //! Create a fileRef

     /*!
       returns a fileRef object if origFileName exists and is readable
       else returns null object. Only one fileRef is created for a given
     /*!
       returns a fileRef object if origFileName exists and is readable
       else returns null object. Only one fileRef is created for a given


@@ -173,6 +184,7 @@ module Engines
     */
     fileRef createFileRef(in string origFileName);
 
     */
     fileRef createFileRef(in string origFileName);
 

+    //! Create a Salome_file

     /*!
       returns a Salome_file object if origFileName exists and is readable
       else returns null object. 
     /*!
       returns a Salome_file object if origFileName exists and is readable
       else returns null object. 


@@ -183,6 +195,7 @@ module Engines
     */
     Salome_file createSalome_file(in string origFileName);
 
     */
     Salome_file createSalome_file(in string origFileName);
 

+    //! Create a fileTransfer

     /*!
       returns a fileTransfer object used to copy files from the container
       machine to the clients machines. Only one fileTransfer instance is
     /*!
       returns a fileTransfer object used to copy files from the container
       machine to the clients machines. Only one fileTransfer instance is


@@ -190,6 +203,20 @@ module Engines
     */
     fileTransfer getFileTransfer();
 
     */
     fileTransfer getFileTransfer();
 

+    //! Copy a file from a remote host (container) to a local file
+    /*!
+      \param contai the remote container
+      \param remoteFile the file on the remote host to copy
+      \param localFile the local file to create by copy
+     */
+    void copyFile(in Container contai, in string remoteFile, in string localFile);
+
+    //! Create a PyNode in the container
+    /*!
+      \param nodeName the name of the PyNode
+      \param code python code as text to load in the node
+     */
+    PyNode createPyNode(in string nodeName, in string code)  raises(SALOME::SALOME_Exception);

   };
 
   /*! \brief Interface of the %component.
   };
 
   /*! \brief Interface of the %component.


@@ -198,30 +225,16 @@ module Engines
   */
   interface Component
   {
   */
   interface Component
   {

-    /*!
-      The name of the instance of the %Component
-    */
+    //!  The name of the instance of the %Component

     readonly attribute string instanceName ;
 
     readonly attribute string instanceName ;
 

-    /*!
-      The name of the interface of the %Component
-    */
+    //!  The name of the interface of the %Component

     readonly attribute string interfaceName ;
 
     readonly attribute string interfaceName ;
 

-    /*!
-      Determines whether the server has already been loaded or not.
-    */
+    //!  Determines whether the server has already been loaded or not.

     void ping();
 
     void ping();
 

-//     /*!
-//       Set study associated to component instance
-//       \param studyId
-//       (=0:  multistudy component instance,
-//        >0: study id associated to this instance
-//       \return false if already set with a different value (change not possible)
-//     */
-//     boolean setStudyId(in long studyId);
-
+    //!  Get study associated to component instance

     /*!
       get study associated to component instance
       \return -1: not initialised (Internal Error)
     /*!
       get study associated to component instance
       \return -1: not initialised (Internal Error)


@@ -230,6 +243,7 @@ module Engines
     */
     long getStudyId();
 
     */
     long getStudyId();
 

+    //! Remove component instance from container

     /*!
       Deactivates the %Component.
       -- TO BE USED BY CONTAINER ONLY (Container housekeeping) --
     /*!
       Deactivates the %Component.
       -- TO BE USED BY CONTAINER ONLY (Container housekeeping) --


@@ -237,11 +251,10 @@ module Engines
     */
     void destroy() ;
 
     */
     void destroy() ;
 

-    /*!
-      Returns the container that the %Component refers to.
-    */
+    //!  Returns the container that the %Component refers to.

     Container GetContainerRef() ;
 
     Container GetContainerRef() ;
 

+    //! Set component instance properties

     /*!
       Gives a sequence of (key=string,value=any) to the component. 
       Base class component stores the sequence in a map.
     /*!
       Gives a sequence of (key=string,value=any) to the component. 
       Base class component stores the sequence in a map.


@@ -250,12 +263,14 @@ module Engines
     */
     void setProperties(in FieldsDict dico);
 
     */
     void setProperties(in FieldsDict dico);
 

+    //! Get component instance properties

     /*!
       returns a previously stored map (key=string,value=any) as a sequence.
       See setProperties(in FieldsDict dico).
     */
     FieldsDict getProperties();
 
     /*!
       returns a previously stored map (key=string,value=any) as a sequence.
       See setProperties(in FieldsDict dico).
     */
     FieldsDict getProperties();
 

+    //! Set name of a node in a graph (for %SUPERVISOR use)

     /*!
       This method is used by the %SUPERVISOR component. It sets the names of
       the graph and of the node.
     /*!
       This method is used by the %SUPERVISOR component. It sets the names of
       the graph and of the node.


@@ -264,33 +279,39 @@ module Engines
     */
     void Names( in string aGraphName , in string aNodeName ) ;
 
     */
     void Names( in string aGraphName , in string aNodeName ) ;
 

+    //! Kill the component (if you can)

     /*!
       Returns True if the %Component has been killed.
     */
     boolean Kill_impl() ;
 
     /*!
       Returns True if the %Component has been killed.
     */
     boolean Kill_impl() ;
 

+    //! Stop the component (if you can)

     /*!
       Returns True if the activity of the %Component has been stopped.
       (It's action can't be resumed)
     */
     boolean Stop_impl() ;
 
     /*!
       Returns True if the activity of the %Component has been stopped.
       (It's action can't be resumed)
     */
     boolean Stop_impl() ;
 

+    //! Suspend the component

     /*!
       Returns True if the activity of the %Component has been suspended.
       (It's action can be resumed)
     */
     boolean Suspend_impl() ;
 
     /*!
       Returns True if the activity of the %Component has been suspended.
       (It's action can be resumed)
     */
     boolean Suspend_impl() ;
 

+    //! Resume the component

     /*!
       Returns True if the activity of the %Component has been resumed.
     */
     boolean Resume_impl() ;
 
     /*!
       Returns True if the activity of the %Component has been resumed.
     */
     boolean Resume_impl() ;
 

+    //! Get the cpu used

     /*!
     /*!

-      Returns the Cpu used (long does not run with python !...)
+      Returns the Cpu used 

     */
     long CpuUsed_impl() ;
     
     */
     long CpuUsed_impl() ;
     

+    //! Get a python dump

     /*!
       Returns a python script, which is being played back reproduces
       the data model of component
     /*!
       Returns a python script, which is being played back reproduces
       the data model of component


@@ -300,8 +321,8 @@ module Engines
                       out boolean isValidScript);
 
     
                       out boolean isValidScript);
 
     

+    //! Returns a CORBA Ref of a input Salome_file managed by a service.

     /*!
     /*!

-      Returns a CORBA Ref of a input Salome_file managed by a service.

 
       \param service_name service's name.
       \param file_name name of the requested file.
 
       \param service_name service's name.
       \param file_name name of the requested file.


@@ -314,6 +335,7 @@ module Engines
     Engines::Salome_file getInputFileToService(in string service_name, 
                                               in string Salome_file_name)       raises(SALOME::SALOME_Exception);
 
     Engines::Salome_file getInputFileToService(in string service_name, 
                                               in string Salome_file_name)       raises(SALOME::SALOME_Exception);
 

+    //! Check service input files (transfer them if needed) 

     /*!
       This method is used before the activation of the service. It calls
       recvFiles() on all the input Salome_file files of the service. 
     /*!
       This method is used before the activation of the service. It calls
       recvFiles() on all the input Salome_file files of the service. 


@@ -331,8 +353,8 @@ module Engines
     */
     void checkInputFilesToService(in string service_name)                              raises(SALOME::SALOME_Exception);
 
     */
     void checkInputFilesToService(in string service_name)                              raises(SALOME::SALOME_Exception);
 

+    //!  This method adds a input Salome_file to a service of the component.

     /*!
     /*!

-      This method adds a input Salome_file to a service of the component.

 
       \param service_name service's name.
       \param Salome_file_name name of the Salome_file
 
       \param service_name service's name.
       \param Salome_file_name name of the Salome_file


@@ -345,8 +367,8 @@ module Engines
     Engines::Salome_file setInputFileToService(in string service_name,
                                               in string Salome_file_name)      raises(SALOME::SALOME_Exception);
 
     Engines::Salome_file setInputFileToService(in string service_name,
                                               in string Salome_file_name)      raises(SALOME::SALOME_Exception);
 

+    //!  Returns a CORBA Ref of a output Salome_file managed by a service.

     /*!
     /*!

-      Returns a CORBA Ref of a output Salome_file managed by a service.

 
       \param service_name service's name.
       \param file_name name of the requested file.
 
       \param service_name service's name.
       \param file_name name of the requested file.


@@ -359,6 +381,7 @@ module Engines
     Engines::Salome_file getOutputFileToService(in string service_name, 
                                                in string Salome_file_name) raises(SALOME::SALOME_Exception);
 
     Engines::Salome_file getOutputFileToService(in string service_name, 
                                                in string Salome_file_name) raises(SALOME::SALOME_Exception);
 

+    //! Check service output files (transfer them if needed) 

     /*!
       This method is used at the end of the service. It calls
       recvFiles() on all the output Salome_file files of the service. 
     /*!
       This method is used at the end of the service. It calls
       recvFiles() on all the output Salome_file files of the service. 


@@ -376,8 +399,8 @@ module Engines
     */
     void checkOutputFilesToService(in string service_name)                      raises(SALOME::SALOME_Exception);
 
     */
     void checkOutputFilesToService(in string service_name)                      raises(SALOME::SALOME_Exception);
 

+    //!  This method adds an output Salome_file to a service of the component.

     /*!
     /*!

-      This method adds an output Salome_file to a service of the component.

 
       \param service_name service's name.
       \param Salome_file_name name of the Salome_file
 
       \param service_name service's name.
       \param Salome_file_name name of the Salome_file


@@ -389,6 +412,8 @@ module Engines
     */
     Engines::Salome_file setOutputFileToService(in string service_name,
                                                in string Salome_file_name)      raises(SALOME::SALOME_Exception);
     */
     Engines::Salome_file setOutputFileToService(in string service_name,
                                                in string Salome_file_name)      raises(SALOME::SALOME_Exception);

+
+    //! Indicate if the component instance provides custom information about its objects.

     /*!
       Returns true if the component provides custom information about its objects, false otherwise.
       Should be redefined in the certain component to return true in case of this
     /*!
       Returns true if the component provides custom information about its objects, false otherwise.
       Should be redefined in the certain component to return true in case of this


@@ -396,6 +421,7 @@ module Engines
     */
     boolean hasObjectInfo();
     
     */
     boolean hasObjectInfo();
     

+    //! Get custom information about the given object.

     /*!
       This method is used to get the custom information about the given object.
       Should be redefined in the certain component in case of this
     /*!
       This method is used to get the custom information about the given object.
       Should be redefined in the certain component in case of this


@@ -410,14 +436,7 @@ module Engines
     string getObjectInfo(in long studyId, in string entry);
   } ;
 
     string getObjectInfo(in long studyId, in string entry);
   } ;
 

-  interface Parallel_Component : Engines::Component {
-    void send_parallel_proxy_object(in Object proxy_ref);
-  };
-
-  /*!
-    A block of binary data used for file transfer. The maximum size of the
-    block is defined on server side.
-   */
+  //!  A block of binary data used for file transfer. The maximum size of the block is defined on server side.

   typedef sequence<octet> fileBlock;
 
   /*! \brief Interface of fileTransfer.
   typedef sequence<octet> fileBlock;
 
   /*! \brief Interface of fileTransfer.


@@ -426,6 +445,7 @@ module Engines
   */
   interface fileTransfer
   {
   */
   interface fileTransfer
   {

+    //! Open the file transfer

     /*!
       open method returns a key (fileId) that identifies the structure
       (ex: C FILE), associated to the original file on the server.
     /*!
       open method returns a key (fileId) that identifies the structure
       (ex: C FILE), associated to the original file on the server.


@@ -435,50 +455,65 @@ module Engines
       File.
     */
     long open(in string fileName);
       File.
     */
     long open(in string fileName);

+    //! Open the file transfer in write mode for file fileName
+    /*!
+      \param fileName the file to copy into with putBlock
+      \return the id to use with putBlock
+    */
+    long openW(in string fileName);

 
 

+    //! Close the file transfer

     /*!
     when the file transfer is finished, close method releases structures 
     created by open method, identified by fileId.
     */
     void close(in long fileId);
 
     /*!
     when the file transfer is finished, close method releases structures 
     created by open method, identified by fileId.
     */
     void close(in long fileId);
 

+    //! Get a file data block

     /*!
       Get successive blocks of octets from the original file.
       The last block is empty, and identifies the end of file.
     */
     fileBlock getBlock(in long fileId);
     /*!
       Get successive blocks of octets from the original file.
       The last block is empty, and identifies the end of file.
     */
     fileBlock getBlock(in long fileId);

+
+    //! Put a file data block
+    /*!
+       \param fileId identification of the file obtained by openW
+       \param block a data block to copy into the file identified by fileId
+    */
+    void putBlock(in long fileId, in fileBlock block);
+

   };
 
   };
 

-  /*!
-    This is a file managed by a Salome_file. It contains file's name, path and status.
-    The status is : "present" or "notpresent".
-  */
+  //!  A file managed by a Salome_file. 

   struct file {
   struct file {

+    //! file name

     string file_name;
     string file_name;

-    string path;
+    //! path name
+    string path; 

     string type;
     string source_file_name;
     string type;
     string source_file_name;

-    string status;
+    //! status ("present" or "notpresent")
+    string status; 

     long   node;
     Engines::Container container;
   };
 
     long   node;
     Engines::Container container;
   };
 

-  /*!
-    A sequence of Engines::file.
-  */
+  //!  A sequence of Engines::file.

   typedef sequence<Engines::file> files;
 
 
   typedef sequence<Engines::file> files;
 
 

-  /*!
-    It is the state of a Salome_file. It contains the Salome_file's name, the name
-    of the hdf5 file where it can be saved, the number of files managed and the information
-    if all the files are received.
-  */
+  //!  The state of a Salome_file. 

   struct SfState {
   struct SfState {

-    string  name;
-    string  hdf5_file_name;
-    long    number_of_files;
-    boolean files_ok;
+    //! file name
+    string  name; 
+    //! hdf5 file where the file can be saved
+    string  hdf5_file_name; 
+    //! number of files managed
+    long    number_of_files; 
+    //! information if all the files are received
+    boolean files_ok; 
+

   };
 
   /*! \brief Interface of a Salome_file managed
   };
 
   /*! \brief Interface of a Salome_file managed


@@ -488,8 +523,8 @@ module Engines
   */
   interface Salome_file : Engines::fileTransfer
   {
   */
   interface Salome_file : Engines::fileTransfer
   {

+    //!  Load a Salome_file from a hdf5 file.

     /*!
     /*!

-      Load a Salome_file from a hdf5 file.

 
       \param hdf5_file name (with path) of the hdf5_file.
 
 
       \param hdf5_file name (with path) of the hdf5_file.
 


@@ -497,8 +532,8 @@ module Engines
      */
     void load(in string hdf5_file)                         raises (SALOME::SALOME_Exception);
 
      */
     void load(in string hdf5_file)                         raises (SALOME::SALOME_Exception);
 

+    //!  Save a Salome_file into a hdf5_file.

     /*!
     /*!

-      Save a Salome_file into a hdf5_file.

 
       \param  hdf5_file name (with path) of the hdf5_file.
 
 
       \param  hdf5_file name (with path) of the hdf5_file.
 


@@ -507,9 +542,9 @@ module Engines
     */
     void save(in string hdf5_file)                         raises (SALOME::SALOME_Exception);
 
     */
     void save(in string hdf5_file)                         raises (SALOME::SALOME_Exception);
 

+    //!  Save a Salome_file into a hdf5_file. 

     /*!
     /*!

-      Save a Salome_file into a hdf5_file. All files that are managed
-      are saved into the hdf5_file
+      All files that are managed are saved into the hdf5_file

 
       \param  hdf5_file name (with path) of the hdf5_file.
 
 
       \param  hdf5_file name (with path) of the hdf5_file.
 


@@ -520,8 +555,8 @@ module Engines
 
 /**************/
 
 
 /**************/
 

+    //!  Add a Local file to the Salome_file.

     /*!
     /*!

-      Add a Local file to the Salome_file.

 
       \param file_name name of the file with the path.
 
 
       \param file_name name of the file with the path.
 


@@ -529,8 +564,8 @@ module Engines
     */
     void setLocalFile(in string comp_file_name) raises (SALOME::SALOME_Exception);
 
     */
     void setLocalFile(in string comp_file_name) raises (SALOME::SALOME_Exception);
 

+    //!  Add a Distributed file to the Salome_file.

     /*!
     /*!

-      Add a Distributed file to the Salome_file.

 
       \param comp_file_name name of the file with the path.
 
 
       \param comp_file_name name of the file with the path.
 


@@ -538,8 +573,8 @@ module Engines
     */
     void setDistributedFile(in string comp_file_name) raises (SALOME::SALOME_Exception);
 
     */
     void setDistributedFile(in string comp_file_name) raises (SALOME::SALOME_Exception);
 

+    //!  Connect a Salome_file with another Salome_file.

     /*!
     /*!

-      Connect a Salome_file with another Salome_file.

       It works only if the Salome_file managed only one file
 
       \param source_Salome_file Salome_file that managed the distributed version of the file.
       It works only if the Salome_file managed only one file
 
       \param source_Salome_file Salome_file that managed the distributed version of the file.


@@ -548,8 +583,8 @@ module Engines
     */
     void connect(in Engines::Salome_file source_Salome_file) raises (SALOME::SALOME_Exception);
 
     */
     void connect(in Engines::Salome_file source_Salome_file) raises (SALOME::SALOME_Exception);
 

+    //!  Connect the managed file file_name to a Salome_file.

     /*!
     /*!

-      Connect the managed file file_name to a Salome_file.

 
       \param file_name name of the file without the path.
       \param source_Salome_file Salome_file that managed the distributed version of the file.
 
       \param file_name name of the file without the path.
       \param source_Salome_file Salome_file that managed the distributed version of the file.


@@ -559,8 +594,8 @@ module Engines
     void connectDistributedFile(in string file_name,
                                in Engines::Salome_file source_Salome_file) raises (SALOME::SALOME_Exception);
     
     void connectDistributedFile(in string file_name,
                                in Engines::Salome_file source_Salome_file) raises (SALOME::SALOME_Exception);
     

+    //!  Connect the file_name with a Distributed file_name.

     /*!
     /*!

-      Connect the file_name with a Distributed file_name.

 
       \param file_name name of the file without the path.
       \param source_file_name It's the name of the file managed by the distributed source Salome_file.
 
       \param file_name name of the file without the path.
       \param source_file_name It's the name of the file managed by the distributed source Salome_file.


@@ -572,9 +607,8 @@ module Engines
 
 /**************/
 
 
 /**************/
 

+    //! Get all the distributed files managed by the Salome_file and check all the local files.

     /*!
     /*!

-      Get all the distributed files managed by the Salome_file and
-      check all the local files.

 
       \exception raised if some of the files are not ok.
     */
 
       \exception raised if some of the files are not ok.
     */


@@ -582,8 +616,8 @@ module Engines
 
 /**************/
 
 
 /**************/
 

+    //!  Remove a file of the Salome_file.

     /*!
     /*!

-      Remove a file of the Salome_file.

 
       \param file_name name of the file.
 
 
       \param file_name name of the file.
 


@@ -591,21 +625,19 @@ module Engines
     */
     void removeFile(in string file_name)                   raises (SALOME::SALOME_Exception);
 
     */
     void removeFile(in string file_name)                   raises (SALOME::SALOME_Exception);
 

-    /*!
-      Remove all the files of the Salome_file.
-    */
+    //!  Remove all the files of the Salome_file.

     void removeFiles();
 
 /**************/
 
     void removeFiles();
 
 /**************/
 

+    //! Get the list of the files managed by the Salome_file.

     /*!
     /*!

-      Get the list of the files managed by the Salome_file.

       The list can be empty.
     */
     Engines::files getFilesInfos();
 
       The list can be empty.
     */
     Engines::files getFilesInfos();
 

+    //! Get a file managed by the Salome_file.

     /*!
     /*!

-      Get a file managed by the Salome_file.

 
       \param file_name the name of the file.
 
 
       \param file_name the name of the file.
 


@@ -615,14 +647,12 @@ module Engines
     */
     Engines::file  getFileInfos(in string file_name)       raises (SALOME::SALOME_Exception);
 
     */
     Engines::file  getFileInfos(in string file_name)       raises (SALOME::SALOME_Exception);
 

-    /*!
-      Return the state of the Salome_file.
-    */
+    //!  Return the state of the Salome_file.

     Engines::SfState getSalome_fileState();
 
 
     Engines::SfState getSalome_fileState();
 
 

+    //! Set the container where files are.

     /*!
     /*!

-      Set the container where files are.

 
       \param container container CORBA's reference.
     */
 
       \param container container CORBA's reference.
     */


@@ -648,7 +678,9 @@ module Engines
   */
   interface fileRef
   {
   */
   interface fileRef
   {

+    //! the original file

     readonly attribute string origFileName;
     readonly attribute string origFileName;

+    //! the machine of the original file

     readonly attribute string refMachine;
 
     Container getContainer();
     readonly attribute string refMachine;
 
     Container getContainer();


@@ -658,50 +690,6 @@ module Engines
 
     string getRef(in string machine);
   };
 
     string getRef(in string machine);
   };

-
-  /*! \brief Interface of a Parallel_Salome_file
-    This interface is used by parallel components and containers.
-    It adds methods to enable to choose on which node of the parallel component the file has to 
-    be received.
-  */
-  interface Parallel_Salome_file : Engines::Salome_file {
-
-    /*!
-      Set a number of node for the file. Default is the node 0.
-
-      \param file_name name of the file.
-      \param node_nbr node number where the file is.
-
-      \exception raised if the file doesn't exist.
-    */
-    void setFileNode(in string file_name, in long node_nbr) raises (SALOME::SALOME_Exception);
-
-    /*!
-      Get the number of the node that actually managed the file.
-
-      \param file_name name of managed file.
-
-      \return node number of the file
-
-      \exception raised if the file doesn't exist.
-     */
-    long getFileNode(in string file_name) raises (SALOME::SALOME_Exception);
-
-    /*!
-      This method update the state of file for the Parallel_Salome_file. 
-
-      \param new_file the new state of file.
-     */
-    Engines::Container updateFile(in Engines::file new_file);
-
-    /*!
-      This method is used by the parallel implementation of recvFiles.
-
-      \exception raised if the file cannot be ok.
-     */
-    void recvFiles_node() raises (SALOME::SALOME_Exception);
-
-  };

 };
 
 #endif
 };
 
 #endif