O4 Batch Services & Batch Jobs

Batch jobs and services are now a primary element of OASIS. For example, Tiles run in batch jobs quietly with other services in the background. OASIS users with admin access to "Software" can view and manage these features, including being able to see which computers that jobs and services are running on as well as the jobs that are scheduled to run. 

Locating Batch Services & Batch Jobs

1. Navigate to the O4 Dashboard.

2. The O4 Home page will appear.

3. Select the  button.

4. Select Configuration from the drop-down list.

5. Select "Jobs."

6. Select "Batch Services" or "Batch Jobs" from the drop-down list.

O4 Batch Services

Each installation of OASIS contains a full implementation of the OASIS batch service that will become active anytime OASIS is started. This process can not be stopped, but can be disabled. Additionally, the web version of OASIS can be used to start the batch service anytime the computer is restarted. This is important for servers dedicated to running OASIS batch services.

1. Select a Batch Service. Batch services can be located in two categories:

• Active- the batch service is active
• Not Active- the batch service is not active

2. The Batch Service Viewer will appear.

3. The Batch Service Viewer will show the following attributes:

• Software- this is the software version. Note: if a new version of OASIS is deployed, the service will take itself offline until OASIS is restarted and the new version is loaded.
• State- shows the status of the service
• Update- the last time the service responded; this date should update every 2-5 minutes
• Active- shows "true" if the service is running, shows "false" if the service is not running
• Server- shows "Y" if service has been identified as a server. Note: when running, non-servers will not run jobs unless all servers are unavailable
• Processes- the number of batch job processes allowed to run concurrently on the service

4. Select the  button.

5. The "Edit Batch Service" window will appear.

6. Make changes as necessary.

7. Select "Ok."

O4 Batch Jobs

An OASIS batch job is a feature of OASIS that runs in the background without user input. The feature may be a standard part of OASIS, or custom code designed for a single customer. For over a decade, we have used batch jobs to download information from factories, process reports, and even synchronize databases.

1. Select a batch job. Batch jobs can be located in three categories:

• Active- the batch job is active
• Not active- the batch job is inactive
• Disabled- the batch job is disabled

2. The Batch Job Viewer will appear.

3. The Batch Job Viewer will show the following attributes:

• Job- the name of the batch job
• Status- the current status of the batch job. Note: "Running" and "End" are the most common. "Never Run" is used to force the job to run.
• Summary- unique to the job, this is an overall status such as"125 orders updated"
• Time Pattern- common patterns are:
  • ONCE- run one time and if no exceptions, don't run again
  • ALWAYS- will restart every time. Other jobs are given a chance to run first
  • DELAY=#- run and then delay # minutes before restarting
  • Or a more complex set of the following may be used in a semicolon list:
    • YEAR=#- year to run
    • MONTH=#- month to run
    • MDAY=#- day of month
    • WDAY=#- day of week
    • HOUR=#- 24-hour clock
    • MINUT=#- minute to run
• Affinity- lists the affinity host and affinity DBID
• Disabled- shows "Y" if the job has been disabled by user edit
• History- shows the previous times the job has run. Note: each run is called a cycle. Selecting a cycle will open the cycle editor.

4. Select the  button.

5. The "Edit Batch Job" window will appear.

6. Users may change the state, the number of cycles kept in history, the affinity host, or the affinity DB for the batch job.

• Disabled- check the box to disable the job (this will not kill a running job)
• Keep Cycles- number of cycles to keep in history (1 will always be kept)
• Affinity Host- force the job to run on a given host. Note: the hostname is how your computer identifies itself to the network. It is not the same as the IP address.
  • To get your hostname on a PC, open a command prompt and type the command "hostname". Alternatively, you can go to Control Panel > System and your hostname/ device name/ computer name will be listed there.
  • To get your hostname on a Mac, run Terminal in Applications/Utilities and type in "hostname".
• Affinity DB- allows only the machines that are connected to the listed DBIDs to run the service

7. Make changes as necessary.

8. Select "Ok" to save the changes. Select "Restart!" to force the job to run as soon as possible.