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:

  1. 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.

  2. 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.

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 which is multiplied by a job's average run time to determine the threshold which, when exceeded, the job is deemed long running.

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 EXEC, RI, RASE, BDI, RPAS, RDS, OMS, OB.

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 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 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. If this field is blank, then the job's average run time is used instead to multiply by the Long Run Average Multiplier for determining the threshold.

If this field is 0 or there is no history of job runs, the job will not go to long-running immediately. Instead, it will wait for the default long running threshold run time of 10 minutes. This default value can be overridden by changing the value of batch schedule variable defaultLongRunningThresholdRunTime in the System Configuration screen.

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 EXEC, RI, RASE, BDI, RPAS, RDS, OMS, OB

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. If this field is blank, then the job's calculated average run time is used instead to multiply by the Long Run Average Multiplier for determining the threshold.

If this field is 0 or there is no history of job runs, the job will not go to long-running immediately. Instead, it will wait for the default long running threshold run time of 10 minutes. This default value can be overridden by changing the value of batch schedule variable defaultLongRunningThresholdRunTime in the System Configuration screen.

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 EXEC, RI, RASE, BDI, RPAS, RDS, OMS, OB

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. If this field is blank, then the job's calculated average run time is used instead to multiply by the Long Run Average Multiplier for determining the threshold.

If this field is 0 or there is no history of job runs, the job will not go to long-running immediately. Instead, it will wait for the default long running threshold run time of 10 minutes. This default value can be overridden by changing the value of batch schedule variable defaultLongRunningThresholdRunTime in the System Configuration screen.

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.