Platform Jobs

Overview

A job is a long-running process that consumes significant system resources, such as modeling a location, importing exposure data, or updating portfolios in bulk.

This page identifies the types of jobs that can be run on the Intelligent Risk Platform, discusses operations for polling the status of these jobs and retrieving response objects once they are complete, and describes how resource groups are used to allocate and manage tenant resource quotas.

Job Types

A platform job is a system-defined task that manages a time-consuming or computationally expensive workflow process.

The Intelligent Risk Platform supports two types of jobs: primary jobs and secondary jobs.

  • Primary jobs are jobs that require immediate processing of time-sensitive materials such as catastrophe modeling of exposures, accumulations, or rollups.
  • Secondary jobs are jobs that do not process time-sensitive data. This includes batch, bulk, and data migration operations such as importing and exporting data. These are also known as non-model jobs.

Tenants are assigned distinct quotas of model and secondary jobs for each licensed entitlement.

Primary jobs and secondary jobs are managed in distinct workflow queues to ensure that time-sensitive primary jobs are not delayed by long-running import and export jobs.

Primary Jobs

A primary job is a platform job that performs the principal modeling or analysis operation of an Intelligent Risk Platform application.

Primary jobs are known by different names depending on the entitlement.

  • For Risk Modeler and UnderwriteIQ, a primary job is any job that models a collection of location exposures using a modeling engine (ALM, DLM, or HD). These are also known as model jobs.
  • For ExposureIQ, a primary job is a job that creates an accumulation.
  • For TreatyIQ, a primary job is a job that creates a rollup.

A resource group is allocated resource quotas that specify the number of concurrent primary jobs that can be run at any one time. To learn more, see Resource Management.

The table lists primary job types and the entitlements required to initiate those jobs:

JobOperation
ACCUMULATIONCreate Accumulation Job
ACCUMULATION_LIVECreate Accumulation Job
ALMCreate Model Job
DLMCreate Model Job
HDCreate Model Job

Secondary Jobs

A secondary job is a platform job that creates or updates a new resource. In general, these jobs are quite long-running and not time-sensitive. Examples of secondary jobs include import job and export jobs.

Secondary jobs are sometimes called secondary jobs. They are generally managed in a distinct job queue.

A resource group is allocated resource quotas that specify the number of concurrent secondary jobs that can be run at any one time. To learn more, see Resource Management.

JobOperations
ALM_IMPORTCreate Import Job
ARCHIVE_EDMArchive EDM
ARCHIVE_SECURABLEArchive Securable
AUTO_DELETE_ARCHIVE
BULK_EDITExposure Bulk Edit
BULK_EXPORTCreate Export Job
BULK_GEOHAZCreate Bulk Geohaz Job
CADOICreate Risk Data Report
CEDE_IMPORTCreate Import Job
CLIMATE_CHANGECalculate Climate Change
CONVERT_ACCOUNT_CURRENCYCreate Currency Conversion Job
CONVERT_AGGREGATE_PORTFOLIO_CURRENCYCreate Currency Conversion Job
CONVERT_CURRENCY_LOSS_POSTPROCESSOR
CONVERT_EVENT_RATE_LOSSConvert Event Rates and Losses
CONVERT_PORTFOLIO_CURRENCYCreate Currency Conversion Job
CONVERT_RESULT_CURRENCYCreate Currency Conversion Job
CONVERT_TREATY_CURRENCYCreate Currency Conversion Job
COPY_ACCOUNTCopy Job
COPY_AGGREGATE_PORTFOLIOCopy Job
COPY_PORTFOLIOCopy Job
COPY_TO_ARCHIVECreate Archives from Snapshot
CREATE_EDMCreate EDM
CREATE_MAP_LAYER
DELETE_ACCOUNTDelete Account
DELETE_AGGREGATE_PORTFOLIODelete Aggregate Portfolio
DELETE_ARCHIVEDelete Archive
DELETE_EDMDelete EDM
DELETE_PORTFOLIODelete Portfolio
DELETE_RDM
DELETE_SECURABLEDelete Securable
DEREGISTER_DATA_BRIDGE_EDMDeregister EDM
DETACH_EDM
DOMAIN_DATA_LOAD
DOWNLOAD_EDMCreate Export Job
DOWNLOAD_DETACH_EDM
DOWNLOAD_EXPOSURE_RESOURCECreate Export Job
DOWNLOAD_LOCATION_RESULTSCreate Export Job
DOWNLOAD_PEQTCreate Export Job
DOWNLOAD_RDMCreate Export Job
DOWNLOAD_REPORTCreate Export Job
DOWNLOAD_RESULTSCreate Export Job
EDM2EDMCreate Export Job
ENRICH_EXPOSURECreate Enrich Exposure Job
EXPOSURE_BATCH_EDIT_WITH_GEOHAZCreate Batch Job
EXPOSURE_BATCH_EDITCreate Batch Job
GEOHAZCreate Geohaz Job
GROUPINGCreate Group Job
MAP_PERSPECTIVEConvert Financial Perspectives
MARGINAL_IMPACTCalculate Marginal Impact
MODEL_PRICING
MRI_IMPORTCreate Import Job
OED_IMPORTCreate Import Job
PATERecalculate with PATE
PLT_TO_ELTConvert PLT to ELT Result
REGISTER_DATA_BRIDGE_EDMRegister EDM
RENAME_ANALYSISRename Analysis Result
REPORT_GENERATIONCreate Risk Data Report
RERUN_EPRecalculate EP and Statistics
RESTORE_ARCHIVERestore Archive
SIMULATE_LOSSESSimulate PLT Analysis
STEP_TOOLCreate STEP Analysis Job
UPDATE_RESULTS_COUNT
UPLOAD_EDMCreate Import Job
UPLOAD_RDMCreate Import Job
VARIATION_EXPOSURE_RESOURCE_IMPORT

Workflow Job Queues

A workflow queue is a mechanism for coordinating and scheduling platform jobs.

When a job is submitted, it is added to appropriate workflow queue based on the client’s entitlement and passes the quota capabilities to the workflow service.

The scheduler selects jobs for processing based on the rules specified in the workflow queue’s scheduling policy. A tenant is assigned dedicated queues for each entitlement? The jobs in a workflow queue are assigned a priority and a status.

The table lists supported workflow queues by entitlement.

EntitlementQueues
RI-RISKMODELERRI-RISKMODELER.<ResourceGroupID>.DEFAULT, RI-RISKMODELER.<ResourceGroupID>.FIFO, RI-RISKMODELER.<ResourceGroupID>.INTERACTIVE, RI-RISKMODELER.<ResourceGroupID>.API
RI-UNDERWRITEIQRI-UNDERWRITEIQ.<ResourceGroupID>.DEFAULT, RI-UNDERWRITEIQ.<ResourceGroupID>.FIFO, RI-UNDERWRITEIQ.<ResourceGroupID>.INTERACTIVE, RI-UNDERWRITEIQ.<ResourceGroupID>.API
RI-EXPOSUREIQRI-EXPOSUREIQ.<ResourceGroupID>.DEFAULT
RI-TREATYIQRI-TREATYIQ.<ResourceGroupID>.DEFAULT

Interactive Workflow Queues

Primary jobs are managed in the tenant's INTERACTIVE queue.

A RI-UNDERWRITEIQ resource group is provisioned with distinct workflow queues for managing and scheduling different types of jobs. New primary jobs are generally added to an INTERACTIVE queue --a queue that "fast tracks" the job, but these jobs may "fall back" to another workflow queue. The fallback queue is determined by the number of locations modeled in the job. If the number of locations modeled is less than 1000, it is directed to the FIFO workflow queue. Otherwise, it is managed in a WFS DEFAULT workflow queue.

The INTERACTIVE queue is one of four types workflow queues available to a RI-RISKMODELER or RI-UNDERWRITEIQ resource group.

FIFO Workflow Queues

Secondary jobs are managed in the tenant's FIFO queue.

The FIFO queue is one of the four workflow queues available to a RI-RISKMODELER or RI-UNDERWRITEIQ resource group.

Default Workflow Queues

The DEFAULT queue is the primary queue for most secondary jobs submitted by a RI-RISKMODELER, RI-UNDERWRITEIQ, RI-EXPOSUREIQ or RI-TREATYIQ resource group.

The DEFAULT queue also functions as a "fallback queue" for primary jobs.

The DEFAULT queue is only workflow queue available to the RI-EXPOSUREIQ or RI-TREATYIQ resource group.