Add descriptions of runtime components and add description of ZIS (#3272

) * add descriptions of runtime components and add description of ZIS Signed-off-by: Andrew Jandacek <[email protected]> * improve language per doc standards Signed-off-by: Andrew Jandacek <[email protected]> --------- Signed-off-by: Andrew Jandacek <[email protected]>
zowe · Nov 27, 2023 · 1edd197 · 1edd197
1 parent 66864c4
commit 1edd197
Showing 1 changed file with 20 additions and 10 deletions.
diff --git a/docs/user-guide/install-zos.md b/docs/user-guide/install-zos.md
@@ -2,19 +2,29 @@
 
 Installation of Zowe&trade; server-side components on z/OS, consists of the following two parts: 
 
-* **The Zowe runtime**, which consists of the following components: 
-   - Zowe Application Framework
-   - Zowe API Mediation Layer
-   - Z Secure Services (ZSS)
+* [Zowe runtime](#zowe-runtime)
+* [Zowe Cross Memory Server (ZIS)](#)
 
-* **The Zowe Cross Memory Server (ZIS)**  
+## Zowe runtime
 
- An APF authorized server application that provides privileged services to Zowe in a secure manner.
+The Zowe runtime consists of the following three components: 
 
-:::note**Notes**
-* Zowe offers the possibility to run some of its Unix components in a container rather than under USS. For more information, see [Installing Zowe via a containerization build (PAX filw)](k8s-introduction.md).
-* Zowe also offers the option of configuration for high availability. For more information, see [Configuring high availability (optional)](zowe-ha-overview.md).
-:::
+- **Zowe Application Framework**  
+Zowe Application Framework modernizes and simplifies working on the mainframe via a web visual interface. Functionality is provided through apps and a desktop user experience, which is referred to as the Zowe Desktop. Base functionality includes apps to work with JES, MVS Data Sets, Unix System Services, as well as a 3270 Terminal, Virtual Terminal, and an Editor. 
+
+- **Zowe API Mediation Layer (API ML)**  
+Zowe API ML provides a reverse proxy and enables REST APIs by providing a single point of access for mainframe service REST APIs like MVS Data Sets, JES, as well as working with z/OSMF. Zowe API ML has dynamic discovery capability for these services and Gateway is also responsible for generating the authentication token used to provide single sign-on (SSO) functionality.
+
+- **Z System Services Server (ZSS)**  
+ZSS serves as one of the primary, authenticated back-ends that communicates with z/OS and works closely with ZIS. ZSS  provides Zowe with a number of APIs including z/OS Unix files and data sets, control of the plug-ins and services lifecycle, security management, and others. The Zowe Desktop delegates a number of services to ZSS which can then be  accessed through the default http port `7557`. ZSS is written in C and uses native calls to z/OS to provide its services.
+
+## The Zowe Cross Memory Server (ZIS)  
+
+After the installation of Zowe runtime, install the Zowe Cross Memory Server (ZIS).
+
+The Zowe Cross Memeory Server, also referred to as Zowe Interprocess Services (ZIS) is an APF authorized server application that provides privileged services to Zowe in a secure manner. For security reasons, ZIS is not an HTTP server. Instead, this server has a trust relationship with ZSS.
+
+Other Zowe components can work through ZSS to handle z/OS data that would otherwise be unavailable or where access to these data could be vulnerable to security breaches.
 
 ## Roles and responsibilities for server-side component installation