Status description and mapping for distributed jobs
The job status as described in Dynamic Workload Console and how it is defined in HCL Workload Automation.
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 HCL Workload Automation for Z 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 lists
the job statuses.
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 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.
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 HCL Workload Automation 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 describes
how a job status is mapped to the corresponding job internal status.
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 |