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 1. 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

ElementsValueDescription
Deviceelement
Identifies the station that is being processed or has been processed.
Job Stepelement
Identifies the type of provisioning step: Backup Stations, File Copy, Install Software, etc.
Start or Starteddate 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 Stateread-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 buttonsValueDescription
Status or Stateread-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).

Filetext (visible only if a Backup Stations step)
Identifies the file path and name on theSupervisor for the saved backup .dist file. It uses the convention: ^provisioningNiagara/stationData/stationName/backups/backup_stationName_yymmdd_hhmm.dist
Timestampdate and time
Displays the date and time when the log message was written.
Messagetext
Displays the log message.
Detailstext
Provides additional information (or the beginning of such information) related to the step.

Batch Job Step File Log View buttons

ButtonValueDescription
Job Summarybutton always enabledChanges to the Batch Job Log File View for the job that contains this step.
Refresh Logbutton enabled when information needs to be refreshed
Recreates the log.
Restorebutton 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 2. Run Robot step in Batch Job Step Log File View


ButtonValueDescription
Job Summarybutton always enabledChanges to the Batch Job Log File View for the job that contains this step.
Refresh Logbutton enabled when information needs to be refreshed
Recreates the log.
Robot Sourcebutton always enabledDisplays a read-only listing of the ProvisioningRobot code u sed in the Run Robot step.
Robot Logbutton always enabledDisplays any text written by the system to the robot’s log PrintWriter during the execution of the step.