Status description and mapping for distributed jobs

There are the following types of status for distributed jobs:

Job status: A subset of internal status that is common for both HCL Workload Automation for distributed and IBM Workload Scheduler for z/OS environments.
Job internal status: The HCL Workload Automation job status registered on the workstation where the job is running. The internal status uniquely identifies a job status in HCL Workload Automation.

Job status

Table 1 lists the job statuses.

Table 1. Job status
This job status ...	Means that ...
Waiting	The job is waiting for its dependencies to be resolved.
Ready	The dependencies of the job have been resolved and the job is ready to run.
Running	The job is running.
Successful	The job completed successfully.
Error	The job stopped running with an error.
Canceled	The job was canceled.
Held	The job was put on hold.
Undecided	The job status is currently being checked.
Blocked	The job was blocked because of unfulfilled dependencies.
Suppressed by condition	The job is suppressed because the condition dependencies associated to its predecessors are not satisfied.

Job internal status

Table 2 lists the job internal statuses.

Note: The + flag written beside the INTRO and EXEC statuses means that the job is managed by the local batchman process.

Table 2. Job internal status
This job status ...	Means that ...
ABEND	The job terminated with a nonzero exit code or with an exit code outside the defined RC mapping.
ABEND P	An ABEND confirmation was received, but the job is not completed.
ADD	The job is being submitted.
+AUTOGEN+	A monitoring job automatically created to monitor conditions in condition-based workload automation. For more information, see the section about condition-based workload automation in User's Guide and Reference.
BOUND	For shadow jobs, it means that the shadow job matched a remote job instance in the remote plan. For Workload Scheduler for z/OS Agent, it means that the job is on the JES queue.
CANCEL	The job was canceled.
CANCEL P	The job is pending cancellation. Cancellation is deferred until all of the dependencies, including at time dependencies, are resolved.
DONE	The job completed in an unknown status.
ERROR	For internetwork and cross dependencies only, an error occurred while checking for the remote status.
EXEC	The job is running.
EXTRN	For internetwork dependencies only, the status is unknown. An error occurred, a rerun action was just performed on the job in the external job stream, or the remote job or job stream does not exist.
FAILED	Unable to launch the job.
FENCE	The job's priority is below the fence.
HOLD	The job is awaiting dependency resolution.
INTRO	The job is introduced for launching by the system.
PEND	The job completed, and is awaiting confirmation.
READY	The job is ready to launch, and all dependencies are resolved. If a job fails because the agent is not available, the job is automatically restarted and set to the READY status, waiting for the agent to connect again. As soon as the agent connects again, the job is submitted.
R JOB	The job is running.
SCHED	The job's at time has not arrived.
SUCC	The job completed with an exit code of zero.
SUCC P	A SUCC confirmation was received, but the job is not completed.
SUSP	The job was blocked because of unfulfilled dependencies. For IBM i jobs only, this status indicates that the IBM i job is waiting for a reply to a message. For more information, see Scheduling and monitoring jobs on IBM i systems.
USER STAT	The job was put on hold by the user.
WAIT	The job is waiting to fulfill its dependencies.
WAITD	The job is waiting to fulfill its dependencies.
SUPPRESS	The job is suppressed because the condition dependencies associated to its predecessors are not satisfied.

Job status mapping

Table 3 describes how a job status is mapped to the corresponding job internal status.

Table 3. Job status mapping
This job status ...	Maps to this job internal status
Waiting	ADD, PEND, WAIT, WAITD, INTRO, HOLD
Ready	READY
Running	EXEC, SUCC P, ABEND P, R JOB, BOUND
Successful	SUCC
Error	ABEND, FAILED
Canceled	Status of the job when it was canceled. Canceled flag is set.
Held	Priority = 0, WAIT, READY, USER STAT
Undecided	ERROR, EXTRN
Blocked	SUSP
Suppressed by condition	SUPPR