From 45abaa4eb0d717f4791f08f03090d078409b25cb Mon Sep 17 00:00:00 2001
From: Abdirahim Musse <33973272+abmusse@users.noreply.github.com>
Date: Tue, 28 Apr 2020 16:16:09 -0500
Subject: [PATCH] docs: Add cosine.js for addReturn() example

---
 docs/ProgramCall.rst    |  9 ++++++++-
 docs/examples/cosine.js | 27 +++++++++++++++++++++++++++
 2 files changed, 35 insertions(+), 1 deletion(-)
 create mode 100644 docs/examples/cosine.js

diff --git a/docs/ProgramCall.rst b/docs/ProgramCall.rst
index 9b74299e..1eca1523 100644
--- a/docs/ProgramCall.rst
+++ b/docs/ProgramCall.rst
@@ -13,7 +13,7 @@ ProgramCall API
 .. autofunction:: returnConfig
 .. autofunction:: data
 
-Example
+Examples
 ^^^^^^^^
 
 Call the QUSROBJD Program
@@ -21,3 +21,10 @@ Call the QUSROBJD Program
 
 .. literalinclude:: examples/qusrobjd.js
    :language: javascript
+
+Retrieve the Return Value From a Service Program
+""""""""""""""""""""""""""""""""""""""""""""""""
+
+.. literalinclude:: examples/cosine.js
+   :language: javascript
+
diff --git a/docs/examples/cosine.js b/docs/examples/cosine.js
new file mode 100644
index 00000000..41e2e84e
--- /dev/null
+++ b/docs/examples/cosine.js
@@ -0,0 +1,27 @@
+const { Connection, ProgramCall } = require('itoolkit');
+const { parseString } = require('xml2js');
+
+const conn = new Connection({
+  transport: 'ssh',
+  transportOptions: { host: 'myhost', username: 'myuser', password: 'mypassword' },
+});
+
+const program = new ProgramCall('QC2UTIL2', { lib: 'QSYS', func: 'cos' });
+
+program.addParam({ type: '8f', value: '0' });
+program.addReturn({ type: '8f', value: '' });
+
+conn.add(program);
+conn.debug(true);
+
+conn.run((error, xmlOutput) => {
+  if (error) {
+    throw error;
+  }
+  parseString(xmlOutput, (parseError, result) => {
+    if (parseError) {
+      throw parseError;
+    }
+    console.log(result.myscript.pgm[0].return[0].data[0]._); // 1
+  });
+});