Enabling the auto-locate cron task

Maximo Anywhere provides a cron task, WoAutoLocateCronTask, that is set up to run the auto-locate function. By default, the cron task is not enabled because map support is optional in Maximo Anywhere. If you enable map capabilities, you must enable the cron task.

About this task

The auto-locate function in Maximo® Asset Management updates or adds positioning information to work orders. This positioning information is used in the Maximo Anywhere Work Execution and Maximo Anywhere Inspection apps to plot work order locations on the map view.

The WoAutoLocateCronTask runs the auto-locate function. This cron task includes two cron task instances:

  • By default, the WoAutoLocateInstance instance selects work orders that have a scheduled or target start date that occurs within two days of the current time. Schedule this instance to run every 24 hours so that positioning information is updated or added to all work orders that are due to start within two days.
  • By default, the EmergentWoTask instance selects work orders that were approved or started in the 5-minute period before the current time. Schedule this instance with the frequency that work orders might be approved or started so that positioning information is updated or added to these work orders.

You can change the work order selection criteria for both cron task instances by modifying the WO_WHERECLAUSE parameter. For the EmergentWoTask instance, you can modify the EMERG_WO_TIME parameter.

Procedure

  1. In the Cron Task Setup application in Maximo Asset Management, open the WoAutoLocateCronTask record.
  2. Define the settings for each cron task instance:
    1. Set a schedule for the cron task instance. At a minimum, the value of the EMERG_WO_TIME parameter should equal the number of minutes set in the schedule. This parameter acquires all work orders that were modified from the time the schedule runs, to twice the value of this parameter. For example, if this parameter is set to 5 minutes, all work orders that were modified in the previous 10 minutes are acquired.
    2. Specify a user with the necessary privileges, such as maxadmin. The user must have access for the actions that the cron task performs.
    3. Select the Active and Keep History check boxes.
    4. In the Max Number of History Records field, enter 1000.
    5. Optional: To change the criteria for work order selection, update the WO_WHERECLAUSE parameter.
  3. From the Select Action menu, select Reload Request.
  4. Select the cron task, and click OK.