System Return Codes of Executable Objects

Various return codes are set while executable objects are processed. A value range between 1000 and 2000 is reserved for them. The system return code is linked to a specific job status.

For more information about UNIX and z/OS return codes, see:

System Return Codes and Assigned Task States in the Workflow and Schedule Objects

In workflows, a task responds to a preceding one. The condition or task status to which a preceding task responds can be selected in the Time & Dependencies tab in the workflow properties.

Example

You can define that a workflow task must run only if its preceding task has ended with an ANY_SKIPPED status. 

ANY_SKIPPED combines conditions that correspond to the following return codes: 1920, 1922, 1930, 1931 and 1940 (table 1).

Accordingly, the task runs if the preceding task ended with one of the following conditions: ENDED_INACTIVE (1920), ENDED_INACTIVE (1922), ENDED_SKIPPED (1930), ENDED_SKIPPED (1931) or ENDED_TIMEOUT (1940).

In workflows, the following states are also possible:

  • ENDED_INACTIVE_MANUAL (equivalent to 1922)
  • ENDED_INACTIV (equivalent to 1920,1921,1922)
  • ENDED_OK_OR_INACTIV (equivalent to 1900,1920,1921,1922)

Note: The ANY_OK_OR_UNBLOCKED status should be used only with external dependencies and only for Workflows. Only Workflows can get unblocked, not Jobs. For more information, see External Dependencies in Workflows.

Available Conditions/Task Status and their Meaning

1600-1799

ANY_WAITING

The task is in a waiting condition.

1800-1899

ANY_ABEND

The preceding task ended abnormally. ANY_ABEND combines all conditions with return codes between 1800 and 1899.

1800-1815

ANY_ABEND_EXCEPT_FAULT

Conditions of ANY_ABEND without FAULT*

1850-1999

ANY_EXCEPT_FAULT

Conditions of ANY_ABEND and ANY_OK without FAULT*

1900-1999

ANY_OK

The preceding task ended without errors. ANY_OK combines all conditions with return codes between 1900 and 1999.

1920,1922,1930,1931,1940, 1941, 1942

ANY_SKIPPED

The preceding task has been skipped. ANY_SKIPPED is a listing of certain conditions (these conditions are also available in ANY_OK).

1850,1851

ENDED_CANCEL

The preceding task has been canceled. The job itself or the whole workflow can have been canceled.

1910

ENDED_EMPTY

The preceding task is empty. The activation has ended without an error message (STOP NOMSG - script statement).

1920, 1912, 1922

ENDED_INACTIV

The preceding task is inactive.

1925

ENDED_INACTIVE_OBJECT

The task is inactive because of its object definition.

1800

ENDED_NOT_OK

The preceding task has been aborted (return code <> 0).

1900

ENDED_OK

The preceding task has ended normally (return code = 0).

1900,1910

ENDED_OK_OR_EMPTY

The preceding task has ended normally or is empty.

1900,1920,1922

ENDED_OK_OR_INACTIV

The preceding task has ended normally or is inactive.

1913

ENDED_ROLLBACK_EMPTY

No rollback defined.

1904

ENDED_ROLLBACKED

Task was rolled back successfully.

1930

ENDED_SKIPPED

The preceding task has been skipped because of a WHEN clause.

1940

ENDED_TIMEOUT

The preceding task has not been executed because of a timeout (WHEN clause).

1815

ENDED_UNDEFINED

The preceding task has ended in an undefined manner (the agent has ended prematurely).

1810

ENDED_VANISHED

The preceding task has vanished.

1905

ENDED_WF_ROLLBACKED

Workflow was rolled back successfully.

1822

FAULT_ALREADY_RUNNING

The group is already running.

1825

FAULT_CUSTOM_BACKUP

Error in custom backup

1827

FAULT_CUSTOM_ROLLBACK

Error in custom rollback

1826

FAULT_FILE_BACKUP

Error in file backup

1828

FAULT_FILE_ROLLBACK

Error in file rollback

1829

FAULT_HOSTGROUP_ROLLBACK

Error in agent group rollback

1830

FAULT_ROLLBACK

General error in rollback

1821

FAULT_NO_HOST

The preceding task could not start because the host is not available.

1820

FAULT_OTHER

The preceding task could not start because of another error.

Conditions with User Return Codes

You can supplement conditions and task states that are predetermined by the system by adding user-defined ones. The following examples show five conditions that are not based on system return codes. They use User Return Codes of Executable Objects.

0100-0200

USER_100_200

The preceding task has ended with a user return code between 100 and 200.

0147

USER_147

The preceding task has ended with the user return code 147.

0201-0299

USER_201_299

The preceding task has ended with a user return code between 201 and 299.

0300

USER_300

The preceding task has ended with the user return code 300.

0500-0600

USER_500_600

The preceding task has ended with a user return code between 500 and 600.

System Return Codes and Assigned Task States During Execution

A task can show various conditions while it is being processed. These conditions correspond to a specified return code.

1300 Preparing

1301 Waiting for user input/a prompt is displayed for the user

1510 Transferred

1520 Ready for transfer (before connect)

1521 Ready to be transferred

1529 Ready for generation

1530 Ready for start

1531 To be called

1540 Start initiated

1541 Checking

1542 Calling

1543 Unknown

1544 Inconsistent

1545 Started

1546 Connecting

1547 Inconsistent Remote Task Manager

1550 Active

1551 Transferring

1552 Called

1553 Accepted

1554 Sampling Files

1556 Escalated

1557 Custom backup

1558 File backup

1560 Workflow is blocked

1561 STOP - Client-wide stop of automatic processing

1562 HELD - Manual stop has been set

1563 STOP - Automatic processing has been stopped

1564 STOP - Queue processing has been stopped

1565 Finished sending task

1569 Skipping Sync object

1570 Skipping

1571 Canceling

1572 Generating

1573 Generated

1574 Post processing

1575 Ending

1576 Regenerating

1578 Scanning files

1579 Scanning reports

1580 Resolving variables

1581 Checking Postconditions

1582 Checking prompt values

1583 LOOPING

1599 Alive user view

1600 Internal checking

1650 Custom rollback

1651 File rollback

1652 Agent group rollback

1653 Workflow rollback

1655 Waiting for rollback

1680 Checking Preconditions

1681 Waiting for user or a prompt is waiting, but the user is not connected to the Automation Engine

1682 Waiting for continuation of variable resolving

1683 Waiting for remote resource

1684 Waiting for queue slot (max. parallel tasks exceeded)

1685 Waiting for post processing host

1686 Waiting for start of agent group container

1687 Waiting for end of parallel agent group tasks

1688 Waiting for the host of an agent group

1689 Waiting for resource (max. file transfers exceeded)

1690 Waiting for external precondition

1691 Waiting for remote system

1692 Waiting for remote SYNC

1693 Waiting for manual release

1694 Waiting for resource (max. jobs exceeded)

1695 Waiting for restart time

1696 Waiting for host

1697 Waiting for SYNC

1698 Waiting for start time

1699 Alive

1700 Waiting for predecessor

1701 Sleeping

1702 Not yet called

1703 Waiting for Preconditions

1705 CHANGING_LOG

1709 Waiting for end of parallel task

1710 Registered

1711 Queued

1800 ENDED_NOT_OK - Aborted

1801 ENDED_NOT_OK - Aborted because of SYNC condition

1802 ENDED_JP_ABEND - Not executed because of abnormal workflow end

1810 ENDED_VANISHED - Disappeared

1815 ENDED_LOST - Ended undefined (host terminated prematurely)

1820 FAULT_OTHER - Start impossible. Other error.

1821 FAULT_NO_HOST - Start impossible. Cannot reach host.

1822 FAULT_ALREADY_RUNNING - Task is already running

1823 FAULT_POST_PROCESSING - Error in post processing

1824 FAULT_POST_CONDITION - Error in Post-Condition

1825 FAULT_CUSTOM_BACKUP - Error in custom backup

1826 FAULT_FILE_BACKUP - Error in file backup

1827 FAULT_CUSTOM_ROLLBACK - Error in custom rollback

1828 FAULT_FILE_ROLLBACK - Error in file rollback

1829 FAULT_HOSTGROUP_ROLLBACK - Error in agent group rollback

1830 FAULT_ROLLBACK - General error in rollback

1850 ENDED_CANCEL - Manually canceled

1851 ENDED_JP_CANCEL - Workflow canceled manually

1852 Rejected

1853 ENDED_QUEUE_CANCEL

1854 ENDED_CONTAINER_CANCEL

1856 ENDED_ESCALATED - Aborted due to escalation

1860 Notification failed

1898 Blocked

1899 Status blocked manually removed

1900 ENDED_OK - Ended normally

1901 Confirmed

1902 ENDED_QUEUE_END (status for subordinate tasks of an SAP job that has been ended)

1903 ENDED_CONTAINER_END (status for tasks of an agent group that has been ended)

1904 ENDED_ROLLBACKED - Task was rolled back successfully

1905 ENDED_WF_ROLLBACKED - The workflow was rolled back successfully

1910 ENDED_EMPTY - Task is empty (STOP NOMSG)

1911 ENDED_TRUNCATE - Transfer incomplete because of the line limit

1912 ENDED_EMPTY - Nothing found

1913 ENDED_ROLLBACK_EMPTY - No rollback defined

1919 ENDED_INACTIVE - Inactive due to logical date condition of external dependency

1920 ENDED_INACTIVE - Inactive today because of the calendar

1921 ENDED_INACTIVE - Task is not active because of the definition

1922 ENDED_INACTIVE - Task has manually been set inactive

1923 Deleted

1924 UNPROCESSED

1930 ENDED_SKIPPED - Skipped because of WHEN clause

1931 ENDED_SKIPPED - Skipped because of SYNC condition

1932 ENDED_SKIPPED - Schedule ended prematurely

1933 ENDED_SKIPPED - Skipped because of conditions

1940 ENDED_TIMEOUT - Not executed because of timeout (WHEN clause)

1941 ENDED_TIMEOUT - Start time exceeded

1942 ENDED_TIMEOUT - Ended untimely

1944 ENDED_TIMEOUT - Period stopped

1960 Notification successful

1970 Operation successful

1999 SYNC check passed

Manual Modification of Task States

During execution you can manually change the current status of a task. Right-click the task in the Tasks window of the Process Monitoring perspective and select Modify State Manually. You can assign a new status to the task in the dialog window.

Important! This function manipulates the status that the system has given the task. Use it only in exceptional cases.

See also: