1 // Copyright (C) 2007-2014 CEA/DEN, EDF R&D, OPEN CASCADE
3 // Copyright (C) 2003-2007 OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
4 // CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
6 // This library is free software; you can redistribute it and/or
7 // modify it under the terms of the GNU Lesser General Public
8 // License as published by the Free Software Foundation; either
9 // version 2.1 of the License, or (at your option) any later version.
11 // This library is distributed in the hope that it will be useful,
12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 // Lesser General Public License for more details.
16 // You should have received a copy of the GNU Lesser General Public
17 // License along with this library; if not, write to the Free Software
18 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
23 #ifndef _SALOME_LAUNCHER_IDL_
24 #define _SALOME_LAUNCHER_IDL_
26 #include "SALOME_Exception.idl"
27 #include "SALOME_ResourcesManager.idl"
29 /*! \file SALOME_Launcher.idl \brief interfaces for %SALOME Launcher service
36 typedef sequence<string> FilesList;
38 //! A generic parameter
44 //! Generic parameter list
45 typedef sequence<Engines::Parameter> ParameterList;
50 //! Job Type - Could be equal to "command" or "yacs_file" or "python_salome"
58 string work_directory;
59 string local_directory;
60 string result_directory;
62 /*! Time for the batch (has to be like this : hh:mm) - Could be empty, in
63 this case, default value of the selected resource will be used.
65 string maximum_duration;
67 // Memory is expressed in megabytes -> mem_mb
68 // Number of Processors -> nb_proc
69 ResourceParameters resource_required;
72 Name of the batch queue choosed - optional
76 //! Specifies if the job must run in exclusive mode (without sharing nodes with other jobs)
79 //! Specifies the memory limit per cpu (exclusive with resource_required.mem_mb)
80 unsigned long mem_per_cpu;
83 Specific parameters for each type of job - optional
85 Engines::ParameterList specific_parameters;
87 // Parameters for COORM
95 Engines::JobParameters job_parameters;
97 typedef sequence<Engines::JobDescription> JobsList;
99 interface SalomeLauncherObserver
101 void notify(in string event_name, in string event_data);
104 /*! \brief Interface of the %salomelauncher
105 This interface is used for interaction with the unique instance
108 interface SalomeLauncher
111 long createJob (in Engines::JobParameters job_parameters) raises (SALOME::SALOME_Exception);
112 void launchJob (in long job_id) raises (SALOME::SALOME_Exception);
113 string getJobState (in long job_id) raises (SALOME::SALOME_Exception);
114 string getAssignedHostnames (in long job_id) raises (SALOME::SALOME_Exception); // Get names or ids of hosts assigned to the job
115 void getJobResults(in long job_id, in string directory) raises (SALOME::SALOME_Exception);
116 boolean getJobDumpState(in long job_id, in string directory) raises (SALOME::SALOME_Exception);
117 void stopJob (in long job_id) raises (SALOME::SALOME_Exception);
118 void removeJob (in long job_id) raises (SALOME::SALOME_Exception);
121 long createJobWithFile(in string xmlJobFile, in string clusterName) raises (SALOME::SALOME_Exception);
122 boolean testBatch (in ResourceParameters params) raises (SALOME::SALOME_Exception);
124 // SALOME kernel service methods
128 // Observer and introspection methods
129 void addObserver(in Engines::SalomeLauncherObserver observer);
130 void removeObserver(in Engines::SalomeLauncherObserver observer);
131 Engines::JobsList getJobsList();
132 Engines::JobParameters getJobParameters(in long job_id) raises (SALOME::SALOME_Exception);
134 // Save and load methods
135 void loadJobs(in string jobs_file) raises (SALOME::SALOME_Exception);
136 void saveJobs(in string jobs_file) raises (SALOME::SALOME_Exception);