HCL Workload Automation, Version 9.4

Standard format

CPU
The workstation on which the job runs.
Schedule
The name of the job stream.
SchedTime
The time and date when the job was scheduled to run in the plan.
Job
The name of the job. The following notation may precede a job name:
>> rerun as
A job that was rerun with the rerun command, or as a result of automatic recovery.
>> rerun rerun_number of rerun_total
A job that is part of a rerun sequence and its position within the sequence
>> rerun step
A job that was rerun with the rerun ;step command.
>> every run
The second and subsequent runs of an every job.
>> recovery
The run of a recovery job.
State
The state of the job or job stream. Job states are as follows:
ABEND
The job ended with a non-zero exit code.
ABENP
An abend confirmation was received, but the job is not completed.
ADD
The job is being submitted.
CANCL
For internetwork dependencies only. The remote job or job stream has been cancelled.
DONE
The job completed in an unknown state.
ERROR
For internetwork 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.
FAIL
Unable to launch the job.
FENCE
The priority of the job 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.
SCHED
The at time set for the job has not been reached.
SUCC
The job completed with an exit code of zero.
SUCCP
A SUCC confirmation was received, but the job is not completed.
SUPPR
The job is suppressed because the condition dependencies associated to its predecessors are not satisfied.
WAIT
The job is in the WAIT state (extended agent).

Job stream states are as follows:

ABEND
The job stream ended with a nonzero exit code.
ADD
The job stream was added with operator intervention.
CANCELP
The job stream is pending cancellation. Cancellation is deferred until all of the dependencies, including an at time, are resolved.
ERROR
For internetwork dependencies only, an error occurred while checking for the remote status.
EXEC
The job stream is running.
EXTRN
For internetwork dependencies only. This is the state of the EXTERNAL job stream containing jobs referencing to jobs or job streams in the remote network.
HOLD
The job stream is awaiting dependency resolution.
READY
The job stream is ready to launch and all dependencies are resolved.
STUCK
Execution of the job stream was interrupted. No jobs are launched without operator intervention.
SUCC
The job stream completed successfully.
SUPPR
The job stream is suppressed because the condition dependencies associated to its predecessors are not satisfied.
Pr
The priority of the job stream or job. A plus sign (+) preceding the priority means the job has been launched.
(Est)Start
The start time of the job stream or job. Parentheses indicate an estimate of the start time. If the command is performed on the same day when the job is scheduled to run, the Start parameter displays a time as (Est)Start. If the command is performed on a day different from the day when the job is scheduled to run, the Start parameter displays a date as (Est)Start. For example if you have the following job whose start time occurs on the same day when the job is scheduled to run:
SCHEDULE MASTERB1#JS_B 
ON RUNCYCLE RULE1 "FREQ=DAILY;"
AT 1700 
:
MASTERB1#JOB1
 AT 1800 
END
You receive the following output:
%sj @#@
                                            (Est)  (Est)
CPU      Schedule SchedTime  Job   State Pr Start  Elapse RetCode Deps
MASTERB1#JS_B     1700 08/18 ***** HOLD  10(17:00)
                             JOB1  HOLD  10(18:00)
For example if you have the following job whose start time occurs on a day different from the day when the job is scheduled to run:
SCHEDULE MASTERB1#JS_A 
ON RUNCYCLE RULE1 "FREQ=DAILY;"
AT 0400 
:
MASTERB1#JOB_A
 AT 0500 
END
You receive the following output:
%sj @#@
                                            (Est)  (Est)
CPU      Schedule SchedTime  Job   State Pr Start  Elapse RetCode Deps
MASTERB1#JS_A     0400 08/19 ***** HOLD  10(08/19)
                             JOB_A HOLD  10(08/19)
(Est)Elapse
The run time of the job stream or job. Parentheses indicate an estimate based on logged statistics.
dependencies
A list of job dependencies and comments. Any combination of the following can be listed:
  • For a follows dependency, a job stream or job name is displayed.

    If the job or job stream is a pending predecessor, its name is followed by a [P].

    In case of an orphaned dependency an [O] is displayed.

    For conditional dependencies, the name of the predecessor job or job stream is displayed followed by one or more output conditions in the format, IF <condition_name> ... where condition_name can represent the execution status of the predecessor job or job stream, the job or job stream status, or other conditions based on the output or outcome of the predecessor job. When there is more than one condition specified, the conditions are separated by the pipe (|) symbol. The following is what appears in the showjob output in the Dependencies column for a predecessor job, JOBL1, with several output conditions set on it. Whichever condition is satisfied determines which successor job runs:
    JOBL1 IF EXEC
      | STATUS_OK | STATUS_ERR12
    When more than one output condition is aggregated or joined, for example, when 2 conditions out of 2 need to be satisfied before the successor job can run, then the output is displayed as follows:
           JOIN MYJOIN      2 OF
    JOBL1 IF EXEC
    JOBL2 IF ABEND  

    For more information on pending predecessors and orphaned dependencies refer to Managing external follows dependencies for jobs and job streams.

  • For an opens dependency, the file name is displayed. If the file resides on an extended agent and its name is longer than 25 characters, only the last 25 characters are displayed.
  • For a needs dependency, a resource name enclosed in hyphens (-) is displayed. If the number of units requested is greater than one, the number is displayed before the first hyphen.
  • For a deadline time, the time preceded by an angle bracket (<) is displayed.
  • For an every rate, the repetition rate preceded by an ampersand (&) is displayed.
  • For an until time, the time preceded by an angle bracket (<) is displayed.
  • For a maximum duration time that is exceeded, [MaxDurationExceeded] is displayed in addition to the setting maxdur=hhh:mm.
  • For a maximum duration time that is exceeded, and for which the onmaxdur action is set to Kill, [KillSubmitted] is displayed.
  • For a maximum duration time that is exceeded, and for which the onmaxdur action is set to Continue, [Continue] is displayed.
  • For a minimum duration time that is not reached and for which a job completes with success, [MinDurationNotReached] is displayed in addition to the setting mindur=hhh:mm.
  • For a minimum duration time that is not reached, and for which the onmindur action is set to Continue, [Continue] is displayed.
  • For a minimum duration time that is not reached, and for which the onmindur action is set to Abend, [Abended] is displayed.
  • For a minimum duration time that is not reached, and for which the onmindur action is set to Confirm, [ConfirmSubmitted] is displayed.
  • For a prompt dependency, the prompt number is displayed in the format #num. For global prompts, the prompt name follows in parentheses.
  • For running jobs, the process identification number (PID) is displayed in the format #Jnnnnn.
  • Jobs submitted on UNIX using the HCL Workload Automation at and batch commands are labeled [Userjcl].
  • When reporting time dependencies the showjobs command shows in the Start column:
    • Only the time hh:mm if the day when the time dependencies is set matches with the day when the showjobs command is run.
    • Only the date MM/DD if the day when the time dependencies is set does not match with the day when the showjobs command is run.
  • Cancelled jobs are labeled [Cancelled].
  • Jobs cancelled with ;pend option are labeled [Cancel Pend].
  • Jobs with expired until times, including jobs cancelled with ;pend option, are labeled [Until].
  • [Recovery] means that operation intervention is required.
  • [Confirmed] means that confirmation is required because the job was scheduled using the confirm keyword.
  • [Script] applies to end-to-end networks only; it means that this job has a centralized script and that IBM Workload Scheduler for z/OS has not yet downloaded it to the agent.

In the Dependencies column is also listed the name of the actual workstation where the job ran. This detail is available only if the job has started and has run on a pool workstation. This information can be useful, for example when you need to determine your license consumption and therefore need to know on which workstation in the pool the job actually ran. For more information about licensing, see ../src_ad/awsadlicensemanagement.htm#licensemanagement .