# 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. Default group is
                   'bios-x'. 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.

         AUTHOR
              Werner von Bloh (Werner.von.Bloh@pik-potsdam.de)

         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)