7 Export/Import Configuration
This chapter explains the export/import of schedule configuration and of custom entities configuration in POM.
Schedule Configuration
Overview
POM provides a feature, in the user interface, to export and import schedule configuration data such as data retention limits, throttle limits, enable/disable flags, schedule times, notifications configuration, and so on.
This feature can be used in two ways:
-
Data exported on a specific environment can be imported back on a different environment without any modifications. This is a typical use case where the batch schedule on a certain environment, such as Stage, is set up and fine-tuned according to a customer's requirements. This includes specifying which jobs should or shouldn't run. It includes ad hoc flows configuration. It includes specifying the times certain cycles or flows will start. It also includes specifying the e-mail addresses that will receive certain notifications and how long to keep those notification in the system before purging them.
Once the schedule is configured and fine-tuned (on Stage, for example) the export/import feature can be used to export the configurations from Stage and import them back into production.
Note:
The user has the option to export to a spreadsheet or a JSON file. In this first use case, it is recommended the user exports to a JSON file then imports it back into the other environment.
-
Data can be altered in the exported spreadsheet then imported back into the same environment. This is useful at provisioning time where an environment is first set up with the default batch schedule configuration. A user would then export the default configuration, then modify that configuration on the spreadsheet to conform to the customer's needs. The spreadsheet is then imported back into the same environment, applying the desired configurations.
Note:
When importing the spreadsheet on the Batch Administration screen, the user will have the option of importing job-related configuration or scheduler-related configuration (run times) or both. Refer to the "Batch Administration" section in the POM User Guide for more details. Also, note that the job type cannot be changed by the import configuration, and job configuration is updated on the target only if the job types match.
This chapter describes each tab in the exported spreadsheet, along with the data on each sheet. It also indicates which fields can be modified.
Schedule Info Tab
This is an informational only tab. No fields are modifiable on it.
Table 7-1 Schedule Info
Field | Description | Modifiable? |
---|---|---|
Name |
Schedule or application name. |
No |
Display Schedule Name |
Display schedule name used on POM UI, reports and mail notifications. Note: This field is not modifiable using the export / import feature. To modify it, refer to the Schedule Tab section of the Batch Schedule Spreadsheet Template appendix of this guide. |
No |
Version |
Schedule version. |
No |
Installation Date |
Date the schedule was uploaded into POM. |
No |
Customer Name |
This is used on notifications to identify which customer a notification is for. |
No |
Environment Name |
This is used on notifications to identify which customer's environment a notification is for. |
No |
Schedule Configuration Tab
This tab contains schedule level settings.
Table 7-2 Schedule Configuration
Field | Description | Modifiable? |
---|---|---|
First Run Business Date |
Date when batch was run for the first time. See subsection "Business Date Explained" in the "System Configuration" section of the POM User Guide. |
No |
Data Retention Days |
Number of days historic data is to be retained in POM. |
Yes - Recommended value is 30 days. |
Long Run Average Multiplier |
Number that is multiplied by a job's average run time to determine a threshold. When a job’s run time exceeds this threshold + a Long Running Tolerance Level, the job is deemed long-running. For a complete explanation of how a job is deemed long-running, see the Long Running Jobs subsection of the Batch Job subsection of the Batch Schedule section of the Batch Concepts chapter of this document. |
Yes - Usually a number between one and three. |
External Dependencies |
Indicates whether POM will respect external dependencies or not. They are usually dependencies on customers' internal processes. |
Yes - Valid values are Y or N. |
Inter-schedule Dependencies |
Indicates whether POM will respect external dependencies or not. Those are dependencies on other schedules. |
Yes - Valid values are Y or N. |
Callback mode |
This is also known as External Status Update Mode. Depending on the value, the customer's system is notified of success or failure of any job in the entire schedule. The value set here is overridden by this same setting for any individual job defined on the other job-specific tabs. |
Yes - Valid values are ALL, FAILED or NONE. When value is NONE, no callback is made. When value is ALL, callback is made on either success or failure. When value is FAILED, callback is made only on failure |
Throttling Tab
At this time, this tab should only be used to set throttle limits at the application level. Throttling is a technique used to limit the number of jobs that can run concurrently for a specific application. Throttling limits are set so a server's resources are not overwhelmed by too many concurrently running jobs.
Note:
Previously, throttle limits could be set at the application level and/or at the module level. Now they can only be set at the application level.
Also note that this tab was intended to provide the capability to enable/disable whole applications or modules. This is not functioning at this time. In order to achieve this objective, filter on application on the Nightly Jobs Configuration, Recurring Jobs Configuration or Adhoc Jobs Configuration, then change all enabled flags to 'Y' or 'N' as desired. For enabling/disabling whole modules, this has to be done on the Batch Administration screen at this time.
(Continued)
Table 7-3 Throttling
Field | Description | Modifiable? –Possible values |
---|---|---|
Application |
Application code. |
No |
Module |
Module name. |
No |
Agent |
Agent is the lightweight component usually running on the consuming application’s container. It executes that application's batch jobs based on requests from POM. |
No |
Throttle Limit |
The max number of jobs that can run concurrently for the specified application. |
Yes – A number that is greater than zero. |
Enabled |
This flag currently does not enable or disable jobs belonging to an application/module. See the second note at the top of this section for more information. |
Yes – Valid values are Y or N. |
Nightly Jobs Configuration Tab
This tab contains all Nightly cycle's jobs along with their configuration.
Table 7-4 Nightly Jobs Configuration
Field | Description | Modifiable? – Possible values |
---|---|---|
Job |
Job name. |
No |
Process |
Process name to which the job belongs; a process can contain multiple jobs. |
No |
Cycle |
This is a fixed value for this tab of 'Nightly'. |
No |
Flow |
This is a fixed value of “Nightly” for this tab. |
No |
Application |
Application name to which this process-job belongs. |
No |
Parameter Change |
Flag indicating whether the parameter can be changed after the initial load. If it can, then the new value must be loaded in the next field: Active Parameter. |
Yes – Valid values are Y or N. |
Job Type |
Indicates name of the job type such as |
No |
Active Parameter |
Parameter which overrides the Base Parameter when Parameter Change is 'Y'. |
Yes – Can contain blank or any space-separated list of parameters. |
Priority |
An optional number between 1 and 10 (10 being highest priority) assigned to a process-job combination. This number determines the execution priority for the job amongst concurrent job run requests in a limited throttled setting. |
Yes – Valid values are 1-10 |
Active Phase |
An optional alphanumeric phase assigned to a process-job for grouping of jobs in the Nightly cycle. This is used for reporting purposes only. The Nightly Summary Report will then report total run time and elapsed time by Phase. |
Yes – Valid values – alphanumeric text like |
Kill Cleanup Script |
Absolute path of the clean-up script to be run after killing a job from POM. Can include arguments as well along with the script. |
Yes, Valid values – /u01/scripts/killCleanUp.sh “123” “345” |
Skip on error |
Flag indicating whether this job should automatically be skipped when it fails so batch can resume |
Yes – Valid values are Y or N. |
Callback mode |
This is also known as External Status Update Mode. Depending on the value, the customer's system is notified of success or failure of this specific job by calling a predefined customer endpoint. The value set here overrides that of this same setting on the Schedule Configuration tab. |
Yes – Valid values are ALL, FAILED or NONE. When value is NONE, no callback is made. When value is ALL, callback is made on either success or failure. When value is FAILED, callback is made only on failure |
Day of week |
Contains the day(s) of the week on which this specific Job will run. POM automatically skips these Jobs on remaining days. If this field is left blank, the job will run on every day of the week. |
Yes – Valid values are blank or any number of comma separated days of the week (for example: SUNDAY,MONDAY,TUESDAY, WEDNESDAY,THURSDAY, FRIDAY,SATURDAY) |
Threshold Runtime |
Estimated runtime in seconds for this specific job. This is an optional field which, when entered, will be used as a threshold. When this threshold is exceeded, the job is deemed long-running. For a complete explanation of how a job is deemed long-running, see the Long Running Jobs subsection of the Batch Job subsection of the Batch Schedule section of the Batch Concepts chapter of this document. |
Yes – Valid values are blank or an integer number of seconds. |
Enabled |
Flag indicating if this job is enabled or disabled. |
Yes – Valid values are Y or N. |
Notify Job Start |
Flag indicating if a notification is to be sent at start of this job. |
Yes – Valid values are Y or N. |
Notify Job Completion |
Flag indicating if a notification is to be sent at successful completion of this job. |
Yes – Valid values are Y or N. |
Recurring Jobs Configuration Tab
This tab contains the list of Recurring cycle/Process/Job along with their configuration.
Table 7-5 Recurring Jobs Configuration
Field | Description | Modifiable? –Possible values |
---|---|---|
Job |
Job Name |
No |
Process |
Process name to which the job belongs; a process can contain multiple jobs. |
No |
Cycle |
Name of the hourly/recurring cycle this job belongs to. |
No |
Flow |
Name of the recurring flow |
No |
Application |
Application name to which this process-job belongs. |
No |
Parameter Change |
Flag indicating whether the parameter can be changed after the initial load. If it can, then the new value must be loaded in the next field: Active Parameter. |
Yes – Valid values are Y or N. |
Job Type |
Name of the job type such as |
No |
Active Parameter |
Parameter which overrides the Base Parameter when Parameter Change is 'Y'. |
Yes – Can contain blank or any space separated list of parameters. |
Active Priority |
An optional number between 1 and 10 (10 being highest priority) assigned to a process-job combination. This number determines the execution priority for the job amongst concurrent job run requests in a limited throttled setting. |
Yes – Valid values are 1-10 |
Active Phase |
An optional alphanumeric phase assigned to a process-job for grouping of jobs in the Nightly cycle. This is used for reporting purposes only. The Nightly Summary Report will then report total run time and elapsed time by Phase. |
Yes – Valid values – alphanumeric text like PHASE_1 |
Kill Cleanup Script |
Absolute path of the clean-up script to be run after killing a job from POM. Can include arguments as well along with the script. |
Yes, Valid values – /u01/scripts/killCleanUp.sh “123” “345” |
Skip on error |
Flag indicating whether this job should automatically be skipped when it fails so batch can resume. |
Yes – Valid values are Y or N. |
Callback mode |
This is also known as External Status Update Mode. Depending on the value, customer's system is notified of success or failure of this specific job by calling a predefined customer endpoint. The value set here overrides that of this same setting on the Schedule Configuration tab. |
Yes – Valid values are ALL, FAILED or NONE. When value is NONE, no callback is made. When value is ALL, callback is made on either success or failure. When value is FAILED, callback is made only on failure |
Day of week |
Contains the day(s) of the week on which this specific Job will run. POM automatically skips these Jobs on the remaining days. If this field is left blank, the job will run on every day of the week |
Yes – Valid values are blank or any number of comma-separated days of the week (for example: SUNDAY,MONDAY,TUESDAY, WEDNESDAY,THURSDAY, FRIDAY,SATURDAY) |
Threshold Runtime |
Estimated runtime in seconds for this specific job. This is an optional field which, when entered, will be used as a threshold. When this threshold is exceeded, the job is deemed long running. For a complete explanation of how a job is deemed long-running, see the Long Running Jobs subsection of the Batch Job subsection of the Batch Schedule section of the Batch Concepts chapter of this document. |
Yes – Valid values are blank or an integer number of seconds. |
Enabled |
Flag indicating whether this job is enabled or disabled. |
Yes – Valid values are Y or N. |
Notify Job Start |
Flag indicating if a notification is to be sent at start of this job. |
Yes – Valid values are Y or N. |
Notify Job Completion |
Flag indicating if a notification is to be sent at successful completion of this job. |
Yes – Valid values are Y or N. |
Recurring Flows Configuration Tab
This tab contains a flow/cycle matrix. It contains a row for each flow and all recurring cycles as columns. An intersection of 'Y' means the given flow is defined to run as part of the given recurring cycle. It is recommended that all recurring cycles are enabled but not necessarily scheduled for running. See the Scheduling Flows Tab for further clarification.
Table 7-6 Recurring Flows Configuration
Field | Description | Modifiable? |
---|---|---|
Flow |
Flow name. |
No |
Recurring cycle 1 |
A 'Y' or 'N' value indicating whether the given flow is run as part of recurring cycle 1. A value of N does not disable jobs belonging to the flow/cycle intersection. Those jobs need to be manually disabled on the Batch Administration screen. |
Yes – Valid values are Y or N. |
Recurring cycle 2 |
A 'Y' or 'N' value indicating whether the given flow is run as part of recurring cycle 2. A value of N does not disable jobs belonging to the flow/cycle intersection. Those jobs need to be manually disabled on the Batch Administration screen. |
Yes – Valid values are Y or N. |
Recurring cycle n |
A 'Y' or 'N' value indicating whether the given flow is run as part of recurring cycle n. A value of N does not disable jobs belonging to the flow/cycle intersection. Those jobs need to be manually disabled on the Batch Administration screen. |
Yes – Valid values are Y or N. |
Adhoc Flows Configuration Tab
This tab allows for enabling/disabling of ad hoc flows.
Table 7-7 Adhoc Flows Configuration
Field | Description | Modifiable? |
---|---|---|
Name |
Ad hoc Flow name. |
No |
Enabled |
Flag indicating whether this ad hoc flow is enabled or disabled. |
Yes – Valid values are Y or N. |
Custom |
Flag indicating whether this ad hoc flow is custom or not. |
No |
Adhoc Processes Configuration Tab
This tab allows for enabling/disabling ad hoc processes.
Table 7-8 Adhoc Processes Configuration
Field | Description | Modifiable? |
---|---|---|
Name |
Ad hoc Process name. |
No |
Enabled |
Flag indicating whether this ad hoc process is enabled or disabled. |
Yes – Valid values are Y or N. |
Custom |
Flag indicating whether this ad hoc process is custom or not. |
No |
Adhoc Jobs Configuration Tab
This tab contains the list of ad hoc jobs (also known as standalone) along with their configuration.
Table 7-9 Adhoc Jobs Configuration
Field | Description | Modifiable? – Possible values |
---|---|---|
Job |
Job name. |
No |
Process |
Process name to which the job belongs; a process can contain multiple jobs. |
No |
Cycle |
This is a fixed value for this tab of 'Adhoc'. |
No |
Flow |
This is a fixed value of “Adhoc” for this tab. |
No |
Application |
Application name to which this process-job belongs. |
No |
Parameter Change |
Flag indicating whether the parameter can be changed after the initial load. If it can, then the new value must be loaded in the next field: Active Parameter. |
Yes – Valid values are Y or N. |
Job Type |
Name of the job type such as |
No |
Active Parameter |
Parameter which overrides the Base Parameter when Parameter Change is 'Y'. |
Yes – Can contain blank or any space separated list of parameters. |
Active Priority |
An optional number between 1 and 10 (10 being highest priority) assigned to a process-job combination. This number determines the execution priority for the job amongst concurrent job run requests in a limited throttled setting. |
Yes – Valid values are 1-10 |
Active Phase |
An optional alphanumeric phase assigned to a process-job for grouping of jobs in the Nightly cycle. This is used for reporting purposes only. The Nightly Summary Report will then report total run time and elapsed time by Phase. |
Yes – Valid values – alphanumeric text like PHASE_1 |
Kill Cleanup Script |
Absolute path of the clean-up script to be run after killing a job from POM. Can include arguments as well along with the script. |
Yes, Valid values – /u01/scripts/killCleanUp.sh “123” “345” |
Skip on error |
Flag indicating whether this job should automatically be skipped when it fails so batch can resume. |
Yes – Valid values are Y or N. |
Callback mode |
This is also known as External Status Update Mode. Depending on the value, the customer's system is notified of the success or failure of this specific job by calling a predefined customer endpoint. The value set here overrides that of this same setting on the Schedule Configuration tab. |
Yes – Valid values are ALL, FAILED or NONE. When value is NONE, no callback is made. When value is ALL, callback is made on either success or failure. When value is FAILED, callback is made only on failure |
Day of week |
Contains the day(s) of the week on which this specific Job will run. POM automatically skips these Jobs on remaining days. If this field is left blank, the job will run on every day of the week |
Yes – Valid values are blank or any number of comma separated days of the week (for example: SUNDAY,MONDAY,TUESDAY, WEDNESDAY,THURSDAY, FRIDAY,SATURDAY) |
Threshold Runtime |
Estimated runtime in seconds for this specific job. This is an optional field which, when entered, will be used as a threshold. When this threshold is exceeded, the job is deemed long-running. For a complete explanation of how a job is deemed long-running, see the Long Running Jobs subsection of the Batch Job subsection of the Batch Schedule section of the Batch Concepts chapter of this document. |
Yes – Valid values are blank or an integer number of seconds. |
Enabled |
Flag indicating whether this job is enabled or disabled. |
Yes – Valid values are Y or N. |
Notify Job Start |
Flag indicating if a notification is to be sent at start of this job. |
Yes – Valid values are Y or N. |
Notify Job Completion |
Flag indicating if a notification is to be sent at successful completion of this job. |
Yes – Valid values are Y or N. |
Custom |
Flag indicating whether an ad hoc job is custom or not |
No |
Job Dependencies Tab
This tab contains the definitions of all intra-schedule dependencies (or job dependencies within the same schedule) for all cycles (Nightly, Recurring and Adhoc). External, inter-schedule dependencies and execution links are defined on the Job External Associations tab.
Only the Enabled flag can be changed on this tab. Caution should be exercised when disabling a dependency, as in certain situations this can cause a job to run before data is processed by the predecessor job. This can therefore cause data corruption.
Table 7-10 Job Dependencies Configuration
Field | Description | Modifiable? –Possible values |
---|---|---|
Job |
Job name. |
No |
Process |
Process name to which the job belongs. |
No |
Cycle |
Nightly, Adhoc or specific recurring/hourly cycle. |
No |
Predecessor Process |
Process name to which the predecessor job belongs. |
No |
Predecessor Job |
Job which must complete before the job defined on the current row can run. |
No |
Enabled |
Flag indicating whether this dependency is enabled or disabled. |
Yes – Valid values are Y or N. |
Job External Associations Tab
This tab contains the definitions of External dependencies, inter-schedule dependencies and execution links, so all dependencies other than the intra-schedule dependencies described in the previous section.
Note:
New external associations can be added in this tab.
External dependencies are usually those defined for customer processes. These are associated with a POM endpoint that the customer calls to satisfy the dependency.
Inter-schedule dependencies are those associated with another schedule. For instance, a Retail Insight job can be made to wait for a Merchandising job to complete.
An Execution link is a special dependency that sets up an application's schedule to be invoked based on a completion of a job in another application’s schedule. For instance, the Retail Insight schedule can be set up to be invoked when job A completes in the Merchandising schedule.
Table 7-11 Job External Associations
Field | Description | Modifiable? – Possible values |
---|---|---|
Job |
Job name. |
Yes – Needs to be a valid job name already defined on the nightly schedule. |
Process |
Process name to which the job belongs. |
Yes – Needs to be a valid process name already defined in the nightly schedule. |
Cycle |
Cycle name. |
Yes – This can only be Nightly. |
Association Type |
Type of dependency. |
Yes – Valid values are Internal for Inter-Schedule, External and EXEC_LINK |
External Schedule |
Name of the schedule containing the inter-schedule dependency or execution link. |
Yes – This must be an existing valid schedule defined in the same instance of POM. This is only required for inter-schedule dependencies and execution links. |
External Job |
Name of external job. |
Yes – In the case of an external dependency, this is the name that will be included in the payload of an endpoint called by the external system, such as the customer's. In the case of inter-schedule dependencies and execution links, this is a valid job name defined in the dependent schedule. |
External Process |
Process name to which the external job belongs. |
Yes – This is required for inter-schedule dependencies and execution links. It's the process name associated with the external job. |
Enabled |
Flag indicating whether this dependency is enabled or disabled. |
Yes – Valid values are Y or N. |
Scheduling Flows Tab
This tab and the next (Scheduling Adhoc Tab) contain multiple configurations for scheduling flows or processes to run at specified times.
This Scheduling Flows tab contains the definitions of scheduled run times for the Nightly and recurring flows.
It simply contains one row for the Nightly flow stating the time when the Nightly processes will start every day. In case of weekly configuration, nightly flows can contain multiple rows stating the different times for each day of the week to start the task.
The rest of the tab contains rows for each recurring flow, with columns for each of the hourly cycles making up the flow. For each cell at the intersection of Flow and hourly cycle, the time is entered for when the cycle is to start running. At present, there is a maximum of 24 hourly cycles that can be defined which, when spaced equally, would run one hour apart. Times are optional, so a blank cell indicates that the cycle will not be scheduled to run.
Note:
Although there is no validation that cross-references the presence of a time in a cell with the enabling of the cycle on the Flows Configuration tab, ideally these would match up. This means that, if you enter a time for running an hourly cycle, the same intersection on the Flows Configuration tab should be 'Y'. However, it is conceivable to enable the cycle on the Flows Configuration tab but not schedule it, leaving the option open to schedule it as needed. In fact, this is the recommended practice: Enable all hourly cycles and only schedule a few as needed, but have the option to run more to catch up when necessary.
The timezone region ID entered in cell B is used for all times entered for all subsequent cycles on a given row. It is possible to specify a different timezone for select time cells (for example, 5:00 America/Chicago).
Note:
If the timezone region ID is null in the database, UTC is exported as the default into cell B of this tab.
Frequency entered in the Frequency cell denotes different task frequencies like Daily and Weekly.
Day of week entered in the corresponding cell denotes the day on which the task is to be executed. It is left blank when the frequency is DAILY.
Table 7-12 Scheduling Flows
Field | Description | Modifiable? – Possible values |
---|---|---|
Flow |
Flow name. |
No |
Timezone Region ID |
Timezone corresponding to the time entered in the subsequent cell(s). Timezone region ID is required, rather than a UTC offset (such as "UTC-06:00"). This is to accommodate Daylight Saving Time. |
Yes – Valid timezone region IDs such as US/Eastern can be found as TZ database name at https://en.wikipedia.org/wiki/List_of_tz_database_time_zones |
Frequency |
Task frequency |
Yes – Valid values for this tab: DAILY, WEEKLY |
Day of week |
Day of the week for the task to run |
Yes – Valid values: MONDAY or TUESDAY or WEDNESDAY or THURSDAY or FRIDAY or SATURDAY or SUNDAY. Should be left blank for the DAILY frequency |
Nightly |
Only fill this cell if Flow is Nightly. Enter the time for starting the Nightly cycle. |
Yes – Enter a valid military time format such as 6:00 (6am) or 22:00 (10pm). |
Recurring cycle 1 |
Enter a time in this cell to schedule recurring cycle 1 to run at that time. Leave blank to forego scheduling recurring cycle 1. It is possible to not schedule the cycle by default but elect to run it manually if needed. |
Yes – Enter a valid military time format such as 6:00 (6am) or 22:00 (10pm). Conflict with the Nightly batch flow should be avoided as POM will skip running a recurring cycle if its start time is elapsed while Nightly is running. |
Recurring cycle 2 |
Enter a time in this cell to schedule recurring cycle 2 for running at that time. Leave blank to forego scheduling recurring cycle 2. It is possible to not schedule the cycle by default but elect to run it manually if needed. |
Yes – Enter a valid military time format such as 6:00 (6am) or 22:00 (10pm). Conflict with the Nightly batch flow should be avoided as POM will skip running a recurring cycle if its start time is elapsed while Nightly is running. |
Recurring cycle n |
Enter a time in this cell to schedule recurring cycle 1n for running at that time. Leave blank to forego scheduling recurring cycle n. It is possible to not schedule the cycle by default but elect to run it manually if needed. |
Yes – Enter a valid military time format such as 6:00 (6am) or 22:00 (10pm). Conflict with the Nightly batch flow should be avoided as POM will skip running a recurring cycle if its start time is elapsed while Nightly is running. |
Scheduling Adhoc Tab
This tab contains the definitions of scheduled run times for the Adhoc processes.
Table 7-13 Scheduling Adhoc
Field | Description | Modifiable? – Possible values |
---|---|---|
Name |
Adhoc process/Adhoc flow name. |
No |
Type |
Invokable type |
Yes – Valid values: Flow or Process |
Description |
Description of reason for running this Adhoc flow/process at the specified time. |
Yes – Optionally describe the purpose for scheduling the Adhoc flow/process at the specified time |
Frequency |
Frequency at which this Adhoc process/flow is to be run. |
Yes – Valid values are DAILY, ONCE, WEEKLY, MONTHLY, MONTHLY_START, MONTHLY_END, MONTHLY_BY_WEEKDAY |
Nth Day of Week in a Month |
Nth day of week in a month on which task has to be run |
Yes – Valid values are FIRST, SECOND, THIRD, FOURTH, LAST. |
Day of week |
Day of the week on which the task has to be run |
Yes – Valid values: MONDAY or TUESDAY or WEDNESDAY or THURSDAY or FRIDAY or SATURDAY or SUNDAY. |
Day of the Month |
Day of the Month on which the task has to be run |
Yes – Valid values: [1-31] |
Start Date |
Start Date of the task, only for frequency set to ONCE |
Yes – Valid value: valid date in the format yyyy-mm-dd. For example: 2023-01-05. |
Recurrence |
Indicates if an activated task is meant to run just once or recurs multiple times. |
Yes – Valid values: SINGLE/MULTIPLE. |
Interval |
Indicates an interval number of minutes the at which the task should run again. |
Yes – Valid values: Any positive integer number of minutes starting from 1. For example: 5, meaning this Adhoc will run every 5 minutes. |
Limit Occurrences |
Relevant only when frequency of EVERY:x is used. If a Limit Occurrences value is entered, the process will run a maximum of times equal to the specified limit. |
Yes – A positive integer. For example: Frequency of DAILY with a Limit Occurrences of 4 and Interval 2 means the process/flow will run every two minutes a maximum of four times |
Prevent start during nightly |
A flag which, when set to Y, indicates that this process is not to be started when the Nightly cycle is running. If the Scheduler tries to start a run while Nightly is running, the execution's status is set to Error with an Info message of "Nightly started running so can't run the process." |
Yes – Valid values are Y or N. |
Schedule Time |
Entering a time in this field causes the process to be scheduled at that time in case of a DAILY frequency or to start the first run at that time in case of an EVERY:x frequency. Leaving this field blank causes the process to run immediately or the first run to start immediately when the scheduler day starts. If a specific time is entered in this field but the scheduler day starts after that time, the process will be scheduled for the next day at that time. |
Yes – Enter a valid military time format such as 6:00 (6am) or 22:00 (10pm). |
Enabled |
Flag indicating if this process is to be scheduled. |
Yes – Valid values are Y or N. |
Timezone Region ID |
Timezone corresponding to the time entered in the subsequent cell(s). Timezone region ID is required rather than a UTC offset such as UTC-06:00. This is to accommodate Daylight Saving Time. |
Yes – Valid timezone region IDs such as US/Eastern can be found as TZ database name at https://en.wikipedia.org/wiki/List_of_tz_database_time_zones |
Notification Tab
This tab contains all POM-defined notification types and associated e-mail addresses and retention periods. For a list of notification types, refer to Emails and Notifications.
Table 7-14 Notifications Configuration
Field | Description | Modifiable? |
---|---|---|
Notification Type |
Type of notification. There are several events in POM for which notifications are generated. An example of a notification type is: NightlyStart. |
No |
Email Subscription |
Email address to which notifications of this type will be sent. |
Yes – Valid values are blank or correctly formed email addresses. |
Retention Period |
Period in days notifications generated for this type are to be retained in the system before purging.. |
Yes – Valid values are blank or an integer number of days. |
Custom Entities Configuration
Custom Entities include custom flows, processes and jobs. POM provides a feature, in the user interface, to export and import configuration of these custom entities.
Custom entities exported on a specific environment have to be imported back on a different environment without any modifications. Once these are configured and fine-tuned on an environment (for example, Stage) the export/import feature can be used to export the configuration as a JSON file then import it back into another environment (for example, production).
Note:
Custom entities configuration can’t be exported as or imported from spreadsheet. Only JSON export/import feature is supported for custom entities.Following are the validation rules for custom entities import:
-
If custom flows/processes are present in both source and target environments, importing custom entities won’t add new entities, meaning the makeup of custom Flows or Processes in the target environment can’t be altered.
-
If custom flows are not present in the target environment, import will create these custom flows in the target environment.
-
If custom processes are not present in the target environment, import will create those in the target environment.