Page 673 "Job Queue Entry Card"
Base Application · System.Threading
Across versions
- BC23-26present
- BC27declaration changed
- BC28-30unchanged
Neighbourhood 13 connected objects and pages
Base Application · System.Threading · BC23-30 · source at ea08af5e · facts from BC29
Properties
| Property | Value |
|---|---|
| Caption | Job Queue Entry Card |
| SourceTable | Job Queue Entry |
| PageType | Card |
Fields on this page
Layout controls in source order, grouped by the container they sit in. Shows: the table field a control is bound to (or its expression as written); ToolTip: the control’s own, else the bound field’s (marked).
| Group | Control | Shows | ToolTip |
|---|---|---|---|
| General | Object Type to Run | Object Type to Run | Specifies the type of the object, report or codeunit, that is to be run for the job queue entry. After you specify a type, you then select an object ID of that type in the Object ID to Run field. |
| Object ID to Run | Object ID to Run | Specifies the ID of the object that is to be run for this job. You can select an ID that is of the object type that you have specified in the Object Type to Run field. | |
| Object Caption to Run | Object Caption to Run | Specifies the name of the object that is selected in the Object ID to Run field. | |
| Description | Description | Specifies a description of the job queue entry. You can edit and update the description on the job queue entry card. The description is also displayed in the Job Queue Entries window, but it cannot be updated there. | |
| Parameter String | Parameter String | Specifies a text string that is used as a parameter by the job queue when it is run. | |
| Job Queue Category Code | Job Queue Category Code | Specifies the code of the job queue category to which the job queue entry belongs. Choose the field to select a code from the list. | |
| Priority Within Category | Priority Within Category | Specifies the priority of the job within the job queue category. Only relevant when job queue category code is specified. | |
| User ID | User ID | Specifies the ID of the user who posted the entry, to be used, for example, in the change log. | |
| Maximum No. of Attempts to Run | Maximum No. of Attempts to Run | Specifies how many times a job queue task should be rerun after a job queue fails to run. This is useful for situations in which a task might be unresponsive. For example, a task might be unresponsive because it depends on an external resource that is not always available. | |
| Rerun Delay (sec.) | Rerun Delay (sec.) | Specifies how many seconds to wait before re-running this job queue task in the event of a failure. | |
| Last Ready State | Last Ready State | Specifies the date and time when the job queue entry was last set to Ready and sent to the job queue. | |
| Earliest Start Date/Time | Earliest Start Date/Time | Specifies the earliest date and time when the job queue entry should be run. The format for the date and time must be month/day/year hour:minute, and then AM or PM. For example, 3/10/2021 12:00 AM. | |
| Expiration Date/Time | Expiration Date/Time | Specifies the date and time when the job queue entry is to expire, after which the job queue entry will not be run. The format for the date and time must be month/day/year hour:minute, and then AM or PM. For example, 3/10/2021 12:00 AM. | |
| Timeout | Job Timeout | Specifies the maximum time that the job queue entry is allowed to run. | |
| Status | Status | Specifies the status of the job queue entry. When you create a job queue entry, its status is set to On Hold. You can set the status to Ready and back to On Hold. Otherwise, status information in this field is updated automatically. | |
| Report Parameters | Report Request Page Options | Report Request Page Options | Specifies whether options on the report request page have been set for scheduled report job. If the check box is selected, then options have been set for the scheduled report. |
| Report Output Type | Report Output Type | Specifies the output of the scheduled report. | |
| Printer Name | Printer Name | Specifies the printer to use to print the scheduled report. | |
| Recurrence | Recurring Job | Recurring Job | Specifies if the job queue entry is recurring. If the Recurring Job check box is selected, then the job queue entry is recurring. If the check box is cleared, the job queue entry is not recurring. After you specify that a job queue entry is a recurring one, you must specify on which days of the week… |
| Run on Mondays | Run on Mondays | Specifies that the job queue entry runs on Mondays. | |
| Run on Tuesdays | Run on Tuesdays | Specifies that the job queue entry runs on Tuesdays. | |
| Run on Wednesdays | Run on Wednesdays | Specifies that the job queue entry runs on Wednesdays. | |
| Run on Thursdays | Run on Thursdays | Specifies that the job queue entry runs on Thursdays. | |
| Run on Fridays | Run on Fridays | Specifies that the job queue entry runs on Fridays. | |
| Run on Saturdays | Run on Saturdays | Specifies that the job queue entry runs on Saturdays. | |
| Run on Sundays | Run on Sundays | Specifies that the job queue entry runs on Sundays. | |
| Next Run Date Formula | Next Run Date Formula | Specifies the date formula that is used to calculate the next time the recurring job queue entry will run. If you use a date formula, all other recurrence settings are cleared. | |
| Starting Time | Starting Time | Specifies the earliest time of the day that the recurring job queue entry is to be run. | |
| Ending Time | Ending Time | Specifies the latest time of the day that the recurring job queue entry is to be run. | |
| No. of Minutes between Runs | No. of Minutes between Runs | Specifies the minimum number of minutes that are to elapse between runs of a job queue entry. The value cannot be less than one minute. This field only has meaning if the job queue entry is set to be a recurring job. If you use a no. of minutes between runs, the date formula setting is cleared. | |
| Inactivity Timeout Period | Inactivity Timeout Period | Specifies the number of minutes that pass before a recurring job that has the status On Hold With Inactivity Timeout is automatically restated. The value cannot be less than five minutes. | |
| Control33 | label | — | |
| Control31 | label | — | |
| Control22 | label | — |
Actions
| Group | Action | ToolTip | Runs |
|---|---|---|---|
| Job Queue | Set Status to Ready | Change the status of the entry. | |
| Set On Hold | Change the status of the entry. | ||
| Show Error | Show the error message that has stopped the entry. | ||
| Restart | Stop and start the entry. | ||
| Run once (foreground) | Run a copy of this job once in foreground. | ||
| Log Entries | View the job queue log entries. | Page 674 “Job Queue Log Entries” | |
| Show Record | Show the record for the entry. | ||
| Report Request Page | Show the request page for the entry. If the entry is set up to run a processing-only report, the request page is blank. |
Events published
OnBeforeShowModifyOnlyWhenReadOnlyNotification(var JobQueueEntry: Record "Job Queue Entry"; var IsHandled: Boolean)(integration)
Procedures
GetChooseSetOnHoldMsg(): Text
Plus 3 local procedures.
Triggers
OnAfterGetCurrRecord, OnNewRecord
Relations
- source table Table 472 “Job Queue Entry”
Pages and codeunits on this table
- Page 672 “Job Queue Entries” (card page)
Extended by
Called by
From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an Object::"Name" argument. Interface dispatch and calls through events are not counted, so the list is not complete.
- Table 1650 “Curr. Exch. Rate Update Setup” (2 calls:
AutoUpdateExchangeRates → (object),ShowJobQueueEntry → (object)) - Codeunit 1852 “Sales Forecast Scheduler” (1 call:
CreateJobQueueEntryAndOpenCard → (object)) - Codeunit 1956 “LPP Scheduler” (1 call:
CreateJobQueueEntryAndOpenCard → (object)) - Codeunit 3324 “PA Email Cleanup Scheduler” (1 call:
OpenJobQueueCard → (object)) - Codeunit 454 “Job Queue - Send Notification” (1 call:
ShowMoreDetailForSingleFailedJob → (object)) - Codeunit 5465 “Graph Mgt - General Tools” (1 call:
ScheduleUpdateAPIRecordsJob → (object)) - Codeunit 7017 “Price List Management” (1 call:
UpdateSourceGroupInLines → (object)) - Codeunit 737 “VAT Report Mgt.” (1 call:
OpenVATReturnPeriodJobCard → (object)) - Table 270 “Bank Account” (1 call:
ShowBankStatementDownloadJobQueueEntry → (object))
Documented on Microsoft Learn
Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).
Ask your agent
Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: bcatlas_resolve_node(object_type: "page", object_name: "Job Queue Entry Card"), then bcatlas_get_procedure_body or bcatlas_get_neighbors on the returned id.