You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# zowe-cli-cics-deploy-plugin
2
2
3
-
This project provides a plug-in for [Zowe CLI](https://github.com/zowe/zowe-cli) to deploy applications developed on a workstation to IBM CICS® Transaction Server for z/OS (CICS). It aims to provide an experience similar to deploying to a cloud platform when deploying to CICS®. It will also provide low-level commands for performing individual steps of the deployment process that could be used as part of a CI/CD pipeline.
3
+
This project provides a plug-in for [Zowe CLI](https://github.com/zowe/zowe-cli) to deploy applications developed on a workstation to IBM CICS® Transaction Server for z/OS® (CICS). It aims to provide an experience similar to deploying to a cloud platform when deploying to CICS®. It will also provide low-level commands for performing individual steps of the deployment process that could be used as part of a CI/CD pipeline.
The cics-deploy profile identifies the CICS® environment for deployment. An example of how to create an environment using using z/OS® Provisioning Toolkit as described in [Provisioning a CICS® region using z/OS PT](cdp-Provisioning-a-CICS-region-using-zospt). You need to know the following from your CICS® system administrator:
93
+
The cics-deploy profile identifies the CICS® environment for deployment. An example of how to create an environment using using z/OS® Provisioning Toolkit as described in [Provisioning a CICS® region using z/OS® PT](cdp-Provisioning-a-CICS-region-using-zospt). You need to know the following from your CICS® system administrator:
Copy file name to clipboardExpand all lines: docs/pages/cdp/cdp-Deploying-a-nodejs-application.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ toc: true
11
11
12
12
### Before you begin
13
13
14
-
CICS® TS V5.5 introduced support to run Node.js applications and is required by this tutorial. If you do not have a CICS® TS V5.5 region, use the steps in [Provisioning a CICS® region using z/OS PT](cdp-Provisioning-a-CICS-region-using-zospt) to provision one, or speak to your CICS® system administrator.
14
+
CICS® TS V5.5 introduced support to run Node.js applications and is required by this tutorial. If you do not have a CICS® TS V5.5 region, use the steps in [Provisioning a CICS® region using z/OS® PT](cdp-Provisioning-a-CICS-region-using-zospt) to provision one, or speak to your CICS® system administrator.
Copy file name to clipboardExpand all lines: docs/pages/cdp/cdp-Preparing-a-zOS-PT-image.md
+15-15Lines changed: 15 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,28 +1,28 @@
1
1
---
2
-
title: Preparing a z/OS Provisioning Toolkit image
2
+
title: Preparing a z/OS® Provisioning Toolkit image
3
3
tags: [tutorial]
4
4
keywords:
5
-
summary: "The following steps take you through preparing a z/OS Provisioning Toolkit image for CICS, and optionally include an application in the image."
5
+
summary: "The following steps take you through preparing a z/OS® Provisioning Toolkit image for CICS, and optionally include an application in the image."
6
6
sidebar: cdp_sidebar
7
7
permalink: cdp-Preparing-a-zOS-PT-image.html
8
8
folder: cdp
9
9
toc: true
10
10
---
11
11
12
-
The [z/OS Provisioning Toolkit](https://developer.ibm.com/mainframe/products/zospt/) (z/OS PT) provides a command line utility and z/OSMF workflows to provision CICS® regions and other development environments on z/OS. This tutorial requires z/OS PT version 1.1.5 or above to be installed on z/OS, and your user `.profile` file on z/OS® configured to run z/OS PT.
12
+
The [z/OS Provisioning Toolkit](https://developer.ibm.com/mainframe/products/zospt/) (z/OS PT) provides a command line utility and z/OSMF workflows to provision CICS® regions and other development environments on z/OS. This tutorial requires z/OS® PT version 1.1.5 or above to be installed on z/OS, and your user `.profile` file on z/OS® configured to run z/OS® PT.
13
13
14
-
z/OS PT uses configuration and files in an *image* as input to z/OSMF workflows to provision a CICS® region. The image is typically prepared by a CICS® system administrator. This tutorial provides two alternative approaches to preparing a z/OS PT image:
14
+
z/OS PT uses configuration and files in an *image* as input to z/OSMF workflows to provision a CICS® region. The image is typically prepared by a CICS® system administrator. This tutorial provides two alternative approaches to preparing a z/OS® PT image:
15
15
16
-
-[Prepare a z/OS PT image for CICS®](#prepare-a-zos-pt-image-for-cics%C2%AE)
16
+
-[Prepare a z/OS® PT image for CICS®](#prepare-a-zos%C2%AE-pt-image-for-cics%C2%AE)
17
17
-[Procedure](#procedure)
18
18
-[Results](#results)
19
-
-[Prepare a z/OS PT image for CICS® including an application](#prepare-a-zos-pt-image-for-cics%C2%AE-including-an-application)
19
+
-[Prepare a z/OS® PT image for CICS® including an application](#prepare-a-zos%C2%AE-pt-image-for-cics%C2%AE-including-an-application)
20
20
-[Procedure](#procedure-1)
21
21
-[Results](#results-1)
22
22
23
-
### Prepare a z/OS PT image for CICS®
23
+
### Prepare a z/OS® PT image for CICS®
24
24
25
-
Use these steps to prepare a z/OS PT image for a CICS® region. No application is included in the image. The CICS® region is connected to a CICSplex environment, and has NODE_HOME set.
25
+
Use these steps to prepare a z/OS® PT image for a CICS® region. No application is included in the image. The CICS® region is connected to a CICSplex environment, and has NODE_HOME set.
26
26
27
27
#### Procedure
28
28
@@ -42,7 +42,7 @@ Run the following commands on your workstation.
42
42
export IMAGE_DIR_ZOS="/zosptimages/$IMAGE"
43
43
```
44
44
45
-
4. Create directories for the z/OS PT image source and bundles sub-directory.
45
+
4. Create directories for the z/OS® PT image source and bundles sub-directory.
46
46
47
47
```text
48
48
mkdir -p "$IMAGE_DIR/bundles"
@@ -60,7 +60,7 @@ Run the following commands on your workstation.
60
60
EOF
61
61
```
62
62
63
-
Update the values for `DFH_CICSPLEX` and `DFH_NODE_HOME` to be suitable for your z/OS environment. Further customization can be made by adding properties as described in [Configuration properties for CICS images](https://www.ibm.com/support/knowledgecenter/en/SSXH44E_1.0.0/zospt/cics/zospt-cics-properties.html).
63
+
Update the values for `DFH_CICSPLEX` and `DFH_NODE_HOME` to be suitable for your z/OS® environment. Further customization can be made by adding properties as described in [Configuration properties for CICS images](https://www.ibm.com/support/knowledgecenter/en/SSXH44E_1.0.0/zospt/cics/zospt-cics-properties.html).
@@ -99,9 +99,9 @@ Run the following commands on your workstation.
99
99
100
100
The image is now ready for developers to provision CICS® regions and deploy their Node.js applications using [Deploying a Node.js application](cdp-Deploying-a-Nodejs-application). The image source can be stored with other images and shared using a source code management system.
101
101
102
-
### Prepare a z/OS PT image for CICS® including an application
102
+
### Prepare a z/OS® PT image for CICS® including an application
103
103
104
-
Use these steps to prepare a z/OS PT image for a CICS® region that includes a Node.js application, such that the region and application are provisioned / started / stopped / de-provisioned together. The CICS® region is connected to a CICSplex environment, and has NODE_HOME set.
104
+
Use these steps to prepare a z/OS® PT image for a CICS® region that includes a Node.js application, such that the region and application are provisioned / started / stopped / de-provisioned together. The CICS® region is connected to a CICSplex environment, and has NODE_HOME set.
105
105
106
106
#### Procedure
107
107
@@ -138,9 +138,9 @@ Run the following commands on your workstation.
138
138
139
139
The `COPY` directive will copy all the files from the applications root directory a sub-directory of the z/FS file system provisioned with the CICS® region. Update the value of the sub-directory to suit the application.
140
140
141
-
Update the values for `DFH_CICSPLEX` and `DFH_NODE_HOME` to be suitable for your z/OS environment, and add additional properties as required. Further customization can be made by adding properties as described in [Configuration properties for CICS® images](https://www.ibm.com/support/knowledgecenter/en/SSXH44E_1.0.0/zospt/cics/zospt-cics-properties.html).
141
+
Update the values for `DFH_CICSPLEX` and `DFH_NODE_HOME` to be suitable for your z/OS® environment, and add additional properties as required. Further customization can be made by adding properties as described in [Configuration properties for CICS® images](https://www.ibm.com/support/knowledgecenter/en/SSXH44E_1.0.0/zospt/cics/zospt-cics-properties.html).
142
142
143
-
6. Upload the z/OS PT image source and application to z/OS.
143
+
6. Upload the z/OS® PT image source and application to z/OS.
Copy file name to clipboardExpand all lines: docs/pages/cdp/cdp-Provisioning-a-CICS-region.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,26 +2,26 @@
2
2
title: Provisioning a CICS® region
3
3
tags: [tutorial]
4
4
keywords:
5
-
summary: "The following steps take you through provisioning a CICS® region from a z/OS Provisioning Toolkit image. You can then deploy and test applications using the CICS® region."
5
+
summary: "The following steps take you through provisioning a CICS® region from a z/OS® Provisioning Toolkit image. You can then deploy and test applications using the CICS® region."
6
6
sidebar: cdp_sidebar
7
7
permalink: cdp-Provisioning-a-CICS-region.html
8
8
folder: cdp
9
9
toc: true
10
10
---
11
11
12
-
The [z/OS Provisioning Toolkit](https://developer.ibm.com/mainframe/products/zospt/) (z/OS PT) provides a command line utility and z/OSMF workflows to provision CICS® regions and other development environments on z/OS. This tutorial requires z/OS PT version 1.1.5 or above to be installed on z/OS.
12
+
The [z/OS Provisioning Toolkit](https://developer.ibm.com/mainframe/products/zospt/) (z/OS® PT) provides a command line utility and z/OSMF workflows to provision CICS® regions and other development environments on z/OS. This tutorial requires z/OS® PT version 1.1.5 or above to be installed on z/OS.
13
13
14
-
### Provision your CICS® region using a z/OS PT image
14
+
### Provision your CICS® region using a z/OS® PT image
15
15
16
-
Before you can provision a CICS® region, a z/OS PT image needs to be created and built as outlined in [Preparing a z/OS PT image](cdp-Preparing-a-zOS-PT-image). This is typically prepared by a CICS® system administrator.
16
+
Before you can provision a CICS® region, a z/OS® PT image needs to be created and built as outlined in [Preparing a z/OS® PT image](cdp-Preparing-a-zOS-PT-image). This is typically prepared by a CICS® system administrator.
17
17
18
18
#### Procedure
19
19
20
20
1. Install the Zowe CLI and plug-ins by following the steps in [Installing](cdp-Installing).
21
21
22
22
2. Create Zowe CLI profiles by following the steps in [Creating Zowe CLI profiles](cdp-Creating-Zowe-CLI-profiles).
23
23
24
-
3. On z/OS, update your user `.profile` file to run z/OS PT.
24
+
3. On z/OS, update your user `.profile` file to run z/OS® PT.
25
25
26
26
Add the directory to the `zospt` command to your PATH.
27
27
@@ -35,20 +35,20 @@ Before you can provision a CICS® region, a z/OS PT image needs to be created an
35
35
export zospt_pw=
36
36
```
37
37
38
-
Optional: If z/OSMF is configured with domain and tenant names that are not the default 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 following environment variables:
38
+
Optional: If z/OSMF is configured with domain and tenant names that are not the default 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 following environment variables:
39
39
40
40
```properties
41
41
export zospt_domain=
42
42
export zospt_tenant=
43
43
```
44
44
45
-
4. On your workstation, test you can run z/OS PT.
45
+
4. On your workstation, test you can run z/OS® PT.
46
46
47
47
```console
48
48
zowe zos-uss issue ssh "zospt --help"
49
49
```
50
50
51
-
5. List the z/OS PT images available for you to use.
51
+
5. List the z/OS® PT images available for you to use.
Copy file name to clipboardExpand all lines: docs/pages/cdp/cdp-Tutorials-overview.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,12 +11,12 @@ toc: true
11
11
12
12
Firstly, you will need a CICS® region:
13
13
14
-
* The z/OS Provisioning Toolkit enables you to provision CICS regions yourself:
14
+
* The z/OS® Provisioning Toolkit enables you to provision CICS regions yourself:
15
15
16
-
*[Preparing a z/OS Provisioning Toolkit image](cdp-Preparing-a-zOS-PT-image) - prepare a z/OS Provisioning Toolkit image for CICS®, and optionally include an application in the image.
16
+
*[Preparing a z/OS® Provisioning Toolkit image](cdp-Preparing-a-zOS-PT-image) - prepare a z/OS® Provisioning Toolkit image for CICS®, and optionally include an application in the image.
17
17
18
-
*[Provisioning a CICS® region](cdp-Provisioning-a-CICS-region) - provision a CICS® region from a z/OS Provisioning Toolkit image.
19
-
*[Provisioning a CICS® region](cdp-Provisioning-a-CICS-region) - provision a CICS® region from a z/OS Provisioning Toolkit image.
18
+
*[Provisioning a CICS® region](cdp-Provisioning-a-CICS-region) - provision a CICS® region from a z/OS® Provisioning Toolkit image.
19
+
*[Provisioning a CICS® region](cdp-Provisioning-a-CICS-region) - provision a CICS® region from a z/OS® Provisioning Toolkit image.
20
20
21
21
* Alternatively, work with your CICS® and z/OS® system administrators [Creating Zowe CLI profiles](cdp-Creating-Zowe-CLI-profiles) based on the z/OS® system and CICS® region you can use.
0 commit comments