batchJob-BatchJobStepLogFileView

The Batch Job Step Log File View shows details for one provisioning job step executed and completed against a single station. It is the default view for any batch job step log file (.bjsl extension). You access this view on a completed step by clicking the details button (>>) at the end of a step row in the Niagara Network Job View or Station Job List.

This view provides a summary table, which lists the log messages that occurred during step execution. To view additional Log Details, if any, for a specific step, double-click a step row.

Figure 84. Batch Job Step Log File View lists details on one step for a station.

From top-to-bottom this view has three areas:

Step elements, which are read-only
Step log table
Buttons

Step elements

Elements	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 [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).

Columns

Elements, columns and buttons	Value	Description
Status or State	read-only text	Displays the current or final state of each step: `Running` — the step is executing. `Canceling` — the request to cancel the step was sent, but has not been processed yet. The step is still running. `Success` — the step finished successfully. `Canceled` — the step was canceled before it completed and is no longer running. `Failed` — the step did not complete Each row in the table ends with a details button (>>) and a dispose button (X) . This button functions the same as the Step Details button at the bottom of the view. The overall status for the step in other stations, may be different).
File	text (visible only if a Backup Stations step)	Identifies the file path and name on the Supervisor for the saved backup .dist file. It uses the convention: `^provisioningNiagara/stationData/stationName/backups/backup_stationName_yymmdd_hhmm.dist`
Timestamp	date and time	Displays the date and time when the log message was written.
Message	text	Displays the log message.
Details	text	Provides additional information (or the beginning of such information) related to the step.

Batch Job Step File Log View buttons

Button	Value	Description
Job Summary	button always enabled	Changes to the Batch Job Log File View for the job that contains this step.
Refresh Log	button enabled when information needs to be refreshed	Recreates the log.
Restore	button available if the job step is Backup Station and the backup completed successfully	Restores the station using the .dist file saved from this provisioning job. If you answer Yes to the confirmation window (no undo), an install backup job executes immediately and the view changes to the Niagara Network Job View.

Run Robot buttons

Selecting a Run Robot step provides additional robot-specific buttons near the bottom of the view.

Figure 85. Run Robot step in Batch Job Step Log File View

Button	Value	Description
Job Summary	button always enabled	Changes to the Batch Job Log File View for the job that contains this step.
Refresh Log	button enabled when information needs to be refreshed	Recreates the log.
Robot Source	button always enabled	Displays a read-only listing of the ProvisioningRobot code u sed in the Run Robot step.
Robot Log	button always enabled	Displays any text written by the system to the robot’s log PrintWriter during the execution of the step.