You can monitor jobs on the My Jobs page. This page lists all jobs that are started in Reference 360. You can schedule jobs to ensure that the job executes at a specified time.
To open the My Jobs page, click My Jobs in the left navigation bar.
My jobs page
The Imports tab on the navigation bar is enhanced and renamed to My Jobs. You can monitor the jobs instances and job schedules on the My Jobs page.
The My Jobs page contains the following tabs:
•Job Instances. Lists the job instances that are currently running, failed, stopping, stopped, and successfully completed.
•Job Definitions. Lists all the reference data import and export jobs. You can modify the properties of the jobs and rerun the reference data import and export jobs.
•Job Schedules. Lists the job schedules.
To filter the jobs that appear on the My Jobs page, click the Filter icon. You can use filters to find specific jobs. To specify a filter, click Add Field, and select the property such as job type and status, to filter results.
When you search for a job on the My Jobs page, the search results display jobs based on instance ID, started by, job name, and status fields. The instance ID and started by fields do not appear on the Job Instances tab of the My Jobs page.
You can search for reference data import jobs and reference data export jobs with asset names. You can search for a job schedule only using schedule names.
The following image shows the list of job instances on the My Jobs page:
By default, the following properties display for each job instance:
Property
Description
Asset Name
Name of the asset.
- For file import jobs and Reference 360 draft jobs, displays the asset name to which data is imported.
- For reference data import jobs and reference data export jobs, displays the job name.
Note: Clicking the asset name of a file import job opens the asset.
Job Type
The type of job that was executed.
Start Time
Date and time that the job started.
End Time
Date and time that the job completed or stopped.
Duration
Time taken for the job to run.
Status
Status of the job instance.
To view the job details, click the status of the job. To download error reports for the failed jobs, click the Download icon in the Status column of the failed jobs. You can view error messages and a summary of rejected and invalid records in the error reports.
Viewing specific job details
On the My Jobs page, click the status of any job to view detailed information about the job. If errors occur during a job execution, you can view the error details in the process steps of the job.
You can view key metrics about the job, such as total records processed, records processed successfully, and failed records. The metrics vary for each job.
You can view the overall data flow process for each job instance. Select a specific process step to view the step level details. The details displayed for the job vary based on the job type.
Note: The number of processed records for reference data import jobs shows the summary of all types of imported records, such as business entity records and relationship records, to identify which record type failed. For example, when you import 5 rows of flat code lists, the Input Rows field displays the number of processed records as 10 which includes the business entity records and the relationship records.
The following image shows the details of a reference data import job:
1Overview. Lists the details of the job instance for each step, such as instance ID, status, start time, end time, and duration.
2Runtime Parameters. Lists the runtime parameters of the job instance and each step.
3Metrics. Lists the key metrics related to each step, such as total records processed.
4Errors. Lists the rejected and invalid records that failed to adhere to data quality rules.
Creating a job schedule
Schedule a job to ensure that the job executes at a specified time. You can also set a frequency to repeat the job at regular intervals. Ensure that you create a job before creating the job schedule.
1On the My Jobs page, click Job Schedules > Add Job Schedule.
The New Job Schedule page appears.
2Enter the name of the job schedule.
3To select a job, perform the following tasks:
aClick the asset picker.
The Select a Job Definition page appears.
bSelect a project, and then select a job definition.
cClick Select.
4Select an existing IICS schedule, or add a new schedule. To add a new IICS schedule, perform the following tasks:
aClick New Schedule.
The New Schedule dialog box appears.
bEnter the name and description of the schedule.
cSelect the start date and time of the schedule.
dSelect the time zone for the schedule.
eTo run the job again in a schedule, select a frequency.
fClick Save.
5Click Save to save the job schedule.
Modifying and rerunning reference data import and export jobs
You can modify the properties of the existing reference data import and export jobs after you create them. You can also rerun the jobs.
1On the My Jobs page, click the Job Definitions tab.
You can view the existing reference data import and export jobs.
2To rerun the job, click Run.
You can monitor the status of job on the My Jobs page.
3To modify the properties of a job, perform the following tasks:
aClick the job.
You can view the details of the job.
bClick Actions > Properties.
cModify the display name and description of the job.
Note: You can't modify the location of the job.
dClick OK.
System-generated jobs
Reference 360 runs system-generated jobs to complete operations that take longer than expected.
Reference 360 draft job
The Reference 360 draft job is a system-generated job that runs when you import large number of code values to a draft code list and publish or discard the draft code list. The code list is locked when the job is triggered.
When operations, such as publishing or discarding a draft code list with large code value changes take longer than expected, the Reference 360 draft job starts to complete these operations. You can view the job details on the My Jobs page.
To stop a Reference 360 draft job that is in progress, perform one of the following tasks on the My Jobs page:
•On the Actions menu of the job, click Stop.
•Click the status of a job that is running, and then click Stop on the job details page.
You can restart a job. A new job is triggered when you restart the job that is stopped.
Viewing Reference 360 draft jobs
After the Reference 360 draft job is run, you can monitor and view the job details.
The following image shows a sample Reference 360 draft job type:
You can view the following steps in a Reference 360 draft job:
•Commit Changelist. Commits large code value changes to a draft code list.
Note: The status of the code list changes to unlocked after the commit changelist step is complete.
•History, Publish Events. Generates the history feed for the imported code values.
•Index for Search. Indexes the code values for search.
•Generate Tokens. Generates tokens for the code values.
Click each step within a data flow to view more information. The parameters vary based on the step.
Note: You can view the history details of the imported code values only when the history, publish events step is complete.
Stopping reference data import and file import jobs
You can stop reference data import and file import jobs that are in progress. For example, if a job takes a longer time to complete, you might want to stop it. You can't resume a job that is stopped.
To stop a job, perform one of the following tasks on the My Jobs page:
•On the Actions menu of the job, click Stop.
•Click the status of a job that is running, and then click Stop on the job details page.
If you stop the reference data import and file import jobs during or after the Load step, the data is partially imported. To find and process this data, contact your administrator.
You can also download error reports for the stopped file import jobs.
