Turing : Principal parameters of the runjob command

The runjob command launches an executable file in batch on Blue Gene.

The essential options are:

  • The executable file and its arguments. This information can be specified in two different ways:
    • At the end of the arguments passed to the runjob command and after the character : (colon). For example:
      runjob --np 2048 --ranks-per-node 32 : ./my_executable my_arg1 my_arg2
    • or by using the options --exe ./my_executable and --args "my_arg1 my_arg2"
  • --np NN (or -n), with NN representing the number of MPI processes requested. We advise you to consult the pages on choice of number of processes per compute node and notes on job accounting to best choose this value with understanding its consequences for the job accounting.
  • --ranks-per-node PP (or -p), with PP representing the number of MPI processes requested per compute node. The possible values are 1, 2, 4, 8, 16, 32 and 64. We advise you to consult the pages on choice of number of processes per compute node and notes on job accounting to best choose this value with understanding its consequences for the job accounting.

Useful and usual options:

  • --mapping MAPPING. Consult MPI process mapping. The default is ABCDET. The value advised is also ABCDET.
  • --envs "variables_environnement", to pass the environment variables to your application.
  • --exp-env, to export a variable from the current environment to the job.
  • --env-all, to export all the variables defined during the launching of the executable file on Blue Gene.
  • --label, to enable a prefix label on each standard output writing indicating the process rank which is writing.
  • --cwd, to change the working directory for the job, when the executable file is in a different directory than the one in which you launch the command.

To list all the possible options, with a summary explanation in English, you can type:

man runjob