Programmer's Guide

Here is a very simple example application. It adds two numbers together and writes the result to the console.

using System;
using AGI.Parallel.Client;
using AGI.Parallel.Infrastructure;

namespace CodeSamples
{
    class Program
    {
        static void Main(string[] args)
        {
            using (IJobScheduler scheduler = new ClusterJobScheduler("localhost"))
            {
                scheduler.Connect();
                Job job = scheduler.CreateJob();
                Task task = new SimpleTask(1, 1);
                job.AddTask(task);
                job.Submit();
                job.WaitUntilDone();
                Console.WriteLine("Result = " + task.Result);
            }
        }

        [Serializable]
        public class SimpleTask : Task
        {
            private int a;
            private int b;

            public SimpleTask(int first, int second)
            {
                a = first;
                b = second;
            }

            public override void Execute()
            {
                Result = a + b;
            }
        }
    }
}

Copy and paste the code into a Visual Studio project, compile, and run. The application first connects and submits a task to the coordinator. Next, an agent will be assigned the work and execute the task in an isolated process. Finally, the result of the task is sent back to the client.

Step through the code in Visual Studio line by line. Examine the messages written from the coordinator and agent consoles. Take note of how the coordinator and agent respond after stepping through each line. For example, stepping past job.Submit will cause the coordinator console to log "added task to queue". What this means will be discussed later.

Continue to experiment with this application. Try to add more tasks to the job, set the jobs's TaskEnvironment, or modify some of the job options. As this example shows, the basic structure and core pieces of an application written with the API are simple but powerful!