From acfb11e01073392a6be9ff1d5ae5a40e4a1f2c40 Mon Sep 17 00:00:00 2001
From: Wirawan Purwanto <wpurwant@turing.hpc.odu.edu>
Date: Fri, 9 Sep 2016 16:50:40 -0400
Subject: [PATCH] * Initial form of documentation.

---
 doc/SGE-tools.txt | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100755 doc/SGE-tools.txt

diff --git a/doc/SGE-tools.txt b/doc/SGE-tools.txt
new file mode 100755
index 0000000..4632ac6
--- /dev/null
+++ b/doc/SGE-tools.txt
@@ -0,0 +1,29 @@
+
+Various SGE utilities
+=====================
+
+
+find-run-hosts.sh
+-----------------
+
+This tool returns information about execution hosts and processes
+related to a given job.
+
+Usage:
+
+`find-run-hosts.sh <JOBID>`::
+Lists the hosts where this job is executing, which also shows how many
+cores are allocated on each node for this job.
+
+`find-run-hosts.sh process <JOBID>`::
+Dumps the processes on the executing nodes of this job
+(in `ps --forest` format).
+
+`find-run-hosts.sh master-node <JOBID>`::
+Finds out the master node of this job.
+
+`find-run-hosts.sh list-nodes <JOBID>`::
+LIsts all the nodes allocated for this job.
+
+
+