Job File Keywords
Blue Gene Specific Keywords
|#@job_type||Specifies the type of job step to process. Must be set to bluegene.||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|
|#@bg_connection||Type of wiring requested for the partition.||TORUS|
|#@bg_partition||Name of a predefined partition the job should run on. This keyword is not usable on JUGENE.||<partition name>||-|
|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.
|#@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
|#@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 to be copied
|No default value is set|