Major commit

Signed-off-by: worksofliam <mrliamallan@live.co.uk>

Author: worksofliam

src/content/docs/guides/Clients.md

@@ -13,11 +13,11 @@ Available:
 * [Java](/guides/usage/java)
 
 Future SDKs:
+
 * C#/.NET Core
 * PHP
 * Go
 
-
 ### App examples
 
 The [samples repository](https://github.com/Mapepire-IBMi/samples) contains a number of sample client applications using Mapepire!

src/content/docs/guides/Usage/nodejs.md

@@ -14,13 +14,17 @@ Using Db2 for IBM i with Node.js is easy. First, install the package:
 npm i @ibm/mapepire-js
 ```
 
+#### Sample Application
+
+See our sample Node.js applications in the [mapepire-samples](https://github.com/Mapepire-IBMi/samples/tree/main/typescript) repository.
+
 ## Basic architecture
 
 mapepire-js is a pooling asynchronous client to an instance of the [mapepire-server](https://github.com/Mapepire-IBMi/mapepire-server). The mapepire-server authorizes and mediates connections to an IBM i Db2 server on behalf of the client.
 
 This document illustrates the use of the mapepire-js client. Other language clients and the mapepire-server itself are documented elsewhere.
 
-### Simple test
+### Making a connection
 
 Credentials belong in an object which can be passed to a `Pool` or `SQLJob`.
 
@@ -50,6 +54,53 @@ async function listObjects(library: string) {
 listObjects('QGPL');
 ```
 
+### Parameters
+
+Parameters can be passed to queries when they are being executed.
+
+```ts
+const query = job.query<any[]>(`select * from table where col = ?`, {parameters: [`value`]});
+```
+
+And it is also possible to pass in batches of parameters:
+
+```ts
+const query = job.query<any[]>(
+  "update SAMPLE.DELETEME set phone = ? where name = ?",
+  {
+    parameters: [
+      ["789-678-6543", "SANJULA"],
+      ["222-456-1234", "TONGKUN"],
+      ["123-456-7891", "JAMES"],
+    ],
+  }
+);
+```
+
+### Paging
+
+Paging can be used to block fetch rows in chunks.
+
+```ts
+const query = await job.query<any>("select * FROM SAMPLE.SYSCOLUMNS");
+let res = await query.execute();
+while (!res.is_done) {
+  res = await query.fetchMore(300);
+  console.table(res.data);
+}
+await query.close();
+await job.close();
+```
+
+### CL commands
+
+CL commands can be executed through an SQLJob.
+
+```ts
+const query = await job.clcommand("INVALIDCOMMAND");
+const res = await query.execute();
+```
+
 ### Pooling
 
 For typical production workloads, a connection pool should be used and created when in your apps startup process.
@@ -62,6 +113,19 @@ const pool = new Pool({ creds, maxSize: 5, startingSize: 3 });
 await pool.init();
 ```
 
+#### Execute in a pool
+
+`pool.execute` will automatically find a free job and execute the query. If there are no free jobs, it will find the least busy job and wait for it to become free.
+
+```ts
+const pool = new Pool({ creds, maxSize: 5, startingSize: 3 });
+
+await pool.init();
+
+const result = await pool.execute(`values current user`);
+console.log(result);
+```
+
 ### Securing
 
 By default, Mapepire will always try to connect securely. A majority of the time, servers are using their own self-signed certificate that is not signed by a recognized CA (Certificate Authority). There are two options with the Node.js client: