GT 4.0 WS GRAM: Job Description Schema Doc

• Global element and attribute declarations belong to this schema's target namespace.
• By default, local element declarations belong to this schema's target namespace.
• By default, local attribute declarations have no namespace.

• This schema imports schema(s) from the following namespace(s):
  • http://www.globus.org/namespaces/2004/10/gram/job/types (at managed_job_types.xsd)
  • http://schemas.xmlsoap.org/ws/2004/03/addressing (at ../ws/addressing/WS-Addressing.xsd)
  • http://www.globus.org/namespaces/2004/10/rft (at ../transfer/reliable/reliable_transfer_types.xsd)

Job Description Variables

The WS GRAM service includes support for system-specific variable substitutions. These variables allow one to write a job description without specific knowledge of the execution host's local account or directory configuration.

Variable Syntax

Variable references occur within the contents of an xsd:string type element. The syntax for a variable reference is

                   DOLLAR-SIGN LEFT-BRACE variable-name RIGHT-BRACE
                

                    <executable>myJob<executable>
                    <stdout>stdout.${GLOBUS_USER_NAME}<stdout>
                

                    <executable>myJob<executable>
                    <stdout>stdout.user0001<stdout>
                

Job Description Attributes Which May Contain Variable References

Variables substitutions do not occur in all job description attributes. Their use is restricted to those which contain arbitrary string data and which may be used to access the local resource associated with a job. The list of attributes which may contain variables is:

• executable
• directory
• argument
• environment
• stdin
• stdout
• stderr
• libraryPath
• fileStageIn
• fileStageOut
• fileCleanUp

Variable Descriptions

GLOBUS_USER_HOME

The path to the home directory for the local account/user

GLOBUS_USER_NAME

The local account the job is running under

GLOBUS_SCRATCH_DIR

An alternative directory where a file system is shared with the compute nodes that a user might want to use. Typically it will provide more space than the users default HOME dir. This directory's value may contain ${GLOBUS_USER_HOME}, which will be replaced with value of that substitution.

GLOBUS_LOCATION

Path to the Globus Toolkit installation

Differences From Pre-WS GRAM and OGSA GRAM

In both Pre-WS GRAM and OGSA-GRAM, applications could define arbitrary RSL substitutions within an RSL document and rely on the GRAM service to resolve them. This feature is no longer present. Only those variables described in this document may be referenced in a job description.

In both Prew-WS GRAM and OGSA-GRAM, RSL substitutions could be used in arbitrary Job Description attributes. In an effort to more strongly type job description documents in WS GRAM, variable substitutions are now restricted to be used only in certain attribute contexts.

OGSA GRAM defines RSL Substitutions as separate XML elements within an RSL Job Description document. With GT4 WS GRAM, variable references are included with a special syntax within certain job description elements.

• Built-in XSD Type: string

• value = {'mpi'|'single'|'multiple'|'condor'}