Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Overview


6.1 Status levels of jobnets, jobs, and jobnet connectors

The following table lists the statuses that apply to jobnets, jobs, and jobnet connectors.

Table 6‒1: Status levels of jobnets, jobs, and jobnet connectors

Status

Applicability

Explanation

Jobnet

Job

Jobnet connector

Root

Nested

Not sched. to exe.

(no plan)

Y

Y

Y

Y

No execution schedule is defined.

Wait for start time#1

(time-wait)

Y

Y

N

N

Waiting for the execution start time to arrive.#2

If synchronized with a jobnet connector, the jobnet is waiting for the start time of the jobnet connector.

Wait for prev. to end

(term-wait)

N

Y

Y

Y

Waiting for the preceding job or jobnet to end.

Even if no preceding unit exists, the unit will be placed in this status if any of the following conditions applies:

  • The upper-level jobnet is in wait state.

  • The scheduler service is suspended.

  • The execution process for the unit has not started even though the start condition of the upper-level jobnet has been satisfied.

Being held#1

(holding)

Y

Y

Y

N

The job or jobnet is being held.

Waiting to execute

(exec-wait)

N

N

Y

N

Waiting for the job's submit process to complete.

This status applies after a job has been submitted by scheduler control, until it is queued by job execution control.

Not executed + Ended (not scheduled)#3

(unexec)

N

Y#4, #5

Y#4, #5

Y

The job or jobnet was not executed because the preceding unit ended abnormally#11.

--

(unexec-W)

N

Y

Y

N

The job or jobnet ended with a warning, and the attempted rerun was unsuccessful.

Bypassed#1

(bypass)

N

Y

Y

Y

The job or jobnet was not executed because the schedules of the nested jobnet and the upper-level jobnet did not match, or execution was prohibited, for example.

Now running#1

(running)

Y

Y

Y

Y

The job or jobnet is being executed.

The jobnet connector is waiting for the connection-destination jobnet to end.

Now queuing#1

(queuing)

N

N

Y

N

The start condition has been satisfied and the job is waiting to be executed.

Running + Abend#1

(AB-cont)

Y

Y

N

Y

Jobs or nested jobnets running concurrently in the same jobnet ended abnormally#11.

An error#12 occurred in the connection-destination jobnet of the jobnet connector.

Running + Warning#1

(WA-cont)

Y

Y

N

Y

Jobs or nested jobnets running concurrently in the same jobnet ended with a warning.

In the case of a jobnet connector, the status of the connection-destination jobnet is also Running + Warning.

Ended normally#1

(normal)

Y

Y

Y

Y

All jobs and jobnets ended normally.

The connection-destination jobnet of the jobnet connector ended normally.

Normal end + False

(normal-false)

N

N

Y

N

The judgment job ended normally, although the result of the preceding unit did not match the judgment condition.

Ended with warning#1

(warning)

Y

Y

Y

Y

The job ended with a warning.

The jobnet contains a job that ended with a warning.

The connection-destination jobnet of the jobnet connector ended with a warning.

Ended abnormally#1

(abnormal)

Y

Y

Y

Y

The job ended abnormally.

The jobnet contains a job or a nested jobnet that ended abnormally#11.

The jobnet connector could not connect to the connection-destination jobnet due to an invalid definition or a communication error.

--

(abnormal-WR)

Y

Y

Y

N

The job or jobnet ended with a warning, and the subsequent rerun ended in the Ended abnormally status.

Skipped so not exe.#3

(exec-deffer)

Y

Y

N

N

The jobnet was not executed because, for example, the JP1/AJS3 - Manager service was not active at the job's scheduled start time, or the base time passed while the root jobnet was being held.#4,#6

A jobnet enters Skipped so not exe. status in the following cases:

  • The jobnet's timeout period elapses while the root jobnet is in Wait for start time or Being held status.#7

  • Schedule skip is selected in Schedule option, and the start time of the next generation arrives before termination of the preceding generation.

  • Schedule skip is selected in Schedule option, and a jobnet that is running in immediate execution mode is again registered for immediate execution.

  • Multi-schedule is selected in Schedule option, but concurrent execution is not enabled for the jobnet. The current generation fails to end, and the root jobnet's timeout period expires before the next generation starts.

  • There are tasks scheduled to be executed on a day when the OVERSCHEDULE environment setting parameter of the scheduler service is set to plan and the scheduler service starts by warm start or disaster recovery start.

  • There are tasks scheduled to be executed before the scheduler service starts by warm start or disaster recovery start when the OVERSCHEDULE environment setting parameter of the scheduler service is set to skip or when registering the jobnet for execution in the Register for Execution dialog box, Execute from next time is selected for Planned time passed when daemon starts.

  • When Do not start monitoring is set for Concurrent exec. of monitoring gen, it is time to start the next monitoring generation, but there is still a generation in the Now monitoring status.

  • When Does not stay with skip is set for Pause exec. gen. for start cond. and concurrent execution is disabled, a generation is already running and the condition for starting the next generation is met.

--

(invalid-seq)

Y

Y

N

N

The execution sequence is in a loop and there is job or jobnet that cannot be executed.

Interrupted#1

(interrupt)

Y

Y

N

N

Execution of the jobnet has been interrupted. There are no abnormally terminated#8 units in the jobnet, but there is a unit that has not been processed (in Not executed + Ended status).

A unit is placed in Not executed + Ended status in the following cases where the preceding unit has not terminated abnormally:#8

  • The jobnet is interrupted from JP1/AJS3 - View or by using the Web GUI, the API, or a command.

  • A queued job is killed and not executed.

  • A queueless job is not executed due to a communication error or other problem.

  • An abnormally terminated#8 job in a jobnet is no longer in abnormally terminated#8 status because it has been re-executed or a status change has been performed.

  • The scheduler service was stopped by executing the ajsstop command with the -j option specified. For the command syntax, see ajsstop in 3. Commands Used for Normal Operations in the manual JP1/Automatic Job Management System 3 Command Reference.

Note that if the scheduler service is started in warm-start mode or disaster-recovery-start mode, root jobnets in Now running, Running + Abend, or Running + Warning status are placed in Interrupted status regardless of the status of the subordinate units.

Killed#1

(kill)

Y

Y

Y

Y

The job or jobnet was killed for one of the following reasons:

  • An error occurred which prevented the end status of the job or jobnet from being determined (for example, the end result could not be written to the file at job execution).

  • The JP1/AJS3 - Manager service stopped while a job was being executed.

  • The system stopped while a job was being executed.

  • The active job was killed.

  • Processing was cancelled because the active job exceeded its specified job execution time.

In the case of a jobnet connector, the root jobnet was killed during execution of the jobnet connector.

--

(kill-WR)

Y

Y

Y

N

The job or jobnet ended with a warning, and the attempted rerun was killed.

Failed to start#1

(fail)

N

N

Y

N

Process creation failed when the job started, or the environment settings for the process could not be set.

--

(fail-WR)

N

N

Y

N

The job ended with a warning, and the attempted rerun failed to start.

Unknown end status#1

(unknown)

N

N

Y

Y

The end status is unknown for either of the following reasons:

  • An error occurred which prevented the end status of the job from being determined. For example, the end result could not be written to the file at job execution.

  • The JP1/AJS3 - Manager service stopped and the system shut down while the job was being executed.

In the case of a jobnet connector, a warm start or disaster recovery start mode was performed during execution.

--

(unknown-WR)

N

N

Y

N

The job ended with a warning, and the end status of the attempted rerun is unknown.

Shutdown

(shutdown)

Y

Y

Y

Y

A jobnet was registered for planned execution, but a non-existent unit is specified in the jobnet's exclusive schedule or in the calendar referenced in the jobnet's schedule information.

Wait for start cond.

(condition-wait)

Y

Y#9

N

N

The jobnet is waiting for the start condition to be satisfied. If concurrent execution is disabled and another jobnet is running, the jobnet keeps waiting for the start condition even if it has already been satisfied.

Now monitoring

(monitoring)

Y

Y#9

N

N

The jobnet is monitoring for the events defined in the start condition.

Unmonitored + Ended

(unexec-monitor)

Y

Y#9

N

N

The operation time expired before the start condition was satisfied.

Monitor terminated#10

(monitor-close)

Y

Y#9

N

N

The jobnet that was monitoring for a start condition to be satisfied was interrupted or killed.

Interrupted monitoring#10

(monitor-intrpt)

Y

Y#9

Y#9

N

Monitoring by a jobnet with a start condition was interrupted by the process that stops the scheduler service. The scheduler service was stopped either in restricted mode (job control, jobnet control, or schedule control option specified) or by forced termination (killing active jobs first).

In this case, when the scheduler service is started the next time by hot start or warm start, or when suppression of job execution is canceled after disaster recovery start is performed, monitoring is restarted based on the latest definition of the event job specified in the start condition.

Monitor-end normal#10

(monitor-normal)

Y

Y#9

N

N

The start condition was satisfied within the valid range (specified execution count or monitoring period).

End delay

(end-delay)

Y

Y

Y

N

An end delay has occurred.

Start delay

(start-delay)

Y

Y

N

N

A start delay has occurred.

Nested jobnet delayed end

(nest-end-delay)

Y

Y

N

N

An end delay has occurred in a lower-level unit.

Nested jobnet delayed start

(nest-start-delay)

Y

Y

N

N

A start delay has occurred in a nested jobnet.

Legend:

Root : Root jobnet

Nested : Nested jobnet

Y : Displayed.

N : Not displayed.

-- : Not applicable

#1

If you execute the ajsshow command to display the status, an -R mark, indicating rerun, is added to a unit that meets one of the following conditions:

  • A unit that was rerun in a rerun operation

  • A jobnet that contains a unit that was rerun

  • A unit operating after the rerun in the root jobnet that contains rerun units

An -R mark is not added to a nested jobnet that is already in the Now running status when the rerun starts or to units included in that nested jobnet. If you rerun only specific units by specifying the Only this unit option, the -R mark is not added to succeeding units because they are not included in the rerun.

For the ajsshow command syntax, see ajsshow in 3. Commands Used for Normal Operations in the manual JP1/Automatic Job Management System 3 Command Reference.

#2

This status includes cases in which a jobnet generation whose start time has arrived or a re-executed jobnet generation is waiting for another jobnet generation that is being executed when concurrent execution for the jobnet is disabled. It also includes cases in which the execution suppression function is suppressing the start of jobnet execution.

#3

For the Not executed + Ended and Skipped so not exe. status levels, you can distinguish between units that are scheduled and not scheduled in JP1/AJS3 - View by displaying them with different colored icons. This is not possible when the status name is only displayed in text format, or in the command output.

A jobnet becomes scheduled when an execution schedule (scheduled start time) has been set but the jobnet has not yet been executed. If no execution schedule has been set, the status of the job is not scheduled.

A job becomes scheduled when an execution schedule (scheduled start time) has been set for an upper-level jobnet, and the job has not been prohibited. In all other cases the job has not scheduled status.

In JP1/AJS3 - View, you can set different colors for the scheduled and not scheduled statuses using the General page in the Preferences dialog box. For details, see 12.3.42 Preferences dialog box in the JP1/Automatic Job Management System 3 Operator's Guide and 12.3.44 Select Color dialog box in the JP1/Automatic Job Management System 3 Operator's Guide.

By using the Web GUI, you can set different colors for the scheduled and not scheduled statuses by using the display color settings file (ajs3web_color.conf). For details, see the section corresponding to the OS. For Windows, see 3.4.8 Details on the settings in the display color settings file (ajs3web_color.conf) in the JP1/Automatic Job Management System 3 Configuration Guide. For Linux, see 13.3.8 Details on the settings in the display color settings file (ajs3web_color.conf) in the JP1/Automatic Job Management System 3 Configuration Guide.

#4

All nest jobnets or remote jobnets that are subordinate to a jobnet that has been placed in the Skipped so not exe. status are placed in the Skipped so not exe. status regardless of whether they have been scheduled. The jobs in those jobnets are placed in the Not executed + Ended status.

However, in the case where no start conditions are used, when the root jobnet is placed in the Skipped so not exe. status, the event job defined as a start condition enters Bypassed.

#5

The jobnet is placed in the Not executed + Ended status even when the upper-level jobnet has been placed in the Skipped so not exe. status.

#6

The next execution schedule is also placed in the Skipped so not exe. status. If successive generations are placed in this status, only the generation whose start time is closest to the current time remains. However, this does not apply when successive execution generations of a jobnet with a start condition are placed in the Skipped so not exe. status.

#7

A jobnet with a timeout period of one day is still placed in Skipped so not exe. status if it is registered for execution immediately before the base time and the timeout period elapses before the jobnet is executed.

#8

Abnormal termination shown here indicates one of the following abnormal termination statuses (Not executed + Ended is not included, which indicates that the unit was not executed):

  • Ended abnormally

  • Interrupted

  • Invalid exe. seq.

  • Killed

  • Failed to start

  • Unknown end status

  • Skipped so not exe.

#9

This status might only be displayed for a start condition (.CONDITION) or for a jobnet for which a start condition is defined. The Interrupted monitoring status might also be displayed for an event job defined in the start condition.

#10

The status of units that belong to a root jobnet is Not executed + Ended.

#11

Abnormal end is one of the following statuses:

  • Ended abnormally

  • Not executed + Ended

  • Interrupted

  • Invalid exe. seq.

  • Killed

  • Failed to start

  • Unknown end status

  • Skipped so not exe.

#12

For details, see 2.2.4(4) Transitions of jobnet connector and connection-destination jobnet statuses in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.

Supplementary notes
  • JP1/AJS3 - View includes a function for displaying a colored icon (yellow by default) for waiting units for which a hold attribute has been set. The color of the icon indicates the hold plan for the unit. Waiting units are those with statuses such as Waiting for start time, Waiting for prev. to end, Waiting to execute and Wait for start cond. In JP1/AJS3 - View, you can access the function for displaying a hold plan in the Preferences dialog box. For details about accessing this function, see the description of the General page in 12.3.42 Preferences dialog box in the JP1/Automatic Job Management System 3 Operator's Guide. You must be running JP1/AJS - Manager and JP1/AJS - View version 06-71 or later to use this function.

  • If you use the function for displaying a hold plan in the Web GUI, specify the necessary settings in the display color settings file (ajs3web_color.conf). For details, see the section corresponding to the OS. For Windows, see 3.4.8 Details on the settings in the display color settings file (ajs3web_color.conf) in the JP1/Automatic Job Management System 3 Configuration Guide. For Linux, see 13.3.8 Details on the settings in the display color settings file (ajs3web_color.conf) in the JP1/Automatic Job Management System 3 Configuration Guide.

  • At termination of a preceding unit that belongs to a Wait for prev. to end jobnet for which the hold attribute is set, the succeeding jobnet moves from Wait for prev. to end to Wait for start time status, and then to Being held status.

  • In JP1/AJS3 - View or JP1/AJS2 - View version 08-50 or later, you can set a filter so that Waiting to execute units for which the hold attribute is set will be included in listings of Being held units in the Monthly Schedule window or Daily Schedule window. To include Waiting to execute units that have the hold attribute in listings of Being held units, in the Filter Settings dialog box select the Being held status includes hold plan check box. For details, see 12.7.11 Filter Settings dialog box in the JP1/Automatic Job Management System 3 Operator's Guide.

  • The scheduled end time for a jobnet or job is displayed together with the execution status. The scheduled end time is calculated based on the average execution time of the job or jobnet in the past (the average processing time of the job or jobnet when it ended normally). For details, see 4.4.2(2) Execution simulation. The actual time taken for a job or jobnet to execute depends on system conditions such as the CPU utilization at the time. The scheduled start time and the scheduled end time are therefore intended only as guidelines.