Globus Toolkit 3.9.2 Development Documentation: GRAM

Command line tool: rsl-converter-GT3GT4

Resource Specification Language (RSL) is an XML language used to describe jobs to submit to GRAM. The rsl-converter-GT3GT4 command line tool converts the format of existing RSL files from GT3 to GT4. Files listed on the command line will be used as input. For each GT3 RSL file <rsl>.xml, a new GT4 RSL file <rsl>_gt4.xml will be generated.

Arguments

  (-files (<GT3 RSL file>)*) | (-dir <GT3 RSL directory>)
  [-output <directory>]
  -help | -usage | -version

Limitations

Extensions to the RSL via the <xsd:any> are not kept. They must be added manually to the generated GT4 file(s).

Prior to conversion per se, each RSL substitution reference is resolved with the corresponding substitution definition if it is declared in the RSL document. If no corresponding substitution definition has been declared, the name of the substitution variable enclosed in '@' characters (as in @GLOBUS_LOCATION@) is used as the value of the variable, as a flag for the user to replace it with the appropriate value before submission.
In fact, server-side RSL substitutions are not supported anymore except HOME (which stands for the absolute file path of the submitting user's home directory), which is replaced with the special string ${GLOBUS_USER_HOME}, to eventually be resolved by the GRAM services.

Options

Help options
`-help`	Displays help information about the command.
`-usage`	Displays usage of the command.
`-v, -version`	Displays version of the command.
Input options
`-f, -files <file>*`	Specifies one or more GT3 RSL files to convert (separated by spaces).
`-d, -dir <dir>`	Specifies a directory containing GT3 RSL files to convert. Every file which name ends with .xml is converted.
Output options
`-o, -output <dir>`	Specifies a directory <dir> where the GT4 RSL files should be generated. The default is the current directory.
`-s, suffix <suffix>`	Specifies a suffix for output file names to end with: `<suffix>.xml` The default value is _gt4.xml.