Add tutorial to deploy a CICS policy sample

Signed-off-by: Mark Cocker <[email protected]>

Author: markcocker

docs/_data/sidebars/cdp_sidebar.yml

@@ -23,7 +23,7 @@ entries:
       output: web
 
   - title: Tutorials
-    url: cdp-Deploying-your-first-nodejs-app.html
+    url: cdp-Preparing-a-zOS-PT-image.html
     output: web
     folderitems:
     - title: Preparing a z/OS PT image
@@ -35,6 +35,9 @@ entries:
     - title: Deploying your first Node.js app
       url: cdp-Deploying-your-first-nodejs-app.html
       output: web
+    - title: Deploying a CICS policy
+      url: cdp-Deploying-a-CICS-policy.html
+      output: web
     - title: Deploying using individual actions
       url: cdp-Deploying-using-individual-actions.html
       output: web

docs/pages/cdp/cdp-Deploying-a-CICS-policy.md

@@ -0,0 +1,55 @@
+---
+title: Deploying a CICS policy
+tags: [tutorial]
+keywords:
+summary: "The following steps take you through deploying a CICS policy using CICS Explorer."
+sidebar: cdp_sidebar
+permalink: cdp-Deploying-a-CICS-policy.html
+folder: cdp
+toc: true
+---
+
+[CICS policies](https://www.ibm.com/support/knowledgecenter/en/SSGMCP_5.5.0/fundamentals/policies/policies.html) are used to monitor the state of the CICS region, and the resources and workload in it. A policy consists of rules that define the conditions the required to be met for the rule to trigger, and the action to take when the conditions are met.
+
+This tutorial shows how to download an example CICS policy and deploy it using the CICS deploy plug-in. The policy will result in a CICS message DFHMP3009 being written when the number of active tasks in your CICS regions goes above 90% of your MXT value. This sample is described in article [Using CICS policy system rules to monitor system health](https://developer.ibm.com/cics/2017/07/04/using-cics-policy-system-rules-monitor-system-health/).
+
+### Procedure
+
+1. Install the Zowe CLI and plug-ins by following the steps in [Installing](cdp-Installing).
+
+2. Create Zowe CLI profiles by following the steps in [Creating Zowe CLI profiles](cdp-Creating-Zowe-CLI-profiles).
+
+3. Clone the [cics-policy-samples](https://github.ibm.com/CICS/cics-policy-samples/tree/master) repository.
+
+   ```text
+   git clone https://github.ibm.com/CICS/cics-policy-samples.git
+
+   cd cics-policy-samples/bundles/CICSDEV_system_rule
+   ```
+
+4. Deploy the CICS bundle into CICS.
+
+   ```text
+   zowe cics-deploy push bundle --name Policy --overwrite
+   ```
+
+   A progress bar is shown with status messages as the CICS bundle is deployed. This can take a few minutes. The command will summarize the deployment, for example:
+
+   <pre class="messageText">
+   WARNING: No .zosAttributes file found in the bundle directory, default values will be applied.
+   Regions in scope 'CICPY000' of CICSplex 'ZOSPTINT':
+      Applid: CICPY000   jobname: CICPY000   jobid: STC47025   sysname: MV2C
+   PUSH operation completed</pre>
+
+   The warning can be ignored as the default values result in the files being uploaded in text that is suitable for this bundle.
+
+   The CICS BUNDLE resource named `Policy` is defined, installed, and enabled in CICS. If the BUNDLE `Policy` was already defined or installed in CICS, it is undeployed first. As the BUNDLE is enabled, the policy is also enabled. If there are errors, retry with the `--verbose` option for more detailed output, or refer to [Troubleshooting](cdp-Troubleshooting-General).
+
+### Results
+
+The CICS policy is enabled in the CICS region. When the policy rule is triggered, CICS will write message DFHMP3009 to the CICS region JES job log. See [Log and trace files](cdp-Troubleshooting-General).
+
+To get started with defining your own CICS policy:
+* [Download and start the CICS Explorer](https://www.ibm.com/support/knowledgecenter/en/SSSQ3W_5.5.0/com.ibm.cics.core.help/topics/concepts/install_planning_client.html).
+* Create a CICS bundle project using the procedure [Creating a CICS bundle project](https://www.ibm.com/support/knowledgecenter/SSSQ3W_5.5.0/com.ibm.cics.core.help/topics/tasks/create_bundle.html).
+* Create a policy using the procedure [To create a policy in a CICS bundle project](https://www.ibm.com/support/knowledgecenter/SSSQ3W_5.5.0/com.ibm.cics.core.help/topics/tasks/task_create_policy.html).

docs/pages/cdp/cdp-Provisioning-a-CICS-region.md

@@ -80,10 +80,10 @@ Before you can provision a CICS region, a z/OS PT image needs to be created and
 
 7. Update your Zowe CLI cics-deploy profile to deploy to your CICS region by default.
 
-   Update `--scope` to specify the value from DFH_REGION_APPLID, and `--bundle-directory` to specify the `bundles` subdirectory of DFH_REGION_ZFS_DIRECTORY. For example:
+   Update `--scope` to specify the value from DFH_REGION_APPLID, and `--target-directory` to specify the `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"
+   zowe profiles update cics-deploy cics --scope CICPY000 --target-directory "/u/cicprov/mnt/CICPY000/bundles"
    ```
 
 #### Results