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>
top

Complex Type: RepeatedlyStartedFaultType

Super-types: ogsi:FaultType < FaultType (by extension) < RepeatedlyStartedFaultType (by extension)
Sub-types: None
Name RepeatedlyStartedFaultType
Abstract no
Documentation This fault indicates that the start method of the Managed Job service could not run because the job had already been started.
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="RepeatedlyStartedFaultType">
<xsd:complexContent>
<xsd:extension base="mj-types:FaultType"/>
</xsd:complexContent>
</xsd:complexType>
top

Complex Type: SLAFaultType

Super-types: ogsi:FaultType < FaultType (by extension) < SLAFaultType (by extension)
Sub-types:
Name SLAFaultType
Abstract no
Documentation Fault for runtime errors which are directly related to a particular part of the SLA document passed to the createService method. This fault type contains the fragment of the SLA related to the fault as one of its elements.
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="SLAFaultType">
<xsd:complexContent>
<xsd:extension base="mj-types:FaultType">
<xsd:sequence>
<xsd:element name="sla" type="ogsi:ExtensibilityType"/>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
top

Complex Type: StagingDataType

Super-types: None
Sub-types: None
Name StagingDataType
Abstract no
XML Instance Representation
<...>
<mj-types:sourceUrl> xsd:string </mj-types:sourceUrl> [1]
<mj-types:destinationUrl> xsd:string </mj-types:destinationUrl> [1]
<mj-types:stagingType> xsd:string </mj-types:stagingType> [1]
</...>
Schema Component Representation
<xsd:complexType name="StagingDataType">
<xsd:sequence>
<xsd:element name="sourceUrl" type="xsd:string"/>
<xsd:element name="destinationUrl" type="xsd:string"/>
<xsd:element name="stagingType" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
top

Complex Type: StagingFaultType

Super-types: ogsi:FaultType < FaultType (by extension) < SLAFaultType (by extension) < StagingFaultType (by extension)
Sub-types: None
Name StagingFaultType
Abstract no
Documentation This fault indicates that part of the file staging requirements of the SLA could not be completed.
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:stageToCache> xsd:boolean </mj-types:stageToCache> [1]
<mj-types:source> xsd:string </mj-types:source> [1]
<mj-types:destination> xsd:string </mj-types:destination> [1]
</...>
Schema Component Representation
<xsd:complexType name="StagingFaultType">
<xsd:complexContent>
<xsd:extension base="mj-types:SLAFaultType">
<xsd:sequence>
<xsd:element name="stageToCache" type="xsd:boolean" minOccurs="1" maxOccurs="1"/>
<xsd:element name="source" type="xsd:string" minOccurs="1" maxOccurs="1"/>
<xsd:element name="destination" type="xsd:string" minOccurs="1" maxOccurs="1"/>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
top

Complex Type: StagingPersistenceDataType

Super-types: None
Sub-types: None
Name StagingPersistenceDataType
Abstract no
XML Instance Representation
<...>
<mj-types:stagingData> mj-types:StagingDataType </mj-types:stagingData> [0..*]
</...>
Schema Component Representation
<xsd:complexType name="StagingPersistenceDataType">
<xsd:sequence>
<xsd:element name="stagingData" type="mj-types:StagingDataType" minOccurs="0" maxOccurs="unbounded"/>
</xsd:sequence>
</xsd:complexType>
top

Complex Type: StatePersistenceDataType

Super-types: None
Sub-types: None
Name StatePersistenceDataType
Abstract no
XML Instance Representation
<...>
<mj-types:started> xsd:boolean </mj-types:started> [1]
<mj-types:state> xsd:int </mj-types:state> [1]
<mj-types:status> xsd:int </mj-types:status> [1]
<mj-types:failureCode> xsd:string </mj-types:failureCode> [1]
<mj-types:jobId> xsd:string </mj-types:jobId> [1]
<mj-types:rsl> xsd:string </mj-types:rsl> [1]
<mj-types:cacheTag> xsd:string </mj-types:cacheTag> [1]
<mj-types:commitTimeout> xsd:int </mj-types:commitTimeout> [1]
<mj-types:scratchDirectory> xsd:string </mj-types:scratchDirectory> [1]
<mj-types:credentialPath> xsd:string </mj-types:credentialPath> [1]
</...>
Schema Component Representation
<xsd:complexType name="StatePersistenceDataType">
<xsd:sequence>
<xsd:element name="started" type="xsd:boolean"/>
<xsd:element name="state" type="xsd:int"/>
<xsd:element name="status" type="xsd:int"/>
<xsd:element name="failureCode" type="xsd:string"/>
<xsd:element name="jobId" type="xsd:string"/>
<xsd:element name="rsl" type="xsd:string"/>
<xsd:element name="cacheTag" type="xsd:string"/>
<xsd:element name="commitTimeout" type="xsd:int"/>
<xsd:element name="scratchDirectory" type="xsd:string"/>
<xsd:element name="credentialPath" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
top

Complex Type: StreamServiceCreationFaultType

Super-types: ogsi:FaultType < FaultType (by extension) < StreamServiceCreationFaultType (by extension)
Sub-types: None
Name StreamServiceCreationFaultType
Abstract no
Documentation This fault indicates that the Managed Job Service could not create the services required to stream standard output or stdandard error.
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:streamService> mj-types:OutputType </mj-types:streamService> [1]
</...>
Schema Component Representation
<xsd:complexType name="StreamServiceCreationFaultType">
<xsd:complexContent>
<xsd:extension base="mj-types:FaultType">
<xsd:sequence>
<xsd:element name="streamService" type="mj-types:OutputType" minOccurs="1" maxOccurs="1"/>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
top

Complex Type: UnresolvedSubstitutionReferencesFaultType

Super-types: ogsi:FaultType < FaultType (by extension) < UnresolvedSubstitutionReferencesFaultType (by extension)
Sub-types: None
Name UnresolvedSubstitutionReferencesFaultType
Abstract no
Documentation This fault indicates that an element in the SLA contains a reference to an undefined subsitution. This fault type contains elements that have the value of substitutions which could not be resolved.
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:substitutionName> xsd:string </mj-types:substitutionName> [1..*]
</...>
Schema Component Representation
<xsd:complexType name="UnresolvedSubstitutionReferencesFaultType">
<xsd:complexContent>
<xsd:extension base="mj-types:FaultType">
<xsd:sequence>
<xsd:element name="substitutionName" type="xsd:string" minOccurs="1" maxOccurs="unbounded"/>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
top

Complex Type: UnsupportedFeatureFaultType

Super-types: ogsi:FaultType < FaultType (by extension) < SLAFaultType (by extension) < UnsupportedFeatureFaultType (by extension)
Sub-types: None
Name UnsupportedFeatureFaultType
Abstract no
Documentation This fault indicates that an error occurred because the RSL depended on a feature not implemented by a particular GRAM scheduler.
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:feature> xsd:string </mj-types:feature> [1]
</...>
Schema Component Representation
<xsd:complexType name="UnsupportedFeatureFaultType">
<xsd:complexContent>
<xsd:extension base="mj-types:SLAFaultType">
<xsd:sequence>
<xsd:element name="feature" type="xsd:string" minOccurs="1" maxOccurs="1"/>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
top

Simple Type: JobStateType

Super-types: xsd:string < JobStateType (by restriction)
Sub-types: None
Name JobStateType
Content
  • Built-in XSD Type: string
  • value = {'Unsubmitted'|'StageIn'|'Pending'|'Active'|'StageOut'|'Suspended'|'Done'|'Failed'}
Documentation Job states for a Managed Job.
Schema Component Representation
<xsd:simpleType name="JobStateType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Unsubmitted"/>
<xsd:enumeration value="StageIn"/>
<xsd:enumeration value="Pending"/>
<xsd:enumeration value="Active"/>
<xsd:enumeration value="StageOut"/>
<xsd:enumeration value="Suspended"/>
<xsd:enumeration value="Done"/>
<xsd:enumeration value="Failed"/>
</xsd:restriction>
</xsd:simpleType>
top

Simple Type: OutputType

Super-types: xsd:string < OutputType (by restriction)
Sub-types: None
Name OutputType
Content
  • Built-in XSD Type: string
  • value = {'stdout'|'stderr'}
Documentation Type of a output stream service.
Schema Component Representation
<xsd:simpleType name="OutputType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="stdout"/>
<xsd:enumeration value="stderr"/>
</xsd:restriction>
</xsd:simpleType>
top

Simple Type: ScriptType

Super-types: xsd:string < ScriptType (by restriction)
Sub-types: None
Name ScriptType
Content
  • Built-in XSD Type: string
  • value = {'submit'|'poll'|'cancel'|'signal'|'make_scratchdir'|'remove_scratchdir'|'stage_in'|'stage_out'|'cache_cleanup'|'remote_io_file_create'|'proxy_relocate'|'proxy_update'|'file_cleanup'}
Documentation Script methods which may be called the Managed Job Services. Faults will be associated with one of these script methods.
Schema Component Representation
<xsd:simpleType name="ScriptType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="submit"/>
<xsd:enumeration value="poll"/>
<xsd:enumeration value="cancel"/>
<xsd:enumeration value="signal"/>
<xsd:enumeration value="make_scratchdir"/>
<xsd:enumeration value="remove_scratchdir"/>
<xsd:enumeration value="stage_in"/>
<xsd:enumeration value="stage_out"/>
<xsd:enumeration value="cache_cleanup"/>
<xsd:enumeration value="remote_io_file_create"/>
<xsd:enumeration value="proxy_relocate"/>
<xsd:enumeration value="proxy_update"/>
<xsd:enumeration value="file_cleanup"/>
</xsd:restriction>
</xsd:simpleType>
top

Legend

Complex Type: AusAddress
Schema Component Type Schema Component Name
Super-types: Address < AusAddress (by extension)
Sub-types:
  • QLDAddress (by restriction)
If this schema component is a type definition, its type hierarchy is shown in a gray-bordered box.
Name AusAddress
Abstract no
The table above displays the properties of this schema component.
XML Instance Representation
<... country="Australia">
<unitNo> string </unitNo> [0..1]
<houseNo> string </houseNo> [1]
<street> string </street> [1]
Start Choice[1]
<city> string </city> [1]
<town> string </town> [1]
End Choice
<state> AusStates </state> [1]
<postcode> string <<pattern = [1-9][0-9]{3}>> </postcode> [1]
</...>

The XML Instance Representation table above shows the schema component's content as an XML instance.

  • The minimum and maximum occurrence of elements and attributes are provided in square brackets, e.g. [0..1].
  • Model group information are shown in gray, e.g. Start Choice ... End Choice.
  • For type derivations, the elements and attributes that have been added to or changed from the base type's content are shown in bold.
  • If an element/attribute has a fixed value, the fixed value is shown in green, e.g. country="Australia".
  • Otherwise, the type of the element/attribute is displayed.
    • If the element/attribute's type is in the schema, a link is provided to it.
    • For local simple type definitions, the constraints are displayed in angle brackets, e.g. <<pattern = [1-9][0-9]{3}>>.
Schema Component Representation
<complexTypename="AusAddress">
<complexContent>
<extensionbase="Address">
<sequence>
<elementname="state" type="AusStates"/>
<elementname="postcode">
<simpleType>
<restrictionbase="string">
<patternvalue="[1-9][0-9]{3}"/>
</restriction>
</simpleType>
</element>
</sequence>
<attributename="country" type="string" fixed="Australia"/>
</extension>
</complexContent>
</complexType>
The Schema Component Representation table above displays the underlying XML representation of the schema component. (Annotations are not shown.)
top

Glossary

Abstract (Applies to complex type definitions and element declarations). An abstract element or complex type cannot used to validate an element instance. If there is a reference to an abstract element, only element declarations that can substitute the abstract element can be used to validate the instance. For references to abstract type definitions, only derived types can be used.

All Model Group Child elements can be provided in any order in instances. See: http://www.w3.org/TR/xmlschema-1/#element-all.

Choice Model Group Only one from the list of child elements and model groups can be provided in instances. See: http://www.w3.org/TR/xmlschema-1/#element-choice.

Collapse Whitespace Policy Replace tab, line feed, and carriage return characters with space character (Unicode character 32). Then, collapse contiguous sequences of space characters into single space character, and remove leading and trailing space characters.

Disallowed Substitutions (Applies to element declarations). If substitution is specified, then substitution group members cannot be used in place of the given element declaration to validate element instances. If derivation methods, e.g. extension, restriction, are specified, then the given element declaration will not validate element instances that have types derived from the element declaration's type using the specified derivation methods. Normally, element instances can override their declaration's type by specifying an xsi:type attribute.

Key Constraint Like Uniqueness Constraint, but additionally requires that the specified value(s) must be provided. See: http://www.w3.org/TR/xmlschema-1/#cIdentity-constraint_Definitions.

Key Reference Constraint Ensures that the specified value(s) must match value(s) from a Key Constraint or Uniqueness Constraint. See: http://www.w3.org/TR/xmlschema-1/#cIdentity-constraint_Definitions.

Model Group Groups together element content, specifying the order in which the element content can occur and the number of times the group of element content may be repeated. See: http://www.w3.org/TR/xmlschema-1/#Model_Groups.

Nillable (Applies to element declarations). If an element declaration is nillable, instances can use the xsi:nil attribute. The xsi:nil attribute is the boolean attribute, nil, from the http://www.w3.org/2001/XMLSchema-instance namespace. If an element instance has an xsi:nil attribute set to true, it can be left empty, even though its element declaration may have required content.

Notation A notation is used to identify the format of a piece of data. Values of elements and attributes that are of type, NOTATION, must come from the names of declared notations. See: http://www.w3.org/TR/xmlschema-1/#cNotation_Declarations.

Preserve Whitespace Policy Preserve whitespaces exactly as they appear in instances.

Prohibited Derivations (Applies to type definitions). Derivation methods that cannot be used to create sub-types from a given type definition.

Prohibited Substitutions (Applies to complex type definitions). Prevents sub-types that have been derived using the specified derivation methods from validating element instances in place of the given type definition.

Replace Whitespace Policy Replace tab, line feed, and carriage return characters with space character (Unicode character 32).

Sequence Model Group Child elements and model groups must be provided in the specified order in instances. See: http://www.w3.org/TR/xmlschema-1/#element-sequence.

Substitution Group Elements that are members of a substitution group can be used wherever the head element of the substitution group is referenced.

Substitution Group Exclusions (Applies to element declarations). Prohibits element declarations from nominating themselves as being able to substitute a given element declaration, if they have types that are derived from the original element's type using the specified derivation methods.

Target Namespace The target namespace identifies the namespace that components in this schema belongs to. If no target namespace is provided, then the schema components do not belong to any namespace.

Uniqueness Constraint Ensures uniqueness of an element/attribute value, or a combination of values, within a specified scope. See: http://www.w3.org/TR/xmlschema-1/#cIdentity-constraint_Definitions.

top