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

Submit job with 32 parallel MPI tasks starting from a restart file with a wall clock limit of 1h:
    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)