Welcome > System Settings module > Configure the settings for the system > Exceptions > Exception maps and initialization parameters

Exception maps and initialization parameters

In order to fully utilize the functionality that exception maps offer, you must assign variables as initialization parameters to track the source of the exception. See Configure the exception settings for more information.

The exception which offer this functionality and the associated parameters in the order in which they should be added are outlined below.

Note

  • Variables must be added to the initialization parameters individually and in the order stated here or the values will not be populated correctly.

  • When you import a process map with exceptions from TotalAgility 5.5.0 to TotalAgility 7.0.0, the exceptions which are not supported in TotalAgility 7.0.0 are not available within the system and therefore cannot be used in the process.

  • Exceptions are not raised against synchronous jobs as a synchronous job is straight away moved into archive database if archiving and record history are turned on.

  • The Job Cost Overrun and Job Overrun Duration are not recorded for synchronous jobs, on job completion.

The following table displays information on exception codes.

Code

Name

Description

Initialization Parameter

Variable Type

Purpose

EXP0001

Resource Inactive

Invoked when a resource is inactive for more than allowed idle duration defined at the server level.

RESOURCEID

String

Records the GUID for the resource which is idle.

EXP0004

Job Cost Overrun

Invoked when the cost of job exceeds the expected value.

JOBID

String

Records the GUID for the job which exceeds the cost.

EXP0005

Job Overrun Duration

Invoked when a job is completed after the expected due date.

JOBID

String

Records the GUID for the job which exceeds the duration.

EXP0006

Activity Overrun

Invoked when an activity is completed after the due date.

NODENAME

String

Records the name of the activity, GUID, Resource ID, Node ID, Embedded Process Count and Subjob ID of the activity which exceeds the duration.

JOBID

String

RESOURCEID

String

NODEID

Short

EMBEDDED PROCESS COUNT

Short

SUBJOBID

String

EXP0009

Script Object Failed

Invoked when a Script Object fails to execute automatically.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed script.

NODEID

Short

JOBID

String

SUBJOBID

String

EXP0010

Process Stalled

Invoked when a process is stalled in the following cases:

  • When a live usable resource is not available for an activity.

    • No usable resources are assigned to the process.

    • No resources to perform activity and exit condition is not met. For example, expand group resource members but all members are excluded.

  • On activity completion, if the job is not complete and does not have a live activity and its status is active.

JOBID

String

Records the GUID for the job which has stalled.

EXP0013

Activity Overdue

Invoked when an activity crosses the due date. That is, due date for an activity with status as pending, suspended, awaiting allocation, awaiting event or saved is passed but the activity is not taken.

String

Records the Node Name, NodeID, Embedded Process Count, Job ID/GUID, Subjob ID and assigned resource for the activity that has become due.

NODENAME

NODEID

Short

EMBEDDED PROCESS COUNT

Short

JOBID

String

SUBJOBID

String

RESOURCEASSIGNED

Dynamic Complex

EXP0017

Synchronous Processing Failed

Invoked when synchronous processing fails.

JOBID

String

Records the GUID for the synchronous job which has failed.

EXP0018

No Usable Resources

Invoked when no usable resource is assigned to an activity.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed .NET activity.

NODEID

Short

JOBID

String

SUBJOBID

String

EXP0019

.NET Object Failed

Invoked when a .NET object fails to execute when running automatically.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed .NET activity.

NODEID

Short

JOBID

String

SUBJOBID

String

EXP0020

Web Service Failed

Invoked when a Web Service object fails to execute when running automatically.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed web service activity.

NODEID

Short

JOBID

String

SUBJOBID

String

EXP0022

C# Script Activity Failed

Invoked when a C# Script activity fails to execute when running automatically

EMBEDDED PROCESS COUNT

NODEID

JOBID

SUBJOBID

Short

Short

String

String

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed C# Script activity.

EXP0023

VB .NET Script Activity Failed

Invoked when a VB .NET Script activity fails to execute when running automatically.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed VB .NET Script activity.

NODEID

Short

JOBID

String

SUBJOBID

String

EXP0025

Data Access Activity Failed

Invoked when a Data Access activity fails to execute when running automatically.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has failed DAS activity.

NODEID

Short

JOBID

String

SUBJOBID

String

EXP0027

Synchronization Activity Failed

Invoked when a Synchronous activity fails to execute when running automatically.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed Synchronous activity.

NODEID

Short

JOBID

String

SUBJOBID

String

EXP30

Milestone Overdue

Invoked when a milestone in a live job crosses the due date.

JOBID

MILESTONENAME

MILESTONETARGETDATE

String

String

Date

Records the GUID, Milestone Name and Milestone Target Date for the milestone that has become due.

EXP0031

Job Budget Overrun

Invoked when the budget of a job exceeds the expected value.

JOBID

Cost

String

Double

Records the GUID and Cost of a job that exceeds the expected value.

EXP0033

Job Overdue

Invoked when a job crosses the expected finish time. That is, expected finish time for a live job is passed but the job is still active. (The jobs on hold are ignored).

JOBID

FINISHTIME

String

Date

Records the GUID and Finish Time of a job that has become overdue.

Not Defined

Storage Limit

Invoked when storage size is more than the allowed size defined at server level.

CURRENTSIZE

MAXIMUMSIZE

Double

Double

Records the current size and maximum size of the storage limit.

EXP0035

Resource inactive

Invoked when the number of licenses or volumes consumed exceeds the configured thresholds.

Note This is a system level exception which is not available to view in the Exceptions tab within the process.

LICENSE_TYPE

Short

Records the License Type, Remaining Count, Threshold, License Server and Serial Number for the job which has exceeded the number of licenses or volumes, for the configured thresholds.

REMAININGLICENSECOUNT

Long

THRESHOLDVALUE

Long

SERVERNAME

String

SERIALNUMBER

Dynamic Complex

EXP0036

Transfer Activity Failed

Invoked when the transfer of documents to another server fails to execute.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed Transfer activity.

NODEID

Short

JOBID

String

SUBJOBID

String

EXP0037

Document Type Overdue

Invoked when a document type crosses the required date of completion.

JOBID

DOCUMENTTYPENAME

String

String

Records the GUID and Document Type Name when a document type becomes overdue.

Not Applicable

Document Type Overdue

Invoked when the due date on a document has passed without the rule being met.

Note This exception is only set for a document set.

Job ID

Document Type Name

String

String

Records the GUID and Document Type for the job that awaits required documents.