[[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 with optional version of the requested software module. This directive is taken into consideration by the broker in the process of choosing the optimal resource which the task can be executed on. Every module has to be specified in separate directive.

{{{
#QCG module=nwchem/6.0
#QCG module=namd
}}}
= monitor =
monitor - task monitoring script executed together with the main application. The script can be used for example to monitor output of the application or to do perform any additional action.

{{{
#QCG monitor=monitor-script.sh
}}}
= name =
'''name''' - human readable name of the task. The name will appear as part of the job identifier.

{{{
#QCG name=nobel-experiment
}}}
= native =
native - parameters/requirements passed directly to the queueing system in the queueing system specific format. This directive should be used together with the ''host'' one.

Example for the PBS queueing system:
(-r y|n Declares whether the job is rerunable.)

{{{
#QCG native=-r n
}}}
= 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)