Configuring Emissions Calculation Jobs

Use the Emissions Calculation Job form to automate the process of scheduling emission models/scenarios for calculation and initiating the calculation process. Select the production unit(s) associated with the production schedules that include the process units for the emission models and scenarios to be calculated. Specify actual and/or maximum potential calculations. Set up a job schedule that defines when an emissions calculation job will run—just once to allow for the calculation of past, missing emission results, or on a recurring basis so emissions can be automatically calculated at regular intervals in the future. Automate many of your routine emissions-related tasks by scheduling jobs to create production schedules and jobs to calculate emissions.

Tip:  Emissions can also be calculated using the Calculate Emissions form and the Production Planning form.

For instruction on setting up automated emission calculation jobs, click the following links or use the scroll bar to scan the page.

Emissions Calculation Job Configuration

An emissions calculation job configuration consists of a unique schedule description, or job name, a job run schedule, and the criteria described below:  

• Previous Months to Calculate - The number of months specified is used to determine the start date for the emissions calculation job. The production schedules with a start date on or after the start date for the calculation job are included in emissions calculations for the job. Refer to Start Date Determination for additional information.

• Calculate Emissions - Calculate actual emissions and/or maximum potential emissions. Actual emissions and maximum potential emissions are calculated separately.

• Generate Calculation Details Log - Include calculation details in the Calculation Log. Otherwise, just the warning details encountered during emission calculation execution that are equation-related (e.g., invalid expression) and/or material-related (e.g., missing vapor pressure method) will be included. Refer to Calculation Details Log for additional information.

• Run ARS - Initiate ARS emissions processing after completion of scheduled emissions calculation jobs. To populate intermediate calculation values (i.e., the value for each equation variable and equation expression) in the ARS calculation results table (WH_EMIS_CALC_VALUE), the Generate Calculation Details Log option must be selected.

• Production Units - Include the production units associated with the production schedules that include the process units for the emission models and scenarios to be calculated.

• Email Recipients - Include the contacts and/or teams who are to receive an email notification when an emissions calculation job is complete. Select one or more contacts/teams from the records in your Essential database or enter a specific email address. Multiple addresses can be entered by using a semicolon to separate each address. A link to the Calculation Log is provided in the email message.

Job Schedule

A job schedule defines when an emissions calculation job runs. The particular day, hour, and minute can be specified. Once defined, the emissions calculation job can be run on-demand. When the emissions calculation job runs, the criteria entered is evaluated and the calculation process is initiated. The failure of a calculation for a single production schedule will not cancel all other calculations.

The logs in the Job Log section on the Emissions Calculation Job form provide information about the run status and final results, The Emissions Calculation Jobs browse view also provides information about run status, such as the last run date, next run date, schedule type, the current run status, and the last run status. Completed job schedules are jobs that are not scheduled to run again, e.g., a Once, next available time Schedule Type, and are automatically filtered out of the list. To see completed emissions calculation jobs, click the Include Completed Schedule check box.

Start Date Determination

The Previous Months to calculate specified on the Emissions Calculation Job form, along with the job run date, is used to determine the start date for the emissions calculation job. The production schedules with a start date on or after the start date for the calculation job are included in emissions calculations for the job.

Note:  Once the start date has been determined, calculations for existing production schedules will be processed—including future production schedules, which may cause performance issues for large calculation jobs. Consider establishing production schedule jobs to create production schedules as they are needed. Refer to Configuring Production Schedule Jobs for additional information.

The start date formula:

emissions calculation job run date – previous months to calculate

determines the appropriate month for the start date. All calculation job start dates begin on the first day of the month. For example, if the calculation job is executed on May 31 and the number of months is 2, March is the job's start date month (May 31 - 2 months). All production schedules with a start date on or after March 1 will be included in the job. Additional examples are provided in the table below. All Previous Months to Calculate field entries must be positive numbers. Zero (0) is a valid value and represents the month the calculation job runs.

Emissions Calculation Job Setup

Use the Emissions Calculation Job form to set up emissions calculation jobs that run automatically according to the schedule configuration. Once a job schedule with a recurring Schedule Type has been defined, the production schedule job can be run on-demand.

To establish emission calculation jobs

1. Click Data Entry > Emission Management > Emissions Calculation Jobs in the Navigation Tree to display the Emissions Calculation Jobs list.

2. Click the New button and enter a Schedule Description (job name).
   
   The default value is the day of the week and the date.

3. Enter the number of Previous Months to Calculate.
   
   Enter 0 to include just those production schedules with a start date on or after the first day of the month in which the job runs.

4. Select the Calculate Actual Emissions and/or Calculate Max Potential Emissions option. Actual emissions and maximum potential emissions are calculated separately.

5. Select the Generate Calculation Details Log option to include calculation details in the Calculation Log. Otherwise, just the warning details encountered during emission calculation execution that are equation-related (e.g., invalid expression) and/or material-related (e.g., missing vapor pressure method) will be included.
   
   When the Generate Calculation Details Log option is selected, performance may be affected. A warning message is displayed that allows you to clear this option before saving the record. Refer to Calculation Details Log for additional information.

6. Expand the Production Units section, select one or more entities and click Add Production Units.
   
   The list of available production units is filtered by the entities selected.

7. Click the check box adjacent to each production unit to be assigned to the emissions calculation job and click Add Production Units.
   
   Each production unit is displayed as a line item. Click the Delete button adjacent to the line item to remove a production unit from the job.

8. Expand the Job Schedule section and select a Schedule Type from the list. Based on the schedule type selected, any required scheduling options are automatically displayed.

9. Use the guidelines below to complete the run schedule.

1. • For date fields, the Calendar button is available to select a date.

   • Select all applicable Days of the week for daily-related schedule types.

   • Select a Schedule Time from the list for each applicable field. No selection can be made for options that do not apply to the schedule type selected.

   • Enter a numerical value that represents the interval between runs in the Run Every field.

A schedule example for the Hourly type might be on Monday, Tuesday, Wednesday, Thursday, and Friday (Days), at 15 minutes after the hour (Schedule Time), every 8 hours (Run Every), beginning November 1, 2012 at 8:00 a.m. (Start Date). The import job would run at 8:15 a.m., 4:15 p.m., and 12:15 a.m. Monday through Friday starting November 1.

10. Enter the Email Recipients who are to receive a notification when a calculation job is complete. Refer to Job Completion Notifications for additional information.

11. Click the Save button.
    
    See To run emissions calculation jobs on demand when applicable.

12. Repeat steps 2 through 11 to set up another emissions calculation job.

To run emissions calculation jobs on-demand

1. Click Data Entry > Emission Management > Emissions Calculation Jobs in the Navigation Tree to display the Emissions Calculation Jobs list.

2. Click the Job Name link to open the Emission Calculation Job form for the applicable schedule.

3. Expand the Job Schedule section and click the Run On Demand? check box to select it.
   
   The Run on Demand option is not available for the No Schedule and Once, next available time Schedule Type options.

4. Click Save.
   
   Track the job status in the Job Log and Calculation Log sections.

Assigning Production Units

In the Production Units section on the Emissions Calculation Job form, select the production units associated with the production schedules that include the process units for the emission models and scenarios to be calculated. Production units for one or more entities can be included.

 To assign production units

1. Click Data Entry > Emission Management > Emissions Calculation Jobs in the Navigation Tree to display the Emissions Calculation Jobs list.

2. Click the Job Name link to open the Emission Calculation Job form for the applicable schedule.

3. Expand the Production Units section and select one or more entities to filter the list of production units available for selection.

4. Click Add Production Units and click the check box adjacent to each production unit to be added to the emissions calculation job. Or use the Select All/Clear All links to expedite the selection process.
   
   When applicable, the Next/Previous navigation links are available to page through the list. Click the Production Unit link to view the production unit record.

5. Click Add Production Units.
   
   Each production unit is displayed as a line item. Click the Delete button adjacent to the line item to remove a production unit from the job.

6. Click Save.

Job Completion Notifications

An email notification can be sent to the contacts and/or teams identified in the Email Recipients section on the Emissions Calculation Job form when an emissions calculation job is complete. (No notifications are generated if an entry is not added to the Calculation Log.) Select one or more contacts/teams from the records in your Essential database or enter a specific email address. Multiple addresses can be entered by using a semicolon to separate each address. The culture setting for the logged-in user who created or updated the emissions calculation job determines the email's language. A link to the Calculation Log for each entity associated with the calculation job is provided in the email message.

Tip:  One email is generated for each job even when more than one entity is part of the job. Create a separate emission calculation job for each entity to ensure emails are sent per entity.

 To set up email notifications

1. Click Data Entry > Emission Management > Emissions Calculation Jobs in the Navigation Tree to display the Emissions Calculation Jobs list.

2. Click the Job Name link to open the Emissions Calculation Job form for the applicable schedule.

3. Expand the Email Recipients section and enter one or more Email Addresses. Separate multiple addresses with a semicolon.

4. Click Add Contact to select a contact and or team record.
   
   The teams available for selection are teams with no entity association and teams associated with the entities for the production units assigned to the job. When editing an existing job by adding a production schedule for another entity, save the Emissions Calculation Job form to ensure the teams available for selection include the teams associated with the newly added entity.

5. Click the appropriate option and select a Contact or Team from the list.
   
   A valid email address must be associated with a contact/team member on the Contacts and Personnel form to receive email notifications.

6. Click OK.
   
   The contact/team information is displayed as a line item. Click the Delete button adjacent to the line item to remove a recipient.

7. Repeat steps 4 through 6 to add other contacts/teams.

8. Click Save.

Job Logs

The job schedule setup triggers the automated calculation process. A separate job is created for each one-time instance and each recurrence. An entry is added to the APE Job Log for each job. The start and finish date/time, the run status, the final results, and the machine name are provided for each log entry. Jobs are processed according to a pre-configured priority in a managed, queue-based environment to minimize system contention.

The Application Log can be used to determine if application-related errors were encountered for calculation jobs. The timestamp, severity, priority, and critical/error/warning message details are displayed. This log may not be available to all users; element-level security applies. Refer to Setting Field-Level (Element) Security for additional information.

Both logs are displayed in the Job Log section on the Emissions Calculation Job form. When multiple pages of log records exist, the Next/Previous navigation links are available to page through the list. Ascending/descending column sorting is also available; click a column heading to sort by the values in the column. The Application Log contains standard search options to display just the log entries of interest at a point in time.

The AutoRefresh option allows you to switch between a working mode and the log refresh mode. In the refresh mode, the logs are automatically updated every 10 seconds. It is possible to use the search, filtering, and sorting options in the refresh mode; however, when the log is refreshed and there are new entries, all search/filtered/sorted results could be lost. The list of log entries will be reset to display the new ones at the top of the list. By switching to the working mode, you can continue viewing the list without interruption. Select the AutoRefresh check box to activate the refresh mode and clear the check box to switch to a working mode. The Refresh link can be used at any time to update the logs. For notification purposes, a Loading... message appears when the logs are being refreshed.

Tip:  Entries can be deleted from the APE Job Log when no longer needed via the Purge APE Log form.

Calculation Log

A record is added to the Calculation Log each time an emissions calculation is executed. The log can be viewed in the Calculation Log section on the Emissions Calculation Job form, Calculate Emissions form, and Production Planning form. The calculation execution date, the entity, and the actual calculation start and end date are provided for each log entry. A Yes/No indicator lets you know if the calculation process ran with warnings. Standard search options are available to display just the log entries of interest at a point in time. When multiple pages of log records exist, the Next/Previous navigation links are available to page through the list. Ascending/descending column sorting is also available; click a column heading to sort by the values in the column. The AutoRefresh option allows you to switch between a working mode and the Calculation Log refresh mode. In the refresh mode, the log is automatically updated every 10 seconds. It is possible to use the search, filtering, and sorting options in the refresh mode; however, when the Calculation Log is refreshed and there are new entries, all search/filtered/sorted results could be lost. The list of log entries will be reset to display the new ones at the top of the list. By switching to the working mode, you can continue working without interruption. Select the AutoRefresh check box to activate the refresh mode and clear the check box to switch to a working mode. The Refresh link can be used at any time to update the log. For notification purposes, a Loading... message appears when the Calculation Log is being refreshed.

Click a log entry link to view additional calculation information. The Calculation Details Log section is populated if the Generate Calculation Details Log option on the Emissions Calculation Job form, Calculate Emissions form, or Production Planning form is selected prior to calculations. The mass value is automatically calculated, Amount x Number of Operating Hours, and included in the details. The Detailed Warnings section contains warnings encountered during emission calculation execution that are equation-related (e.g., invalid expression) and/or material-related (e.g., missing vapor pressure method). The details provided about the calculations are suitable for use by the Essential support group for troubleshooting emission calculation issues.

Tip:  The Calculation Log can also be viewed by clicking Reports > Emissions Report > Calculation Log in the Navigation Tree.

Calculation Details Log

The Calculation Details Log is a section on the Calculation Log that is populated if the Generate Calculation Details Log option on the Emissions Calculation Job form, Calculate Emissions form, or Production Planning form is selected prior to calculations.  The details provided demonstrate how calculations are performed and are typically used for verification and troubleshooting. Due to the level of detail generated, this log is intended to be used for smaller data sets. For example, generating the log for all calculations performed at an entity for an entire year may cause performance issues and the log may be slow to display. Use one or both of the following methods to generate a smaller, and therefore usable, Calculation Details Log:

• Create production schedules with shorter durations, taking into consideration the granularity of the parameter result data that is being calculated. For example, the appropriate duration of a production schedule when hourly parameter results are being calculated is most likely no more than one day, such as 9/10/2012 12:00:00 AM to 9/11/2012 12:00 AM.

• Implement a one-to-one relationship between production units and emission source process units.

Note:  The Generate Calculation Details Log option must be selected to populate intermediate calculation values (i.e., the value for each equation variable and equation expression) in the ARS calculation results table (WH_EMIS_CALC_VALUE).

Deleting Emissions Calculation Jobs

An emissions calculation job can be deleted by clicking the Delete button on the Emissions Calculation Job form. The association to any emission results created by the job will also be removed with the job. To delete emission calculation result records no longer needed, use the Purge Calculation Results form.

Related topics