Exception maps and initialization parameters

To fully use the functionality that an exception map offers, and to track the source of the exception, you must assign variables as initialization variables of the exception map. These initialization variables must be added in a specific order, otherwise the values will not be populated correctly.

The exception codes and associated parameters, and the order in which the variables need to be added as initialization variables of the exception map, are described in the following table.

Code

Name

Description

Initialization parameter

Variable type

Purpose

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 Duration Overrun

Invoked when a job exceeds its expected duration.

JOBID

String

Records the GUID for the job which exceeds the duration.

EXP0006

Activity Overrun

Invoked when an activity exceeds its expected duration.

TASKNAME

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 Due

Invoked when an activity crosses the due date.

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

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

Note If you upgrade from TotalAgility 5.5.0, there are exceptions which are not supported in this version of TotalAgility. These unsupported exceptions will become unavailable within the system, and therefore cannot be used.