lpjsubmit.1

     NAME
          lpjsubmit - Submit parallel SLURM/LoadLeveler job for LPJmL
          simulations

     SYNOPSIS
          lpjsubmit [-class c] [-group g] [-wtime time] [-blocking n]
          [-o output] [-e error] [-q] [-nocheck] ntasks [args ...]

     DESCRIPTION
          Script creates SLURM/LoadLeveler job control file job.jcf
          and submits the job to the LoadLeveler queue via llsubmit or
          to SLURM via sbatch for the LPJmL simulation program. Before
          submitting syntax of configuration file is checked by
          calling the lpjcheck program. Can only be used for the MPI
          version of lpjml.

     OPTIONS
          -class c
               set the SLURM/LoadLeveler class to which the job will
               be submitted. Default class is 'short'. Valid classes
               can be obtained by the llclass command.

          -group g
               set the SLURM/LoadLeveler group. Valid groups are
               user-specific and set in the /home/loadl/LoadL_admin
               file.

          -wtime time
               set wall clock limit of LoadLeveler job. time must be
               in the format hh:mm:ss.

          -blocking n
               set blocking (number of tasks per node) for parallel
               job to n. Default is unlimited.

          -o output
               set filename of output file, default is
               lpjml.$(cluster).out.

          -e error
               set filename of error file, default is
               lpjml.$(cluster).err.


          -q   only error messages are displayed, other output is
               suppressed.

          -nocheck
               does not check input files and output directories.

          ntasks
               set the number of parallel MPI tasks.

          args set command line arguments for the lpjml program.

     EXAMPLE
     file with a wall clock limit of 1h:
          Submit job with 32 parallel MPI tasks starting from a restart
               lpjsubmit -wtime 1:00:00 32 -DFROM_RESTART

     ENVIRONMENT
          LPJROOT
               defines the root directory for LPJmL. The variable has
               to be defined before calling lpjsubmit. This is usually
               done by the lpj_paths.sh script.


     EXIT STATUS
          lpjsubmit returns a zero exit status if job has been
          submitted.  Non zero is returned in case of failure.


     AUTHORS
          For authors and contributors see AUTHORS file


     COPYRIGHT
          (C) Potsdam Institute for Climate Impact Research (PIK), see
          COPYRIGHT file


     SEE ALSO
          lpjml(1), lpjcheck(1), lpj_paths.sh(1), lpjml.conf(5)