MESHJOB.idl

Go to the documentation of this file.

// Copyright (C) 2011-2026  CEA, EDF
//
// 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 (at your option) 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
//
// See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
//
 
// Authors : Guillaume Boulant (EDF) - 31/01/2011
 
#ifndef _MESHJOB_IDL_
#define _MESHJOB_IDL_
 
#include "SALOME_Exception.idl"
#include "SALOME_Component.idl"
 
//
// This interface is used for mesh job submission from within the
// SALOME plugin for PADDER.
//
module MESHJOB
{
 
  //
  // Structure to transmit the parameters required for the job to run
  // the executable program on the target resource. See configure
  // service.
  //
  struct ConfigParameter {
    string resname; // The name of the SALOME resource to be used
    string binpath; // The path of the executable program on this resource
    string envpath; // The path of the environment file on this resource
  };
 
  //
  // This set of specification defines the data structure used to
  // initialize a job on a specific resource, then supervise the job
  // and finally retrieve the result data.
  //
 
  // This defines the set of temporary folders used by the jobmanager
  // when executing a job (may depend on the job).
  struct MeshJobPaths
  {
    string local_inputdir;
    string local_resultdir;
    string remote_workdir;
  };
 
  // This defines the possible types for a job parameter
  enum FileType {MED_CONCRETE, MED_STEELBAR};
 
  // This defines a single parameter for the job initialization (a med file)
  struct MeshJobFile
  {
    string file_name;
    FileType file_type;
    string group_name;
  };
  
  // This defines a set of parameters for the job initialization
  typedef sequence<MESHJOB::MeshJobFile> MeshJobFileList;
 
  // This defines a single parameter for the job initialization
  struct MeshJobParameter
  {
    string name;
    string value;
  };
  
  // This defines a set of parameters for the job initialization
  typedef sequence<MESHJOB::MeshJobParameter> MeshJobParameterList;
 
  // This defines the result data of a job 
  struct MeshJobResults
  {
    string results_dirname;
    string outputmesh_filename;
    boolean status;
  };
 
  // This defines the possible states of a job
  enum MeshJobState {CREATED, IN_PROCESS, QUEUED, RUNNING, PAUSED, FINISHED, ERROR};
 
  //
  // This interface defines the computation services of the component
  //
 
  interface MeshJobManager: Engines::EngineComponent
  {
 
    boolean configure(in string configId, in MESHJOB::ConfigParameter configParameter)
      raises (SALOME::SALOME_Exception);
 
    long    initialize(in MESHJOB::MeshJobFileList meshJobFileList,
                       in MESHJOB::MeshJobParameterList MeshJobParameterList,
                       in string configId)
      raises (SALOME::SALOME_Exception);
 
    boolean start(in long jobId)
      raises (SALOME::SALOME_Exception);
 
    string getState(in long jobId)
      raises (SALOME::SALOME_Exception);
 
    MeshJobResults finalize(in long jobid)
      raises (SALOME::SALOME_Exception);
 
    boolean clean(in long jobId)
      raises (SALOME::SALOME_Exception);
 
    MeshJobPaths getPaths(in long jobId)
      raises (SALOME::SALOME_Exception);
 
    string getLastErrorMessage();
  };
 
};
 
#endif // _MESHJOB_IDL_