{"title":"Codeunit 456 Job Queue Management, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/456-job-queue-management/points/","author":"JOP-AL","license":"Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/","subject":"Microsoft Dynamics 365 Business Central","checked":"2026-11-20","changed":"2026-10-05","object":{"type":"codeunit","id":456,"name":"Job Queue Management","app":"Base Application","url":"https://jonas-paprotka.de/ref/codeunit/456-job-queue-management/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/456-job-queue-management/source/","path":"src/Layers/W1/BaseApp/Modules/System/JobQueue/JobQueueManagement.Codeunit.al","commit":"4303e5e584d3aa5d9e98cbc615525a5396ad6ed7","lines":"a line is <source url>#L<line>"},"steps":{"event":"[line, \"event\", name, handled]: raises an event of this object; handled 1 when it has an IsHandled parameter","call":"[line, \"call\", name, arguments]: calls a procedure of this object","ext":"[line, \"ext\", type, id, name, arguments]: calls a procedure of another object, through a variable declared with that type","write":"[line, \"write\", table id, method, 1 when called with true]: Insert, Modify, ModifyAll, Delete, DeleteAll or Rename","validate":"[line, \"validate\", table id, field name]","run":"[line, \"run\", type, id]: Codeunit.Run, Page.Run, Report.Run and their kin"},"objects":{"table:472":{"name":"Job Queue Entry","url":"https://jonas-paprotka.de/ref/table/472-job-queue-entry/"},"codeunit:9026":{"name":"User Login Time Tracker","url":"https://jonas-paprotka.de/ref/codeunit/9026-user-login-time-tracker/"},"codeunit:9803":{"name":"Job Queue Telemetry","url":"https://jonas-paprotka.de/ref/codeunit/9803-job-queue-telemetry/"},"codeunit:448":{"name":"Job Queue Dispatcher","url":"https://jonas-paprotka.de/ref/codeunit/448-job-queue-dispatcher/"},"codeunit:450":{"name":"Job Queue Error Handler","url":"https://jonas-paprotka.de/ref/codeunit/450-job-queue-error-handler/"},"table:474":{"name":"Job Queue Log Entry","url":"https://jonas-paprotka.de/ref/table/474-job-queue-log-entry/"},"table:701":{"name":"Error Message Register","url":"https://jonas-paprotka.de/ref/table/701-error-message-register/"},"page:682":{"name":"Schedule a Report","url":"https://jonas-paprotka.de/ref/page/682-schedule-a-report/"}},"procs":[{"name":"CreateJobQueueEntry","line":37,"kind":"procedure","params":1,"steps":[[63,"validate",472,"Object Type to Run"],[64,"validate",472,"Object ID to Run"],[67,"validate",472,"Run on Mondays"],[68,"validate",472,"Run on Tuesdays"],[69,"validate",472,"Run on Wednesdays"],[70,"validate",472,"Run on Thursdays"],[71,"validate",472,"Run on Fridays"],[72,"validate",472,"Run on Saturdays"],[73,"validate",472,"Run on Sundays"],[74,"validate",472,"Recurring Job"],[82,"write",472,"Insert",1]]},{"name":"DeleteJobQueueEntries","line":85,"kind":"procedure","params":2,"steps":[[96,"write",472,"Modify"],[98,"write",472,"Delete"]]},{"name":"StartInactiveJobQueueEntries","line":102,"kind":"procedure","params":2,"steps":[[111,"ext","table",472,"SetStatus",1]]},{"name":"SetJobQueueEntriesOnHold","line":115,"kind":"procedure","params":2,"steps":[[123,"ext","table",472,"SetStatus",1]]},{"name":"SetRecurringJobsOnHold","line":127,"kind":"procedure","params":1,"steps":[[137,"write",472,"Modify"]]},{"name":"SetStatusToOnHoldIfInstanceInactiveFor","line":141,"kind":"procedure","params":4,"steps":[[150,"ext","codeunit",9026,"AnyUserLoggedInSinceDate",1],[151,"call","SetJobQueueEntriesOnHold",2]]},{"name":"RunJobQueueEntryOnce","line":158,"kind":"procedure","params":1,"steps":[[183,"write",472,"Insert",1],[184,"event","OnRunJobQueueEntryOnceOnAfterJobQueueEntryInsert",0],[190,"ext","codeunit",9803,"SetJobQueueTelemetryDimensions",2],[196,"run","codeunit",448],[200,"run","codeunit",450],[205,"ext","table",472,"SetError",1],[206,"ext","table",472,"InsertLogEntry",1],[207,"ext","table",472,"FinalizeLogEntry",2],[214,"write",472,"Delete"]]},{"name":"CheckAndRefreshCategoryRecoveryTasks","line":223,"kind":"procedure","params":0,"steps":[[252,"ext","table",472,"RefreshRecoveryTask",1]]},{"name":"FindStaleJobsAndSetError","line":261,"kind":"procedure","params":0,"steps":[[275,"call","GetCheckDelayInMilliseconds",0],[283,"call","SessionStarted",3],[285,"call","SessionStopped",3],[288,"ext","table",472,"SetError",1],[289,"event","OnFindStaleJobsAndSetErrorOnAfterSetError",0],[291,"call","StaleJobQueueEntryTelemetry",1],[300,"call","GetCheckDelayInMilliseconds",0],[312,"write",474,"Modify"],[314,"call","StaleJobQueueLogEntryTelemetry",1]]},{"name":"UpdateRetriableFailedJobQueueLogEntry","line":320,"kind":"procedure","access":"internal","params":1,"steps":[[335,"write",474,"Modify"],[337,"call","StaleRetriableJobQueueLogEntryTelemetry",1]]},{"name":"GetCheckDelayInMilliseconds","line":342,"kind":"procedure","access":"local","params":0,"steps":[[347,"event","OnGetCheckDelayInMinutes",0]]},{"name":"SessionStarted","line":353,"kind":"procedure","access":"local","params":3,"steps":[[357,"call","SessionExists",4]]},{"name":"SessionStopped","line":360,"kind":"procedure","access":"local","params":3,"steps":[[364,"call","SessionExists",4]]},{"name":"StaleJobQueueEntryTelemetry","line":380,"kind":"procedure","access":"local","params":1,"steps":[[388,"ext","codeunit",9803,"SetJobQueueTelemetryDimensions",2]]},{"name":"StaleJobQueueLogEntryTelemetry","line":395,"kind":"procedure","access":"local","params":1,"steps":[[403,"ext","codeunit",9803,"SetJobQueueTelemetryDimensions",2]]},{"name":"StaleRetriableJobQueueLogEntryTelemetry","line":410,"kind":"procedure","access":"local","params":1,"steps":[[418,"ext","codeunit",9803,"SetJobQueueTelemetryDimensions",2]]},{"name":"TooManyScheduledTasksNotification","line":425,"kind":"procedure","access":"internal","params":0,"steps":[[430,"call","GetNumberOfScheduledTasks",0]]},{"name":"GetScheduledTasks","line":441,"kind":"procedure","access":"internal","params":0,"steps":[[443,"call","GetNumberOfScheduledTasks",0]]},{"name":"GetScheduledTasksForUser","line":446,"kind":"procedure","access":"internal","params":1,"steps":[[448,"call","GetNumberOfScheduledTasksForUser",1]]},{"name":"DeleteErrorMessageRegister","line":481,"kind":"procedure","access":"local","params":1,"steps":[[489,"write",701,"DeleteAll",1]]},{"name":"ScheduleReport","line":493,"kind":"procedure","access":"local","params":3,"steps":[[497,"ext","page",682,"ScheduleAReport",2]]},{"name":"OnStatusChanged","line":501,"kind":"procedure","access":"local","params":3,"steps":[[515,"ext","codeunit",9803,"SetJobQueueTelemetryDimensions",2],[523,"call","DeleteErrorMessageRegister",1]]},{"name":"OnBeforeDeleteJobQueueEntry","line":527,"kind":"procedure","access":"local","params":2,"steps":[[536,"call","DeleteErrorMessageRegister",1]]},{"name":"OnBeforeDeleteJobQueueLogEntry","line":540,"kind":"procedure","access":"local","params":2,"steps":[[549,"call","DeleteErrorMessageRegister",1]]}]}