Merge pull request #21734 from LitKnd/sysjobhistory

Refreshing sysjobhistory

Author: ShannonLeavitt

docs/relational-databases/system-tables/dbo-sysjobhistory-transact-sql.md

@@ -1,8 +1,8 @@
 ---
 description: "dbo.sysjobhistory (Transact-SQL)"
-title: "dbo.sysjobhistory (Transact-SQL) | Microsoft Docs"
+title: "dbo.sysjobhistory (Transact-SQL)"
 ms.custom: ""
-ms.date: "06/24/2019"
+ms.date: "04/18/2022"
 ms.prod: sql
 ms.prod_service: "database-engine"
 ms.reviewer: ""
@@ -22,9 +22,9 @@ author: LitKnd
 ms.author: kendralittle
 ---
 # dbo.sysjobhistory (Transact-SQL)
-[!INCLUDE [SQL Server](../../includes/applies-to-version/sqlserver.md)]
+[!INCLUDE [SQL Server SQL MI](../../includes/applies-to-version/sql-asdbmi.md)]
 
-Contains information about the execution of scheduled jobs by [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] Agent.
+Contains information about the execution of scheduled jobs by the [SQL Server Agent](../../ssms/agent/sql-server-agent.md).
 
 > [!NOTE]
 > In most cases the data is updated only after the job step completes and the table typically contains no records for job steps that are currently in progress, but in some cases underlying processes *do* provide information about in progress job steps.
@@ -43,31 +43,43 @@ This table is stored in the **msdb** database.
 |**run_status**|**int**|Status of the job execution:<br /><br /> **0** = Failed<br /><br /> **1** = Succeeded<br /><br /> **2** = Retry<br /><br /> **3** = Canceled<br /><br />**4** = In Progress|  
 |**run_date**|**int**|Date the job or step started execution. For an In Progress history, this is the date/time the history was written.|  
 |**run_time**|**int**|Time the job or step started in **HHMMSS** format.|  
-|**run_duration**|**int**|Elapsed time in the execution of the job or step in **HHMMSS** format.|  
+|**run_duration**|**int**|Elapsed time in the execution of the job or step in **HHMMSS** format for time periods up to 24 hours. Find code to translate longer run durations in [Example](#example).|  
 |**operator_id_emailed**|**int**|ID of the operator notified when the job completed.|  
 |**operator_id_netsent**|**int**|ID of the operator notified by a message when the job completed.|  
 |**operator_id_paged**|**int**|ID of the operator notified by pager when the job completed.|  
 |**retries_attempted**|**int**|Number of retry attempts for the job or step.|  
 |**server**|**sysname**|Name of the server where the job was executed.|  
 
-  ## Example
- The following [!INCLUDE[tsql](../../includes/tsql-md.md)] query will convert the **run_time** and **run_duration** columns into a more user friendly format.  Execute the script in [!INCLUDE[ssManStudioFull](../../includes/ssmanstudiofull-md.md)].
+## Example
+
+The following [!INCLUDE[tsql](../../includes/tsql-md.md)] query converts the **run_time** and **run_duration** columns into a more user friendly format.  Execute the script in [!INCLUDE[ssManStudioFull](../../includes/ssmanstudiofull-md.md)].
 
  ```sql
- SET NOCOUNT ON;
+SET NOCOUNT ON;
 
- SELECT sj.name,
-		sh.run_date,
-		sh.step_name,
-		STUFF(STUFF(RIGHT(REPLICATE('0', 6) +  CAST(sh.run_time as varchar(6)), 6), 3, 0, ':'), 6, 0, ':') 'run_time',
-		CASE WHEN sh.run_duration > 235959 THEN
-		   CAST((CAST(LEFT(CAST(sh.run_duration AS VARCHAR), LEN(CAST(sh.run_duration AS VARCHAR)) - 4) AS INT) / 24) AS VARCHAR)
-		   + '.' + RIGHT('00' + CAST(CAST(LEFT(CAST(sh.run_duration AS VARCHAR), LEN(CAST(sh.run_duration AS VARCHAR)) - 4) AS INT) % 24 AS VARCHAR), 2)
-		   + ':' + STUFF(CAST(RIGHT(CAST(sh.run_duration AS VARCHAR), 4) AS VARCHAR(6)), 3, 0, ':')
-		ELSE
-		   STUFF(STUFF(RIGHT(REPLICATE('0', 6) + CAST(sh.run_duration AS VARCHAR(6)), 6), 3, 0, ':'), 6, 0, ':')
-		END 'LastRunDuration (DD.HH:MM:SS) '
-FROM msdb.dbo.sysjobs sj
+SELECT sj.name,
+    sh.run_date,
+    sh.step_name,
+    STUFF(STUFF(RIGHT(REPLICATE('0', 6) +  CAST(sh.run_time as varchar(6)), 6), 3, 0, ':'), 6, 0, ':') 'run_time',
+    CASE 
+        WHEN sh.run_duration > 235959 THEN
+    		   CAST((CAST(LEFT(CAST(sh.run_duration AS VARCHAR), LEN(CAST(sh.run_duration AS VARCHAR)) - 4) AS INT) / 24) AS VARCHAR)
+    		   + '.' + RIGHT('00' + CAST(CAST(LEFT(CAST(sh.run_duration AS VARCHAR), LEN(CAST(sh.run_duration AS VARCHAR)) - 4) AS INT) % 24 AS VARCHAR), 2)
+    		   + ':' + STUFF(CAST(RIGHT(CAST(sh.run_duration AS VARCHAR), 4) AS VARCHAR(6)), 3, 0, ':')
+    		ELSE
+    		   STUFF(STUFF(RIGHT(REPLICATE('0', 6) + CAST(sh.run_duration AS VARCHAR(6)), 6), 3, 0, ':'), 6, 0, ':')
+    		END AS 'LastRunDuration (d.HH:MM:SS) '
+    FROM msdb.dbo.sysjobs sj
 JOIN msdb.dbo.sysjobhistory sh
-ON sj.job_id = sh.job_id
+    ON sj.job_id = sh.job_id;
+GO
 ```
+
+## Next steps
+
+Learn more about related concepts in the following articles:
+
+- [dbo.sysjobactivity (Transact-SQL)](dbo-sysjobactivity-transact-sql.md)
+- [dbo.sysjobs (Transact-SQL)](dbo-sysjobs-transact-sql.md)
+- [dbo.sysjobsteps (Transact-SQL)](dbo-sysjobsteps-transact-sql.md)
+- [SQL Server Agent Tables (Transact-SQL)](sql-server-agent-tables-transact-sql.md)