This information is for a release that is no longer supported by the Globus Toolkit. The currently supported versions of the Globus Toolkit are 4.2 (recommended) and 4.0.

WS GRAM: Developer's Guide

Overview
GRAM slides [ html ] [ pdf ]
API
Architecture
Fault Tolerance Architecture
RSL Schema
>MJS Fault Types
Samples
Scheduler tutorial
Troubleshooting

Managed Job Types

Contents:

top

Schema Document Properties

Target Namespace http://www.globus.org/namespaces/2003/12/managed_job/types
Element and Attribute Namespaces
  • 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 belong to this schema's target namespace.
Schema Composition
  • This schema imports schema(s) from the following namespace(s):
    • http://www.gridforum.org/namespaces/2003/03/OGSI (at ogsi.xsd)

Declared Namespaces

Prefix Namespace
gram http://www.globus.org/namespaces/2004/02/rsl/gram
mj-types http://www.globus.org/namespaces/2003/12/managed_job/types
ogsi http://www.gridforum.org/namespaces/2003/03/OGSI
xsd http://www.w3.org/2001/XMLSchema
xml http://www.w3.org/XML/1998/namespace
Schema Component Representation
<xsd:schema targetNamespace="http://www.globus.org/namespaces/2003/12/managed_job/types" attributeFormDefault="qualified" elementFormDefault="qualified">
<xsd:import namespace="http://www.gridforum.org/namespaces/2003/03/OGSI" schemaLocation="ogsi.xsd"/>
...
</xsd:schema>
top

Global Definitions

Complex Type: CacheFaultType

Super-types: ogsi:FaultType < FaultType (by extension) < CacheFaultType (by extension)
Sub-types: None
Name CacheFaultType
Abstract no
Documentation This fault indicates that an error occurred accessing the GASS Cache. This fault type contains the path to the GASS Cache as one of its elements. Some typical causes of this problem are gass cache program not installed in the GLOBUS_LOCATION path, or the user's home directory is non-existent or full.
XML Instance Representation
<...>
<ogsi:description> string </ogsi:description> [0..*]
<ogsi:originator> ogsi:LocatorType </ogsi:originator> [1]
<ogsi:timestamp> dateTime </ogsi:timestamp> [1]
<ogsi:faultcause> ogsi:FaultType </ogsi:faultcause> [0..*]
<ogsi:faultcode> ogsi:FaultCodeType </ogsi:faultcode> [0..1]
<ogsi:extension> ogsi:ExtensibilityType </ogsi:extension> [0..1]
<mj-types:stateWhenFailureOccurred> mj-types:JobStateType </mj-types:stateWhenFailureOccurred> [1]
<mj-types:script> mj-types:ScriptType </mj-types:script> [1]
<mj-types:gt2ErrorCode> xsd:int </mj-types:gt2ErrorCode> [1]
<mj-types:cachePath> xsd:string </mj-types:cachePath> [1]
</...>
Schema Component Representation
<xsd:complexType name="CacheFaultType">
<xsd:complexContent>
<xsd:extension base="mj-types:FaultType">
<xsd:sequence>
<xsd:element name="cachePath" type="xsd:string" minOccurs="1" maxOccurs="1"/>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
top

Complex Type: CredentialSerializationFaultType

Super-types: ogsi:FaultType < FaultType (by extension) < CredentialSerializationFaultType (by extension)
Sub-types: None
Name CredentialSerializationFaultType
Abstract no
Documentation This fault indicates that the managed job service was unable to serialize or deserialize a delegated credential.
XML Instance Representation
<...>
<ogsi:description> string </ogsi:description> [0..*]
<ogsi:originator> ogsi:LocatorType </ogsi:originator> [1]
<ogsi:timestamp> dateTime </ogsi:timestamp> [1]
<ogsi:faultcause> ogsi:FaultType </ogsi:faultcause> [0..*]
<ogsi:faultcode> ogsi:FaultCodeType </ogsi:faultcode> [0..1]
<ogsi:extension> ogsi:ExtensibilityType </ogsi:extension> [0..1]
<mj-types:stateWhenFailureOccurred> mj-types:JobStateType </mj-types:stateWhenFailureOccurred> [1]
<mj-types:script> mj-types:ScriptType </mj-types:script> [1]
<mj-types:gt2ErrorCode> xsd:int </mj-types:gt2ErrorCode> [1]
</...>
Schema Component Representation
<xsd:complexType name="CredentialSerializationFaultType">
<xsd:complexContent>
<xsd:extension base="mj-types:FaultType"/>
</xsd:complexContent>
</xsd:complexType>
top

Complex Type: DatabaseAccessFaultType

Super-types: ogsi:FaultType < FaultType (by extension) < InternalFaultType (by extension) < DatabaseAccessFaultType (by extension)
Sub-types: None
Name DatabaseAccessFaultType
Abstract no
Documentation This fault indicates that the Managed Job service was unable to store persistent state information into the recovery database.
XML Instance Representation
<...>
<ogsi:description> string </ogsi:description> [0..*]
<ogsi:originator> ogsi:LocatorType </ogsi:originator> [1]
<ogsi:timestamp> dateTime </ogsi:timestamp> [1]
<ogsi:faultcause> ogsi:FaultType </ogsi:faultcause> [0..*]
<ogsi:faultcode> ogsi:FaultCodeType </ogsi:faultcode> [0..1]
<ogsi:extension> ogsi:ExtensibilityType </ogsi:extension> [0..1]
<mj-types:stateWhenFailureOccurred> mj-types:JobStateType </mj-types:stateWhenFailureOccurred> [1]
<mj-types:script> mj-types:ScriptType </mj-types:script> [1]
<mj-types:gt2ErrorCode> xsd:int </mj-types:gt2ErrorCode> [1]
</...>
Schema Component Representation
<xsd:complexType name="DatabaseAccessFaultType">
<xsd:complexContent>
<xsd:extension base="mj-types:InternalFaultType"/>
</xsd:complexContent>
</xsd:complexType>
top

Complex Type: ExecutionFailedFaultType

Super-types: ogsi:FaultType < FaultType (by extension) < SLAFaultType (by extension) < ExecutionFailedFaultType (by extension)
Sub-types: None
Name ExecutionFailedFaultType
Abstract no
Documentation This fault indicates that the Managed Job service was unable to begin the execution of the job.
XML Instance Representation
<...>
<ogsi:description> string </ogsi:description> [0..*]
<ogsi:originator> ogsi:LocatorType </ogsi:originator> [1]
<ogsi:timestamp> dateTime </ogsi:timestamp> [1]
<ogsi:faultcause> ogsi:FaultType </ogsi:faultcause> [0..*]
<ogsi:faultcode> ogsi:FaultCodeType </ogsi:faultcode> [0..1]
<ogsi:extension> ogsi:ExtensibilityType </ogsi:extension> [0..1]
<mj-types:stateWhenFailureOccurred> mj-types:JobStateType </mj-types:stateWhenFailureOccurred> [1]
<mj-types:script> mj-types:ScriptType </mj-types:script> [1]
<mj-types:gt2ErrorCode> xsd:int </mj-types:gt2ErrorCode> [1]
<mj-types:sla> ogsi:ExtensibilityType </mj-types:sla> [1]
</...>
Schema Component Representation
<xsd:complexType name="ExecutionFailedFaultType">
<xsd:complexContent>
<xsd:extension base="mj-types:SLAFaultType"/>
</xsd:complexContent>
</xsd:complexType>
top

Complex Type: FaultType

Super-types: ogsi:FaultType < FaultType (by extension)
Sub-types:
Name FaultType
Abstract no
Documentation This is the base fault for runtime errors that occur while managing a job. It extends the OGSI FaultType.
XML Instance Representation
<...>
<ogsi:description> string </ogsi:description> [0..*]
<ogsi:originator> ogsi:LocatorType </ogsi:originator> [1]
<ogsi:timestamp> dateTime </ogsi:timestamp> [1]
<ogsi:faultcause> ogsi:FaultType </ogsi:faultcause> [0..*]
<ogsi:faultcode> ogsi:FaultCodeType </ogsi:faultcode> [0..1]
<ogsi:extension> ogsi:ExtensibilityType </ogsi:extension> [0..1]
<mj-types:stateWhenFailureOccurred> mj-types:JobStateType </mj-types:stateWhenFailureOccurred> [1]
<mj-types:script> mj-types:ScriptType </mj-types:script> [1]
<mj-types:gt2ErrorCode> xsd:int </mj-types:gt2ErrorCode> [1]
</...>
Schema Component Representation
<xsd:complexType name="FaultType">
<xsd:complexContent>
<xsd:extension base="ogsi:FaultType">
<xsd:sequence>
<xsd:element name="stateWhenFailureOccurred" type="mj-types:JobStateType"/>
<xsd:element name="script" type="mj-types:ScriptType"/>
<xsd:element name="gt2ErrorCode" type="xsd:int"/>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
top

Complex Type: FilePermissionsFaultType

Super-types: ogsi:FaultType < FaultType (by extension) < SLAFaultType (by extension) < FilePermissionsFaultType (by extension)
Sub-types: None
Name FilePermissionsFaultType
Abstract no
Documentation This fault indicates that the ManagedJob service does not have permissions to access a file referenced in the SLA.
XML Instance Representation
<...>
<ogsi:description> string </ogsi:description> [0..*]
<ogsi:originator> ogsi:LocatorType </ogsi:originator> [1]
<ogsi:timestamp> dateTime </ogsi:timestamp> [1]
<ogsi:faultcause> ogsi:FaultType </ogsi:faultcause> [0..*]
<ogsi:faultcode> ogsi:FaultCodeType </ogsi:faultcode> [0..1]
<ogsi:extension> ogsi:ExtensibilityType </ogsi:extension> [0..1]
<mj-types:stateWhenFailureOccurred> mj-types:JobStateType </mj-types:stateWhenFailureOccurred> [1]
<mj-types:script> mj-types:ScriptType </mj-types:script> [1]
<mj-types:gt2ErrorCode> xsd:int </mj-types:gt2ErrorCode> [1]
<mj-types:sla> ogsi:ExtensibilityType </mj-types:sla> [1]
<mj-types:path> xsd:string </mj-types:path> [1]
</...>
Schema Component Representation
<xsd:complexType name="FilePermissionsFaultType">
<xsd:complexContent>
<xsd:extension base="mj-types:SLAFaultType">
<xsd:sequence>
<xsd:element name="path" type="xsd:string" minOccurs="1" maxOccurs="1"/>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
top

Complex Type: InsufficientCredentialsFaultType

Super-types: ogsi:FaultType < FaultType (by extension) < InsufficientCredentialsFaultType (by extension)
Sub-types: None
Name InsufficientCredentialsFaultType
Abstract no
Documentation This fault indicates that the managed job service was unable to perform some action on behalf of the owner of the job submission because the owner has delegated insufficient credentials.
XML Instance Representation
<...>
<ogsi:description> string </ogsi:description> [0..*]
<ogsi:originator> ogsi:LocatorType </ogsi:originator> [1]
<ogsi:timestamp> dateTime </ogsi:timestamp> [1]
<ogsi:faultcause> ogsi:FaultType </ogsi:faultcause> [0..*]
<ogsi:faultcode> ogsi:FaultCodeType </ogsi:faultcode> [0..1]
<ogsi:extension> ogsi:ExtensibilityType </ogsi:extension> [0..1]
<mj-types:stateWhenFailureOccurred> mj-types:JobStateType </mj-types:stateWhenFailureOccurred> [1]
<mj-types:script> mj-types:ScriptType </mj-types:script> [1]
<mj-types:gt2ErrorCode> xsd:int </mj-types:gt2ErrorCode> [1]
</...>
Schema Component Representation
<xsd:complexType name="InsufficientCredentialsFaultType">
<xsd:complexContent>
<xsd:extension base="mj-types:FaultType"/>
</xsd:complexContent>
</xsd:complexType>
top

Complex Type: InternalFaultType

Super-types: ogsi:FaultType < FaultType (by extension) < InternalFaultType (by extension)
Sub-types:
Name InternalFaultType
Abstract no
Documentation This fault indicates that an internal operation failed.
XML Instance Representation
<...>
<ogsi:description> string </ogsi:description> [0..*]
<ogsi:originator> ogsi:LocatorType </ogsi:originator> [1]
<ogsi:timestamp> dateTime </ogsi:timestamp> [1]
<ogsi:faultcause> ogsi:FaultType </ogsi:faultcause> [0..*]
<ogsi:faultcode> ogsi:FaultCodeType </ogsi:faultcode> [0..1]
<ogsi:extension> ogsi:ExtensibilityType </ogsi:extension> [0..1]
<mj-types:stateWhenFailureOccurred> mj-types:JobStateType </mj-types:stateWhenFailureOccurred> [1]
<mj-types:script> mj-types:ScriptType </mj-types:script> [1]
<mj-types:gt2ErrorCode> xsd:int </mj-types:gt2ErrorCode> [1]
</...>
Schema Component Representation
<xsd:complexType name="InternalFaultType">
<xsd:complexContent>
<xsd:extension base="mj-types:FaultType"/>
</xsd:complexContent>
</xsd:complexType>
top

Complex Type: InvalidCredentialsFaultType

Super-types: ogsi:FaultType < FaultType (by extension) < InvalidCredentialsFaultType (by extension)
Sub-types: None
Name InvalidCredentialsFaultType
Abstract no
Documentation This fault indicates that the managed job service was unable to use a delegated credential.
XML Instance Representation
<...>
<ogsi:description> string </ogsi:description> [0..*]
<ogsi:originator> ogsi:LocatorType </ogsi:originator> [1]
<ogsi:timestamp> dateTime </ogsi:timestamp> [1]
<ogsi:faultcause> ogsi:FaultType </ogsi:faultcause> [0..*]
<ogsi:faultcode> ogsi:FaultCodeType </ogsi:faultcode> [0..1]
<ogsi:extension> ogsi:ExtensibilityType </ogsi:extension> [0..1]
<mj-types:stateWhenFailureOccurred> mj-types:JobStateType </mj-types:stateWhenFailureOccurred> [1]
<mj-types:script> mj-types:ScriptType </mj-types:script> [1]
<mj-types:gt2ErrorCode> xsd:int </mj-types:gt2ErrorCode> [1]
</...>
Schema Component Representation
<xsd:complexType name="InvalidCredentialsFaultType">
<xsd:complexContent>
<xsd:extension base="mj-types:FaultType"/>
</xsd:complexContent>
</xsd:complexType>
top

Complex Type: InvalidPathFaultType

Super-types: ogsi:FaultType < FaultType (by extension) < SLAFaultType (by extension) < InvalidPathFaultType (by extension)
Sub-types: None
Name InvalidPathFaultType
Abstract no
Documentation This fault indicates that a file or directory path referenced in the SLA contains an invalid path.
XML Instance Representation
<...>
<ogsi:description> string </ogsi:description> [0..*]
<ogsi:originator> ogsi:LocatorType </ogsi:originator> [1]
<ogsi:timestamp> dateTime </ogsi:timestamp> [1]
<ogsi:faultcause> ogsi:FaultType </ogsi:faultcause> [0..*]
<ogsi:faultcode> ogsi:FaultCodeType </ogsi:faultcode> [0..1]
<ogsi:extension> ogsi:ExtensibilityType </ogsi:extension> [0..1]
<mj-types:stateWhenFailureOccurred> mj-types:JobStateType </mj-types:stateWhenFailureOccurred> [1]
<mj-types:script> mj-types:ScriptType </mj-types:script> [1]
<mj-types:gt2ErrorCode> xsd:int </mj-types:gt2ErrorCode> [1]
<mj-types:sla> ogsi:ExtensibilityType </mj-types:sla> [1]
<mj-types:path> xsd:string </mj-types:path> [1]
</...>
Schema Component Representation
<xsd:complexType name="InvalidPathFaultType">
<xsd:complexContent>
<xsd:extension base="mj-types:SLAFaultType">
<xsd:sequence>
<xsd:element name="path" type="xsd:string" minOccurs="1" maxOccurs="1"/>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
top

Complex Type: JobStatusType

Super-types: None
Sub-types: None
Name JobStatusType
Abstract no
Documentation Type containing information about the current state of the job and, if the job failed, fault information.
XML Instance Representation
<...>
<mj-types:jobState> mj-types:JobStateType </mj-types:jobState> [1]
<mj-types:fault> ogsi:ExtensibilityType </mj-types:fault> [0..1]
</...>
Schema Component Representation
<xsd:complexType name="JobStatusType">
<xsd:sequence>
<xsd:element name="jobState" type="mj-types:JobStateType"/>
<xsd:element name="fault" type="ogsi:ExtensibilityType" minOccurs="0" maxOccurs="1"/>
</xsd:sequence>
</xsd:complexType>