LoggingAndBookkeeping

Table of Contents

Overview
Operations
GetVersion
JobStatus
QueryEvents
QueryJobs
UserJobs
Types
CancelStatusCode
ClearReason
CondorRejectStatusCode
CondorResourceUsageUsage
DoneStatusCode
EnQueuedResult
HelperCallSrcRole
HelperReturnSrcRole
Level
PBSResourceUsageUsage
RegJobJobtype
ResubmissionResult
TransferResult
childrenHistItem
doneCode
event
eventAbort
eventAccepted
eventCancel
eventChangeACL
eventChkpt
eventClear
eventCollectionState
eventCondorError
eventCondorMatch
eventCondorReject
eventCondorResourceUsage
eventCondorShadowExited
eventCondorShadowStarted
eventCondorStarterExited
eventCondorStarterStarted
eventCurDescr
eventDeQueued
eventDone
eventEnQueued
eventHelperCall
eventHelperReturn
eventListener
eventMatch
eventNotification
eventPBSDequeued
eventPBSDone
eventPBSError
eventPBSMatch
eventPBSPending
eventPBSQueued
eventPBSRerun
eventPBSResourceUsage
eventPBSRun
eventPending
eventPurge
eventReallyRunning
eventRefused
eventRegJob
eventResourceUsage
eventResubmission
eventResume
eventRunning
eventSource
eventSuspend
eventTransfer
eventUserTag
genericFault
jobFlags
jobStatus
jobtype
queryAttr
queryConditions
queryOp
queryRecValue
queryRecord
statName
stateEnterTimesItem
tagValue
timeval

Overview

Logging and Bookkeeping (L&B) service keeps track of grid jobs.

The service receives job events from various components of the Workload Management System, stores them, and derives then the corresponding job states.

Job information is fed into LB through a logging interface (legacy C and shell API) and it is not exposed as a web service yet.

The users may query job states or retrieve LB events either via the same C/C++ interface or via this web-service interface.

Besides querying for the job state actively the user may also register for receiving notifications on particular job state changes. This functionality is supported only in the legacy C/C++ interface.

Operations

CVS revision: $Header: /cvs/glite/org.glite.lb.ws-interface/src/LB.xml,v 1.5 2006/06/09 13:49:32 valtri Exp $

GetVersion

Return version of the service.

Inputs:

xsd:stringdummy
Dummy parameter (workaround for gSoap).

Outputs:

xsd:stringversion
Returned version.

JobStatus

Query state of a single job.

Inputs:

xsd:stringjobid
Id of the queried job.
jobFlagsflags
Which data fields to retrieve.

Outputs:

jobStatusstat
Current state of the job.

QueryEvents

Retrieve events matching a query. There are two sets of conditions, on jobs and on individual events, both have to be satisfied. Both query conditions have the same format as in QueryJobs.

Inputs:

list of queryConditionsjobConditions
Conditions on jobs.
list of queryConditionseventConditions
Conditions on individual events.

Outputs:

list of eventevents
All matchin events.

QueryJobs

Retrieve a list of jobs, including their states, based on query conditions. The conditions take the form of a list of lists. Elements of the inner lists refer to a single job attribute, the conditions are or-ed. Elements of the outer list may refer to different job attributes, they are and-ed.

Inputs:

list of queryConditionsconditions
The query conditions.
jobFlagsflags
Which data fields to retrieve.

Outputs:

list of xsd:stringjobs
JobId's of jobs matching the query.
list of jobStatusstates
States of jobs matching the query.

UserJobs

Simplified query, return all jobs of the authenticated user.

Inputs: N/A

Outputs:

list of xsd:stringjobs
JobId's of jobs matching the query.
list of jobStatusstates
States of jobs matching the query.

Types

CVS revision: $Header: /cvs/glite/org.glite.lb.ws-interface/src/LBTypes.xml.T,v 1.8.2.1 2008/05/07 06:53:01 zsalvet Exp $

CancelStatusCode

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

REQ
The request was acknowledged.
REFUSE
The request was declined by this component.
DONE
The request was completed by whole WMS.
ABORT
The request was refused by whole WMS.

ClearReason

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

USER
User retrieved output sandbox.
TIMEOUT
Timed out, resource forced purge of the sandbox.
NOOUTPUT
No output was generated.

CondorRejectStatusCode

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

NOMATCH
No match found
OTHER
Other reason

CondorResourceUsageUsage

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

REQUESTED
Requested value
USED
Consumed quantity

DoneStatusCode

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

OK
The job terminated by itself.
FAILED
The job disappeared from LRMS.
CANCELLED
The job was cancelled by user request.

EnQueuedResult

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

START
The sending component has started or is about to start enqueuing the job.
OK
The job was enqueued successfully.
REFUSED
The job was refused by the other component.
FAIL
The transfer failed for other reason than explicit refusal.

HelperCallSrcRole

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

CALLING
The logging component is caller.
CALLED
The logging component is callee.

HelperReturnSrcRole

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

CALLING
The logging component is caller.
CALLED
The logging component is callee.

Level

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

EMERGENCY
emergency
ALERT
alert
ERROR
error
WARNING
warning
AUTH
authentication
SECURITY
security
USAGE
usage
SYSTEM
system
IMPORTANT
important
DEBUG
debug

PBSResourceUsageUsage

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

REQUESTED
Requested value
USED
Consumed quantity

RegJobJobtype

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

SIMPLE
The job is simple job.
DAG
The job is dag (containing static set of subjobs).
PARTITIONABLE
The job is partitionable (may become partitioned).
PARTITIONED
The job is partitioned (dynamically created dag).
COLLECTION
The job is collection (containing static set of subjobs).
PBS
PBS job
CONDOR
Condor job

ResubmissionResult

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

WILLRESUB
The job will be resubmitted (deep resubmission).
WONTRESUB
The job will not be resubmitted.
SHALLOW
Shallow resubmission (user payload has not started yet)

TransferResult

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

START
The sending component has started or is about to start the transfer.
OK
The job was sent successfully.
REFUSED
The job was refused by the other component.
FAIL
The transfer failed for other reason than explicit refusal (eg. network timeout).

childrenHistItem

Structure (sequence complex type in WSDL)

Fields: ( type name description )

statName state
The job state of the children.
xsd:int count
How many children are in this state.

doneCode

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

OK
Finished correctly
FAILED
Execution failed
CANCELLED
Cancelled by user

event

Union (choice complex type in WSDL)

Fields: ( type name description )

eventTransfer Transfer
Start, success, or failure of job transfer to another component.
eventAccepted Accepted
Accepting job (successful counterpart to Transfer).
eventRefused Refused
Refusing job (unsuccessful counterpart to Transfer).
eventEnQueued EnQueued
The job has been enqueued in an inter-component queue.
eventDeQueued DeQueued
The job has been dequeued from an inter-component queue.
eventHelperCall HelperCall
Helper component is called.
eventHelperReturn HelperReturn
Helper component is returning the control.
eventRunning Running
Job wrapper started.
eventResubmission Resubmission
Result of resubmission decision.
eventDone Done
Execution terminated (normally or abnormally).
eventCancel Cancel
Cancel operation has been attempted on the job.
eventAbort Abort
Job aborted by system.
eventClear Clear
Job cleared, output sandbox removed
eventPurge Purge
Job is purged from bookkepping server.
eventMatch Match
Matching CE found.
eventPending Pending
No matching CE found yet.
eventRegJob RegJob
New job registration.
eventChkpt Chkpt
Application-specific checkpoint record.
eventListener Listener
Listening network port for interactive control.
eventCurDescr CurDescr
Current state of job processing (optional event).
eventUserTag UserTag
User tag -- arbitrary name=value pair.
eventChangeACL ChangeACL
Management of ACL stored on bookkepping server.
eventNotification Notification
Management of notification service.
eventResourceUsage ResourceUsage
Resource (CPU, memory etc.) consumption.
eventReallyRunning ReallyRunning
User payload started.
eventSuspend Suspend
Job execution (queuing) was suspended.
eventResume Resume
Job execution (queuing) was resumed.
eventCollectionState CollectionState
State of the collection.
eventPBSQueued PBSQueued
Job enqued
eventPBSMatch PBSMatch
Scheduler created exec_host
eventPBSPending PBSPending
Scheduler is not able to find exec_host, or some error occured
eventPBSRun PBSRun
Job attempted to be run by the logging component
eventPBSRerun PBSRerun
Job rerun requested
eventPBSDone PBSDone
Job terminated
eventPBSDequeued PBSDequeued
Job dequeued
eventPBSResourceUsage PBSResourceUsage
Resources requested/consumed
eventPBSError PBSError
Any error occured
eventCondorMatch CondorMatch
Job MATCHed
eventCondorReject CondorReject
Job REJECTed
eventCondorShadowStarted CondorShadowStarted
Condor Shadow Started
eventCondorShadowExited CondorShadowExited
Condor Shadow Exited
eventCondorStarterStarted CondorStarterStarted
Condor Starter Started
eventCondorStarterExited CondorStarterExited
Condor Starter Exited
eventCondorResourceUsage CondorResourceUsage
Resources requested/consumed
eventCondorError CondorError
Any Error occured

eventAbort

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string reason
Reason why the job was aborted by the system.

eventAccepted

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
eventSource from
The software component the job was received from.
xsd:string fromHost
Hostname of the component the job was received from.
xsd:string fromInstance
(optional) Instance of the component the job was received from.
xsd:string localJobid
(optional) New job id as assigned by the receiving component.

eventCancel

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
CancelStatusCode statusCode
Classification of the attempt to cancel the job (REQ, REFUSE, DONE or ABORT).
xsd:string reason
(optional) Detailed description of the attempt to cancel the job, especially the reason of failure.

eventChangeACL

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string userId
DN or VOMS parameter (in format VO:group).
xsd:int userIdType
Type of information given in user_id (DN or VOMS).
xsd:int permission
ACL permission to change (currently only READ).
xsd:int permissionType
Type of permission requested ('allow', 'deny').
xsd:int operation
Operation requested to perform with ACL (add, remove).

eventChkpt

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string tag
Application specific checkpoint tag.
xsd:string classad
Application specific checkpoint value.

eventClear

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
ClearReason reason
Description of the reason why the job was cleared and the output sandbox removed (USER, TIMEOUT or NOOUTPUT).

eventCollectionState

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string state
New collection state.
xsd:int doneCode
(optional) In case of (state == Done) contains done code
xsd:string histogram
User readable histogram; useful for debugging.
xsd:string child
JobId of subjob, which triggered the state change.
xsd:string childEvent
Event which triggered the state change.

eventCondorError

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string errorDesc
Error reason

eventCondorMatch

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string owner
Owner
xsd:string destHost
Matched host
xsd:string preempting
(optional) Preempting

eventCondorReject

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string owner
Owner
CondorRejectStatusCode statusCode
Reason code for the rejection of the job

eventCondorResourceUsage

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
CondorResourceUsageUsage usage
Type of record
xsd:string name
Name of resource
xsd:double quantity
(optional) The quantity
xsd:string unit
Units (sec, kB, etc.)

eventCondorShadowExited

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:int shadowPid
PID of shadow process
xsd:int shadowExitStatus
Exit status of shadow process

eventCondorShadowStarted

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string shadowHost
Shadow host
xsd:int shadowPort
Shadow port
xsd:int shadowPid
PID of shadow process
xsd:string shadowStatus
(optional) Shadow status

eventCondorStarterExited

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:int starterPid
(optional) PID of starter process
xsd:int starterExitStatus
(optional) Exit status of starter process
xsd:int jobPid
(optional) PID of running job
xsd:int jobExitStatus
(optional) Job exit status

eventCondorStarterStarted

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:int starterPid
(optional) PID of starter process
xsd:string universe
(optional) Condor Universe

eventCurDescr

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string descr
Description of the current job transformation (output of the helper).

eventDeQueued

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string queue
Name of the queue the job was obtained from.
xsd:string localJobid
(optional) New job id as assigned by the retreiving component.

eventDone

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
DoneStatusCode statusCode
Reason code for the termination of the job (OK, FAILED or CANCELLED).
xsd:string reason
(optional) Detailed description why the job was terminated.
xsd:int exitCode
Exit code of the job's process.

eventEnQueued

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string queue
Queue into which the job has been stored for retrieval by another component.
xsd:string job
(optional) Job description in the receiver's language.
EnQueuedResult result
Result code of the attempt to put job into the queue (START, OK, REFUSED or FAIL).
xsd:string reason
(optional) Detailed description of the attempt to enqueue the job, especially the reason of failure.

eventHelperCall

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string helperName
Name of the called helper component.
xsd:string helperParams
(optional) Parameters of the call to the helper component.
HelperCallSrcRole srcRole
The role the event sender is playing in the helper call (CALLING or CALLEE).

eventHelperReturn

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string helperName
Name of the called helper component.
xsd:string retval
(optional) Data returned by the call to the helper component.
HelperReturnSrcRole srcRole
The role the event sender is playing in the helper call (CALLING or CALLEE).

eventListener

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string svcName
Name of the port instance for interactive job control.
xsd:string svcHost
Hostname of the interactive job controller.
xsd:int svcPort
Port number of the interactive job controller.

eventMatch

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string destId
Identification of the queue on the CE that the job could be send to.

eventNotification

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string notifId
Notification id.
xsd:string owner
Identification of the job owner (certificate subject).
xsd:string destHost
Hostname the notification is sent to.
xsd:int destPort
Port number the notification is sent to.
xsd:int expires
When the notification expires
xsd:string jobstat
Status of the job (the notification content).

eventPBSDequeued

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).

eventPBSDone

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:int exitStatus
(optional) Exit status

eventPBSError

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string errorDesc
Error reason

eventPBSMatch

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string destHost
Aka exec_host

eventPBSPending

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string reason
Reasons of job pendation or errors

eventPBSQueued

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string queue
Queue name
xsd:string owner
Job owner
xsd:string name
Job name

eventPBSRerun

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).

eventPBSResourceUsage

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
PBSResourceUsageUsage usage
Type of record
xsd:string name
Name of resource
xsd:double quantity
(optional) The quantity
xsd:string unit
Units (sec, kB, etc.)

eventPBSRun

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string scheduler
(optional) Scheduler ID
xsd:string destHost
(optional) Where to run the job
xsd:int pid
(optional) Actual process ID

eventPending

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string reason
Description why the matching CE for the job was not found (yet).

eventPurge

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).

eventReallyRunning

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string wnSeq
(optional) Sequence code on the worker node.

eventRefused

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
eventSource from
The software component that tried to send the job.
xsd:string fromHost
Hostname of the component that tried to send the job.
xsd:string fromInstance
(optional) Instance of the component that tried to send the job.
xsd:string reason
(optional) Description of the reason why the job was refused.

eventRegJob

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string jdl
(optional) Job description of the job being registered.
xsd:string ns
NetworkServer handling the newly registered job.
xsd:string parent
(optional) Grid job id of the parent job registering this new one.
RegJobJobtype jobtype
Type of the job being registered (SIMPLE, DAG, PARTITIONABLE or PARTITIONED).
xsd:int nsubjobs
(optional) Number of subjobs this job plans to spawn.
xsd:string seed
(optional) Seed for subjob id generation.

eventResourceUsage

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string resource
Resource's name.
xsd:double quantity
Resources's quantity (how much).
xsd:string unit
Units (sec, kB, etc.).

eventResubmission

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
ResubmissionResult result
Result code of the resubmission decision (WILLRESUB or WONTRESUB or SHALLOW).
xsd:string reason
(optional) Reason why the job will or will not be resubmitted.
xsd:string tag
(optional) Value of the attribute on which the decision to resubmit the job was based.

eventResume

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string reason
(optional) Reason for the resume.

eventRunning

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string node
Worker node on which the job executable is being run.

eventSource

Possible sources of LB events.

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

UserInterface
NetworkServer
WorkloadManager
BigHelper
JobSubmission
LogMonitor
LRMS
Application
LBServer

eventSuspend

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string reason
(optional) Reason for the suspend.

eventTransfer

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
eventSource destination
Destination where the job is being transfered to.
xsd:string destHost
Hostname of server that takes over control of the job.
xsd:string destInstance
(optional) Service (instance) that takes over control of the job.
xsd:string job
Job description in receiver's language.
TransferResult result
Result code of the transfer attempt (START, OK, REFUSED or FAIL).
xsd:string reason
(optional) Detailed description of the transfer, especially reason of failure.
xsd:string destJobid
(optional) Job id as assigned by the receiving software component.

eventUserTag

Structure (sequence complex type in WSDL)

Fields: ( type name description )

timeval timestamp
Time the event was generated.
timeval arrived
(optional) Time the event was stored into the bookkeeping server database.
xsd:string host
Hostname of the machine where the event was generated.
Level level
Logging level (in the range from DEBUG to EMERGENCY).
xsd:int priority
Message priority (yet 0 for asynchronous and 1 for synchronous transfers).
xsd:string jobId
Grid job id of the job the event belongs to.
xsd:string seqcode
Sequence code assigned to the event.
xsd:string user
Identity (certificate subject) of the event sender.
eventSource source
Source (software component) which generated this event.
xsd:string srcInstance
(optional) Instance of source component (e.g. service communication endpoint).
xsd:string name
Arbitrary user tag name.
xsd:string value
Arbitrary user tag value.

genericFault

Generic SOAP fault, used to deliver any LB errors.

Structure (sequence complex type in WSDL)

Fields: ( type name description )

xsd:string source
(optional) Source component (module) of the error.
xsd:int code
Numeric error code.
xsd:string text
Error text corresponding to the code.
xsd:string description
(optional) Additional description of the error (e.g. filename)
genericFault reason
(optional) Reason of the error, coming from lower levels.

jobFlags

Flags determining which fields of job status should be retrieved. Can be combined arbitrarily.

Flags (sequence of restricted xsd:string in WSDL), any number of values can be specified together.

Values:

CLASSADS
Include also long job descriptions (JDL).
CHILDREN
Return list of subjobs of a DAG.
CHILDSTAT
Return state of the subjobs, i.e. apply other flags recursively
CHILDHIST_FAST
Return a histogram of subjob states (fast computation method, certain subjobs will be in an "unknown" state)
CHILDHIST_THOROUGH
Return a full histogram of subjob states.

jobStatus

Status of a job, possibly including subjobs.

Structure (sequence complex type in WSDL)

Fields: ( type name description )

statName state
Status name.
xsd:string jobId
Id of the job
xsd:string owner
Job owner
jobtype jobtype
Type of job
xsd:string parentJob
parent job of subjob
xsd:string seed
string used for generation of subjob IDs
xsd:int childrenNum
number of subjobs
list of xsd:string children
list of subjob IDs
list of childrenHistItem childrenHist
(optional) summary (histogram) of children job states
list of jobStatus childrenStates
full status information of the children
xsd:string condorId
Id within Condor-G
xsd:string globusId
Globus allocated Id
xsd:string localId
Id within LRMS
xsd:string jdl
User submitted job description
xsd:string matchedJdl
Full job description after matchmaking
xsd:string destination
ID of CE where the job is being sent
xsd:string condorJdl
ClassAd passed to Condor-G for last job execution
xsd:string rsl
Job RSL sent to Globus
xsd:string reason
Reason of being in this status, if any
xsd:string location
Where the job is being processed
xsd:string ceNode
Worker node where the job is executed
xsd:string networkServer
Network server handling the job
xsd:boolean subjobFailed
Subjob failed (the parent job will fail too)
doneCode doneCode
Return code
xsd:int exitCode
Unix exit code
xsd:boolean resubmitted
The job was resubmitted
xsd:boolean cancelling
Cancellation request in progress
xsd:string cancelReason
Reason of cancel
xsd:int cpuTime
Consumed CPU time
list of tagValue userTags
List of pairs (user_tag, user_value)
timeval stateEnterTime
When entered this status
timeval lastUpdateTime
Last known event of the job
list of stateEnterTimesItem stateEnterTimes
(optional) When all previous states were entered
xsd:boolean expectUpdate
Some logged information has not arrived yet
xsd:string expectFrom
Sources of the missing information
xsd:string acl
ACL of the job
xsd:boolean payloadRunning
User payload started
list of xsd:string possibleDestinations
Possible job destinations
list of xsd:string possibleCeNodes
CE nodes matching to possible_destinations
xsd:boolean suspended
Job is suspended
xsd:string suspendReason
Reason for the suspend
xsd:string failureReasons
Concatenated job failure reasons, possibly from deeper middleware layers
xsd:string uiHost
Hostname or address of UI used to submit the job
xsd:string pbsState
Job state which would probably return PBS qstat (Q/R/C/....)
xsd:string pbsQueue
Name of queue in which is job queued
xsd:string pbsOwner
Owner of job
xsd:string pbsName
Name of job
xsd:string pbsReason
Glued reasons/errors leading to pending events
xsd:string pbsScheduler
Name of pbs scheduler
xsd:string pbsDestHost
Hostname of node where job is running
xsd:int pbsPid
PID of running job
xsd:string pbsResourceUsage
Glued resource usage
xsd:int pbsExitStatus
Job exit status
xsd:string pbsErrorDesc
Glued error descriptions from error events
xsd:string condorStatus
Condor job status
xsd:string condorUniverse
Condor job Universe (in job ClassAds)
xsd:string condorOwner
Job owner
xsd:string condorPreempting
Job preempting
xsd:int condorShadowPid
PID of Shadow
xsd:int condorShadowExitStatus
Condor shadow exit status (see h/exit.h)
xsd:int condorStarterPid
PID of Starter
xsd:int condorStarterExitStatus
Condor starter exit status
xsd:int condorJobPid
PID of running job
xsd:int condorJobExitStatus
Job exit status
xsd:string condorDestHost
Hostname of node where job is running
xsd:string condorReason
Glued reasons/errors leading to pending events
xsd:string condorErrorDesc
Glued error descriptions from error events

jobtype

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

SIMPLE
simple job
DAG
composite job
_PARTITIONABLE_UNUSED
placholder for unused code
_PARTITIONED_UNUSED
placholder for unused code
COLLECTION
parent of collection of jobs
PBS
PBS job
CONDOR
Condor job

queryAttr

Specification of a job attribute in query.

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

JOBID
A concrete JobId
OWNER
Owner of the job (X509 certificate subject).
STATUS
Status of the job (see statName type).
LOCATION
Where the job is currently handled (hostname).
DESTINATION
Where the job is or was scheduled to be executed.
DONECODE
How the job terminated (see doneCode type)
USERTAG
Value of particular user tag. The tag name has to be specified in queryConditions.tagName.
TIME
When the job entered a particular state. The state has to be specified in queryCondition.statName.
RESUBMITTED
The job was resubmitted.
PARENT
JobId of the job parend (DAG).
EXITCODE
UNIX exit code of the job.
HOST
Where the event was generated.
SOURCE
Source component.
INSTANCE
Instance of the source component.
EVENTTYPE
Event type.
CHKPTTAG
Checkpoint tag.

queryConditions

An element of outer list of query conditions in job queries. It expresses possibly several conditions (records) on a single job attribute. These conditions are logically OR-ed.

Structure (sequence complex type in WSDL)

Fields: ( type name description )

queryAttr attr
The job attribute to which the query conditions apply.
xsd:string tagName
(optional) Name of the queried user tag if attr is USERTAG.
statName statName
(optional) Name of the job state to which "attr = TIME" condition refers.
list of queryRecord record
The conditions.

queryOp

Relational operator of query conditions.

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

EQUAL
Attribute is equal to the specified value
LESS
Attribute is less than the specified value or equal
GREATER
Attribute is greater than the specified value or equal
WITHIN
Attribute is withing a range (queryRecord.value2 must be specified)
UNEQUAL
Attribute is not equal to the specified value.

queryRecValue

A value to compare an attribute with in queries. Exactly one of the elements must be specified.

Union (choice complex type in WSDL)

Fields: ( type name description )

xsd:int i
Integer.
xsd:string c
String.
timeval t
Timestamp.

queryRecord

A single query condition.

Structure (sequence complex type in WSDL)

Fields: ( type name description )

queryOp op
Relational operator of the condition.
queryRecValue value1
Value to compare the attribute with.
queryRecValue value2
(optional) Another value to compare the attribute with (op = WITHIN only).

statName

Enumeration (restriction of xsd:string in WSDL), exactly one of the values must be specified.

Values:

SUBMITTED
Entered by the user to the User Interface or registered by Job Partitioner.
WAITING
Accepted by WMS, waiting for resource allocation.
READY
Matching resources found.
SCHEDULED
Accepted by LRMS queue.
RUNNING
Executable is running.
DONE
Execution finished, output is available.
CLEARED
Output transfered back to user and freed.
ABORTED
Aborted by system (at any stage).
CANCELLED
Cancelled by user.
UNKNOWN
Status cannot be determined.
PURGED
Job has been purged from bookkeeping server (for LB->RGMA interface).

stateEnterTimesItem

Structure (sequence complex type in WSDL)

Fields: ( type name description )

statName state
The job state.
xsd:dateTime time
When the state was entered last time.

tagValue

Structure (sequence complex type in WSDL)

Fields: ( type name description )

xsd:string tag
xsd:string value
(optional)

timeval

Structure (sequence complex type in WSDL)

Fields: ( type name description )

xsd:long tvSec
xsd:long tvUsec