Search

link to homepage

Institute for Advanced Simulation (IAS)

Navigation and service


Job File Keywords

Blue Gene Specific Keywords

keyword meaning possible values default
#@job_type Specifies the type of job step to process. Must be set to bluegene.serial
parallel
bluegene
MPICH
serial
#@bg_size Size of the Blue Gene job in number of compute nodes to be used. <integer> 32
#@bg_shape Specifies the requested shape of a Blue Gene job.
The max. shape on JUGENE is 9x4x4.
<X>x<Y>x<Z>No default value is set
#@bg_rotate Specifies whether the scheduler should consider all possible rotations of the given shape of the job when searching for a partition for the job.TRUE
FALSE
TRUE
#@bg_connection Type of wiring requested for the partition.TORUS
MESH
PREFER_TORUS
MESH
#@bg_partition Name of a predefined partition the job should run on. This keyword is not usable on JUGENE.<partition name> -

#@

bg_requirements

Requirement a base partition must meet.
This keyword is not usable on JUGENE.
--

Detailed description of the keywords.

  • # @ job_type = serial | parallel | bluegene | MPICH

Specifies the type of job step to process.
Must be set bluegene otherwise a serial job on the front end is started without allocating a bluegene partition.
Default value: serial

  • # @ bg_connection = TORUS | MESH |PREFER_TORUS

Specifies the type of wiring requested for the Blue Gene partition in which the job step will run.
TORUS Specifies that the admissible partitions must be wireable as a torus.
MESH Specifies that the admissible partitions must be wireable as a mesh.
PREFER_TORUS Specifies that the admissible partitions should be wireable as a torus, but if there are no such partitions then the selected partition must be wireable as a mesh.
This keyword is only valid for job type bluegene. This keyword cannot be used if the bg_partition keyword is specified. This keyword is not inherited by other job steps.
Default value: MESH

  • # @ bg_rotate = true | false

Specifies whether the scheduler should consider all possible rotations of the given shape of the job when searching for a partition for the job.
Where true implies that the shape can be rotated to fit some free resource and false implies that the shape will not be rotated.
Assigning a value of true to this keyword will increase the likelihood of the scheduler finding a partition to run the job and optimizes overall scheduling of Blue Gene resources. bg_rotate must be set to false when using the mapfile argument of mpirun to specify how the job’s tasks are to be assigned to the allocated compute nodes. This keyword is only valid for job type bluegene. This keyword is not inherited by other job steps.
Note: This keyword can only be used in conjunction with the bg_shape job command file keyword. If bg_shape is not present, this keyword is ignored.
Default value: The default value is true.

  • # @ bg_shape = XxYxZ

Specifies the requested shape of the Blue Gene job to be started in the system.
X, Y, and Z are positive integers indicating the number of base partitions (midplanes) in the X-direction, Y-direction, and Z-direction, respectively, of the requested job shape. The values of X, Y, and Z or their rotations, ifbg_rotate is true, must not be greater than the corresponding X, Y, and Z sizes of the Blue Gene system, otherwise the job will never be able to start. This keyword is only valid for job type bluegene. This keyword can not be used if the bg_partition or bg_size keyword is specified. This keyword is not inherited by other job steps.
Note: The X, Y, and Z dimensions of the allocated partition will be exactly as defined by the bg_shape job command file keyword unless the job command file keyword bg_rotate is specified as true, in which case all possible rotations of the dimensions are possible.
Default value: No default is set.


  • # @ bg_size = bg_size

Specifies the requested size of the Blue Gene job to be started in the system.
bg_size is an integer indicating the size of the job in units of compute nodes. No guarantees are made as to the shape of the allocated partition for a given size. The only guarantee is that the size of the allocated shape will be no smaller than the requested size and as close to the request size as possible. This keyword is only valid for job type bluegene. This keyword can not be used if the bg_partition or bg_shape keyword is specified. This keyword is not inherited by other job steps.
Note: Not all values given for bg_size are representable. For example, consider an 8x4x4 Blue Gene system in units of base partitions and a requested bg_size of 5632 (equivalent to 11 base partitions). Since 11 is a prime number, it cannot be decomposed. Futhermore, it is greater than any one dimension of the system. In this case, a 3x4x1 partition is allocated, since it is the smallest number of base partitions larger than the requested size.
Default value: If bg_size, bg_shape, or bg_partition are not specified then bg_size defaults to the configured minimum partition size. This is the value of the BG_MIN_PARTITION_SIZE keyword in the configuration file.

General Keywords

keyword meaning possible values default
#@notification Specifies when the user is sent email about the job. Sends email to address specified by #@notify_user. start = start of job
complete = end of job
error = on error
always = start+complete+error
never = never
complete
#@notify_user Address for email notification. Required if #@notification is not set to never <valid-email-address> $USER@localhost
#@wall_clock_limit Limit for the elapsed time for which a job can run. HH:MM:SS 0:30:00
#@input File used for standard input <some-filename> /dev/null
#@output File used for standard output <some-filename> /dev/null
#@error File used for standard error <some-filename> /dev/null
#@initialdir Initial working directory during job execution <some-pathname> current working directory at the time job was submitted
#@environment Specifies initial environment variables set by LL when your job step starts

COPY_ALL = all variables are copied
$var = variable

var to be copied

No default value is set

Servicemeu

Homepage