System-level 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. Variables must be added to the initialization parameters individually and in the order stated in the table below; otherwise, the values will not be populated correctly.

  • 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 Duration Overrun are not recorded for synchronous jobs, on job completion.

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

EXP0001

Resource Inactive

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

RESOURCEID

String

Records the GUID for the idle resource.

EXP0004

Job Cost Overrun

Invoked when the cost of the 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.

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, Subjob ID, and Node Name for the job which has the failed script.

NODEID

Short

JOBID

String

SUBJOBID

String

NODENAME

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 the activity and the 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 stalled job.

EXP0013

Activity Due

Invoked when the activity due date is passed. That is, the 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, Node ID, 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, Subjob ID, and Node Name for the job which has the failed .NET activity.

NODEID

Short

JOBID

String

SUBJOBID

String

NODENAME

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, Subjob ID, and Node Name for the job which has the failed .NET activity.

NODEID

Short

JOBID

String

SUBJOBID

String

NODENAME

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, Subjob ID, and Node Name for the job which has the failed web service activity.

NODEID

Short

JOBID

String

SUBJOBID

String

NODENAME

String

EXP0022

C# Script Activity Failed

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

EMBEDDED PROCESS COUNT

Short

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

NODEID

Short

JOBID

String

SUBJOBID

String

NODENAME

String

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, Subjob ID, and Node Name for the job which has the failed VB .NET Script activity.

NODEID

Short

JOBID

String

SUBJOBID

String

NODENAME

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, Subjob ID, and Node Name for the job which has failed DAS activity.

NODEID

Short

JOBID

String

SUBJOBID

String

NODENAME

String

EXP0035

License/Volume Threshold Alert

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

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

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, Subjob ID, and Node Name for the job which has the failed Transfer activity.

NODEID

Short

JOBID

String

SUBJOBID

String

NODENAME

String

EXP0038

Automatic Activity Failed

Invoked when any automatic activity fails to execute.

EMBEDDED PROCESS COUNT

Short

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

If an activity-specific exception is configured, it takes precedence over the Automatic Activity Failed exception.

NODEID

Short

JOBID

String

SUBJOBID

String

NODENAME

String

EXP0039

License Expiry Alert

Invoked when the license expiry threshold is reached.

EXPIRY

Date

Records the expiration date, name, total available units, and the units expiring for a license.

NAME

String

TOTALUNITS

Long

UNITSEXPIRING

Long