[[PageOutline]]

= application =
'''application''' - name and optionally version of the application to be executed
{{{
#QCG application=namd
}}}
{{{
#QCG application=gromacs/4.6.3
}}}


= argument =
'''argument''' - argument of the application. The directive can be used many times, once for every argument.
{{{
#QCG argument=arg1
#QCG argument=arg2
}}}


= deadline = 
'''deadline''' - deadline for the task execution. 
The directive specifies, that the task has to be finished within defined period of time. 

The directive results in using the advance reservation to guarantee the requested quality of service. 

The directive cannot be used in conjunction with the ''reservation'' and ''not-after'' directives. 

The argument of the directive is the time period defined in the PnYnMnDTnHnMnS (ISO 8601) format, where:
* P - mandatory character,
* nY - number of years,
* nM - number of months,
* nD - number of days,
* T - time definition separator character (must be present if the values below are used)
* nH - number of hours,
* nM - number of minutes,
* nS - number of seconds.

{{{
#QCG deadline=P3DT12H
#QCG not-before=2012.07.25
}}}
{{{
#QCG deadline=P3DT12H
}}}

= environment =
'''environment''' - environment variable. The syntax is ''key'' -> ''value''. Every variable has be be specified in separate line.

{{{
#QCG environment=name -> piontek
#QCG environment=location -> poznan
}}}

= error =
'''error''' - location where the system has to stage-out the file containing output of the standard error stream. If the location is not the gsiftp:// url it is assumed that it is relative to the directory from which the task was submitted.

{{{
#QCG error=gsiftp://qcg.man.poznan.pl//home/plgrid/plgpiontek/reef/errors/${JOB_ID}.error
#QCG error=error.txt
}}}


= executable =
'''executable''' - location of the executable file. The location can be gsiftp:// url or the path to the file. In the second case the location is relative to the directory from which the task was submitted. Optionally it is possible to specify the target name of the file.
{{{
#QCG executable=gsiftp://qcg.man.poznan.pl//home/plgrid/plgpiontek/reef/executables/exec1
#QCG executable=executables/exec1
#QCG executable=executables/exec1 -> exec-file
}}}
= grant = 
grant - name of the grant, in scope of which the task is executed

{{{
#QCG grant=plgpiontek_grant
}}}

= host =
host - name of the candidate host, which the task/reservation can be executed/made on. The directive can appear many times to express OR alternative.

{{{
#QCG host=reef.man.poznan.pl
#QCG host=zeus.cyfronet.pl
}}}

= input =
'''input''' - location of the file which content will be passed to standard input stream. If the location is not the gsiftp:// url it is assumed that it is relative to the directory from which the task was submitted. 

{{{
#QCG input=gsiftp://qcg.man.poznan.pl//home/plgrid/plgpiontek/reef/inputs/experiment.input
#QCG input=input.txt
}}}
= memory =
'''memory''' - declaration of the maximal amount of memory that can be allocated by the application (in MB).

{{{
#QCG memory=1024
}}}

= memory-per-slot =
'''memory-per-slot''' - declared maximal amount of the memory per slot (core). The total memory requirement is the product of this value and number od slots (cores) used by the application.

{{{
#QCG memory-per-slot=512
}}}
= module =
module - name of the required module

= monitor =
monitor - task monitoring script

= name =
name - human readable name of the task

= native =
native - parameters/requirements passed directly to the queueing system

= nodes =
nodes - requested topology of parallel application

= not-after =
not-after - execute not later then

= not-before =
not-before - do not execute before

= note =
note - human readable description of the task

= notify =
notify - notify about changes of task status

= output =
output - location for the standard output file

= persistent =
persistent - do not remove the working directory

= postprocess =
postprocess - task epilog

= preprocess =
preprocess - task prolog

= procs =
procs - number of requested slots/processes

= properties =
properties - node properties

= queue =
queue - selected queue

= reservation =
reservation - reservation identifier

= stage-in-dir =
stage-in-dir - input directory

= stage-in-file =
stage-in-file - input file

= stage-out-dir =
stage-out-dir - output directory

= stage-out-file
stage-out-file - output file

= use-reservation =
use-reservation - use the advance reservation mechanism

= use-scratch =
use-scratch - use the scratch space

= walltime =
walltime - execution duration

= watch-output =
watch-output - monitor the output and send notifications about the progress

= variable =
variable - description variable (replaced only in values of QCG directives)