Further tweaks

Author: markcocker

docs/pages/cdp/cdp-Deploying-into-zospt-cics-region.md

@@ -9,47 +9,45 @@ folder: cdp
 toc: true
 ---
 
-The [z/OS Provisioning Toolkit](https://developer.ibm.com/mainframe/products/zospt/) (z/OS PT) provides a command line utility provision CICS regions and other development environment on z/OS. This tutorial requires z/OS PT version 1.1.5 or above to be installed.
+The [z/OS Provisioning Toolkit](https://developer.ibm.com/mainframe/products/zospt/) (z/OS PT) provides a command line utility to provision CICS regions and other development environment on z/OS. This tutorial requires z/OS PT version 1.1.5 or above to be installed.
 
 ### Prepare a z/OS PT image
 
-A z/OS PT image contains the configuration and files necessary to provision the CICS region. This is typically prepared by the CICS system programmer for use by many developers. The configuration should include:
+A z/OS PT image contains the configuration and files necessary to provision the CICS region. This is typically prepared by the CICS system administrator for use by many developers. The [configuration properties](https://www.ibm.com/support/knowledgecenter/en/SSXH44E_1.0.0/zospt/cics/zospt-cics-properties.html) for the CICS image should include:
 
 | zosptfile entry                      | Usage |
 | --- | -- |
-| `FROM cics_55` | Build a CICS TS V5.5 region |
-| `ENV DFH_NODE_HOME=` | Specify the directory for IBM SDK for Node.js - z/OS |
-| `ENV DFH_CICS_TYPE=MAS` | Specify the CICS region should be managed by CPSM |
-| `ENV DFH_CICSPLEX=` | Specify the name of the CICSplex |
+| `FROM cics_55` | Provision a CICS TS V5.5 region |
+| `ENV DFH_CICS_TYPE=MAS` | The CICS region should be managed by CPSM |
+| `ENV DFH_CICSPLEX=` | The name of the CICSplex |
+| `ENV DFH_NODE_HOME=` | The directory for IBM SDK for Node.js - z/OS |
 | `COPY bundles bundles` | Create an empty bundles directory in the provisioned file system to contain CICS bundles |
 
-For example, to create the z/OS PT image source directory and configuration file, and build it ready for developers to provision a CICS region:
+For example, to create the z/OS PT image source directory and configuration file, and build it ready for developers to provision CICS regions:
 
 ```console
 export ZOSPTIMAGE=~/zosptimages/cics_55_nodejs
 
 mkdir -p $ZOSPTIMAGE/bundles
 
-cat > $ZOSPTIMAGE/zosptfile << EOF
+iconv -f IBM1047 -t UTF-8  > $ZOSPTIMAGE/zosptfile << EOF
 FROM cics_55
-ENV DFH_NODE_HOME=/usr/lpp/IBM/cnj/IBM/node-latest-os390-s390x
 ENV DFH_CICS_TYPE=MAS
 ENV DFH_CICSPLEX=ZOSPTINT
+ENV DFH_NODE_HOME=/usr/lpp/IBM/cnj/IBM/node-latest-os390-s390x
 COPY bundles bundles
 EOF
 
-cat $ZOSPTIMAGE/zosptfile | iconv -f IBM1047 -t UTF8 > $ZOSPTIMAGE/zosptfile
-
 chtag -tc UTF-8 $ZOSPTIMAGE/zosptfile
 
 zospt build $ZOSPTIMAGE -t cics_55_nodejs
 ```
 
 ### Provision your CICS region and deploy a Node.js application
 
-1. Update your user `.profile` file on z/OS.
+1. Update your user `.profile` file on z/OS to run z/OS PT.
 
-   Add the path to the `zospt` command to your PATH, and add the following environment variables as described in [Configuring z/OS Provisioning Toolkit](https://www.ibm.com/support/knowledgecenter/en/SSXH44E_1.0.0/zospt/zospt-configuring.html):
+   Add the directory to the `zospt` command to your PATH, and add the following environment variables as described in [Configuring z/OS Provisioning Toolkit](https://www.ibm.com/support/knowledgecenter/en/SSXH44E_1.0.0/zospt/zospt-configuring.html):
 
    ```properties
    export zospt_domain=
@@ -59,7 +57,7 @@ zospt build $ZOSPTIMAGE -t cics_55_nodejs
 
 2. Provision your CICS region.
 
-   Use the `--name` option to specify a name for the container that is easy to remember for use in later commands. This may take several minutes.
+   Use the `--name` option to specify a name for the container that is easy to remember for use in later commands. The provisioning steps may take several minutes to complete.
 
    ```console
    zowe zos-uss issue ssh "zospt run cics_55_nodejs --name my_cics_region"
@@ -71,14 +69,14 @@ zospt build $ZOSPTIMAGE -t cics_55_nodejs
    zowe zos-uss issue ssh "zospt inspect my_cics_region"
    ```
 
-   The output will include values for the CICS region application ID, and the z/OS directory within which your CICS bundles can be uploaded. For example:
+   The output is in JSON format and includes values for the CICS region application ID, and the z/OS directory within which your CICS bundles can be uploaded. For example:
 
    ```json
     "DFH_REGION_APPLID": "CICPY000",
     "DFH_REGION_ZFS_DIRECTORY": "/u/cicprov/mnt/CICPY000",
     ```
 
-4. Update your Zowe cics-deploy profile with the CICS region application ID and z/OS directory. For example:
+4. Update your Zowe cics-deploy profile options `--scope` to be the value from DFH_REGION_APPLID and `--bundle-directory` to be a bundles subdirectory of DFH_REGION_ZFS_DIRECTORY. For example:
 
    ```console
    zowe profiles update cics-deploy cics --scope CICPY000 --bundle-directory /u/cicprov/mnt/CICPY000/bundles
@@ -92,15 +90,15 @@ zospt build $ZOSPTIMAGE -t cics_55_nodejs
 
 ### Stop your CICS region
 
-The CICS region can be stopped if you are not going to be using it for a while using command:
+The CICS region and the applications running in it can be stopped if you are not going to be using it for a while by using command:
 
 ```console
 zowe zos-uss issue ssh "zospt stop my_cics_region"
 ```
 
 ### Start your CICS region
 
-The CICS region can be started if it was previous stopped, or the z/OS system was restarted using command:
+The CICS region can be started after it was previously stopped, or the z/OS system was restarted, by using command:
 
 ```console
 zowe zos-uss issue ssh "zospt start my_cics_region"