batchJob-BatchJobLogFileView

The Batch Job Log File View displays the details for the execution of a single provisioning job that has completed. It is the default view for any batch job log file (.bjl extension). You access this view by clicking the details (>>) button at the end of each row on the Niagara Network Job List or the Prototype Job List. You can also access this view when in the Batch Job Step Log File View by clicking the Job Summary button.

This view provides a summary table showing each step for each station in the job. To view additional Log Details, if any, for a specific step, double-click its row.

Figure 1. Batch Job Log File View lists the steps in one job

This view is nearly identical to the Niagara Network Job View (for a provisioning job that is still under the station’s JobService). From top to bottom, this view has three areas:

Job elements, which are read-only.
A summary table of the steps in the job.
A series of buttons at the bottom.

Elements

Element	Value	Description
User [provisioning]	text	Defines the station user that requested the job. This column displays `unknown` if job was triggered by a linked schedule.
Start or Started	date and time (read-only)	Displays the date and time that the system submitted the job to the job queue.
End or Ended [job]	date and time	Displays the date and time when the job stopped running. This property is blank if the job is still running.
Status or State	read-only text:	Displays the current or final state of the job. The first three states appear on the Device Network Job view. `Unknown` —the job is pending execution. `Running` — the job is executing. `Canceling` — request to cancel the job was sent, but has not been processed yet, and the job is still executing. `Success` — job finished successfully, with all steps completed for all stations. `Canceled` — job was canceled before it completed, and is no longer running. `Failed` — at least one step failed in one station; job is no longer running. Each row in the table ends with a details button (>>) and a dispose button (X) . Clicking this button changes the view to the Niagara Network Job view or the Batch Job Step Log File view, which shows all logged messages that are related to this single job. The overall status for the job in other stations, may be different).
Progress	job steps complete, total step count, percent complete	As the job executes, the progress updates as steps are started and completed. Note that the total step count can change while the job runs due to automated step combination (e.g. for software installation steps), automatic step creation (for license updates), and for step failures (where subsequent steps will not be run).

Table columns

Column	Value	Description
Device	element	Identifies the station that is being processed or has been processed.
Job Step	element	Identifies the type of provisioning step: Backup Stations, File Copy, Install Software, etc.
Start or Started	date and time (read-only)	Displays the date and time that the system submitted the job to the job queue.
End or Ended [step]	date and time	Displays the date and time when the step stopped running. This property is blank if the job is still running.

Buttons

Type	Value	Description
View Log	button enabled when a job row is selected	Opens a popup Job Log window that displays the messages output by the selected job or step.
Job List	button always enabled	Opens the Niagara Network Job List.
Cancel or Cancel Job	button enabled only if a job is running	Clicking this button notifies the system to cancel the job when it is safe to do so. Not all job steps can be canceled.
Cancel Device	button enabled only if a job is running and a step row is selected	For the selected station only, clicking this button notifies the system to cancel the job when it is safe to do so. The system begins processing the job for the next station.
Dispose	button enabled when a job is finished	Clicking this button prompts you to confirm that you want to delete the selected job(s). The deletion includes all associated job files. If you confirm the deletion: The system deletes the job from the JobService (if it is still there and not rolled off as the 11th job, or station restart) The system deletes all associated job files including the batch job log file, batch log step log files, and other files if applicable. For a backup job, this includes deleting the backup .dist file(s). The system removes the job from the Jobs Table in the ProvisioningNwExt’s Niagara Network Job List. You can select multiple jobs to dispose of at the same time.