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)

RSL Variables

The RSL Language includes support for system-specific variable substitutions. These variables allow one to write an RSL without specific knowledge of the execution host's local account or directory configuration.

RSL Variable Syntax

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

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

                    <rsl:executable>myJob</rsl:executable>
                    <rsl:stdout>stdout.${GLOBUS_USER_NAME}</rsl:stdout>
                

                    <rsl:executable>myJob</rsl:executable>
                    <rsl:stdout>stdout.user0001</rsl:stdout>
                

RSL Attributes Which May Contain Variable References

RSL Variable substitutions may not occur in all RSL Job 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 RSL Variables is:

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

RSL 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 RSL variables described in this document may be referenced in an RSL 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 RSL Job Description documents in WS-GRAM, RSL 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, RSL variable references are included with a special syntax within certain RSL job description elements.