doc/advanced.rst

   1 Advanced part
   2 =============
   3
   4 This chapter is a melting pot of information about what the JOBMANAGER do.
   5
   6 Logs files
   7 ++++++++++
   8
   9 Whatever the type of job, the JOBMANAGER provides many files for logging
  10 what happens during the job. These files are located in the work directory
  11 of the job in a directory named **logs**.
  12
  13 For **command** type of job, one log file is created. This file contains the normal
  14 and error output of the job. The file name contains the type of job and the date, e.g.
  15 **command_Thu_Sep_30_15_04_51_2010.log**.
  16
  17 For **SALOME** type of job, two log files are created. The common file contains the
  18 normal and error output of the SALOME services. The file name is like this:
  19 **salome_Wed_Feb_10_13_54_00_2010.log**. The other file depends of the type of SALOME jobs:
  20
  21 - For **Python** type of job, the file contains all the output of the scripts. The file name is
  22   like this: **python_Wed_Feb_10_13_54_00_2010.log**.
  23 - For **YACS** type of job, the file contains all the output of the schema. The file name is
  24   like this: **yacs_Wed_Feb_10_13_54_00_2010.log**.
  25
  26 For jobs that are launched in a batch resource like PBS or LSF, two more files are provided
  27 that contains the normal and error output messages of the PBS or LSF job. These files are like this:
  28 **error.log.runCommand_test_command_Wed_Sep__8_17_02_44_2010** and
  29 **output.log.runCommand_test_command_Wed_Sep__8_17_02_44_2010**
  30
  31 How the JOBMANAGER launch the job
  32 +++++++++++++++++++++++++++++++++
  33
  34 For each type of job, the JOBMANAGER creates a shell that permits to launch in the resource
  35 the job file. It's in this file that the environment file is used. For a command job,
  36 the file name is like this: **runCommand_test_command_Wed_Sep__8_16_59_08_2010.sh**.
  37
  38 If a job has to be launched in a resource with a batch manager like PBS or LSF an another
  39 file is created that contains batch directives. For a command job, the file name is like
  40 this: **runCommand_test_command_Wed_Sep__8_16_59_08_2010_Batch.sh**.
  41
  42
  43 Current limitations
  44 +++++++++++++++++++
  45
  46 Currently, for SALOME type of jobs, the scope of the environment file is
  47 restricted to the main SALOME session. Distributed containers launched in remote
  48 computers are not in the scope of the environment file. If you want to give an environment file to all
  49 your containers, use a SALOME application and copy this environment file into the **env.d**
  50 directory.
  51
  52 Currently, logs files do not contain remote containers outputs.