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