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: docs/pages/cdp/cdp-Creating-Zowe-CLI-profiles.md
+40-21Lines changed: 40 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,6 +6,7 @@ summary: "Zowe profiles let you store configuration details so you don't have to
6
6
sidebar: cdp_sidebar
7
7
permalink: cdp-Creating-Zowe-CLI-profiles.html
8
8
folder: cdp
9
+
toc: false
9
10
---
10
11
11
12
The Zowe CLI lets you define arguments and options for commands in multiple ways, with the following order of precedence:
@@ -14,9 +15,18 @@ The Zowe CLI lets you define arguments and options for commands in multiple ways
14
15
2. Environment variables
15
16
3. Profiles
16
17
17
-
This provides flexibility when you issue commands and write automation scripts. Further detail is in [Understanding command option order of precedence](https://zowe.github.io/docs-site/latest/user-guide/cli-configuringcli.html#understanding-command-option-order-of-precedence). Therefore by creating and setting options in the following profiles, they will become your defaults and do not need to repeat them on Zowe CLI command unless you wish to override them.
18
+
Therefore by creating and setting options in the following profiles, they will become your defaults and do not need to repeat them on Zowe CLI command unless you wish to override them. This provides flexibility when you issue commands and write automation scripts. Further detail is in [Understanding command option order of precedence](https://zowe.github.io/docs-site/latest/user-guide/cli-configuringcli.html#understanding-command-option-order-of-precedence).
18
19
19
-
### Create a z/OSMF profile
20
+
The CICS deploy plug-in makes use of the following profiles:
21
+
22
+
| Profile | Used by command | Connects to z/OS server |
The z/OSMF profile defines the options needed to connect to the z/OSMF server on z/OS. You need to know the following from your z/OS system administrator:
22
32
@@ -31,23 +41,23 @@ The z/OSMF profile defines the options needed to connect to the z/OSMF server on
To test the connection to the z/OSMF server using the profile:
45
55
46
-
```console
56
+
```text
47
57
zowe zosmf check status
48
58
```
49
59
50
-
### Create an SSH profile
60
+
### SSH profile
51
61
52
62
The SSH profile defines the options needed to connect to the SSH server on z/OS. You need to know the following from your z/OS system administrator:
53
63
@@ -58,27 +68,27 @@ The SSH profile defines the options needed to connect to the SSH server on z/OS.
58
68
| user | User ID to identify yourself to the SSH server. |
59
69
| password | Password to identify yourself to the SSH server. |
60
70
61
-
{% include note.html content="It is recommended that you use the same user ID and host name to connect with SSH as is used in the z/OSMF profile, failure to do so results in undefined behaviour. When an SSH connection is made, the user's remote [z/OS shell .profile](https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.3.0/com.ibm.zos.v2r3.bpxa400/cupro.htm) is used to set-up the shell environment and variables. This remote .profile should include any necessary environment variables and npm configuration required to run `npm install`. This is descibed in [Installing and configuring](https://www.ibm.com/support/knowledgecenter/SSTRRS_6.0.0/com.ibm.nodejs.zos.v6.doc/install.htm)." %}
71
+
{% include note.html content="It is recommended that you use the same user ID and host name to connect with SSH as is used in the z/OSMF profile, failure to do so results in undefined behaviour. When an SSH connection is made, the user's remote [z/OS shell .profile](https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.3.0/com.ibm.zos.v2r3.bpxa400/cupro.htm) is used to set-up the shell environment and variables. This remote .profile should include any necessary environment variables and npm configuration required to run `npm install`. This is described in [Installing and configuring](https://www.ibm.com/support/knowledgecenter/SSTRRS_6.0.0/com.ibm.nodejs.zos.v6.doc/install.htm)." %}
To test the connection to the SSH server using the profile:
76
86
77
-
```console
87
+
```text
78
88
zowe zos-uss issue ssh 'uname -a'
79
89
```
80
90
81
-
### Create a cics-deploy profile
91
+
### CICS deploy profile
82
92
83
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:
84
94
@@ -94,25 +104,26 @@ The cics-deploy profile identifies the CICS environment for deployment. An examp
To test the cics-deploy profile, follow the steps in [Deploying your first Node.js app](cdp-Deploying-your-first-nodejs-app).
117
+
To test the cics-deploy profile, follow the steps in [Deploying a Node.js application](cdp-Deploying-a-nodejs-application).
108
118
109
-
### Create a CICS profile
119
+
### CICS profile
110
120
111
121
The CICS profile identifies the connection to the CICS Web User Interface (WUI) server to query application resources. You need to know the following from your CICS system administrator:
112
122
113
123
| Option | Description |
114
124
| --- | --- |
115
125
| cics-plex | CPSM CICSplex name. This will typically be set to the same as cicsplex in the cics-deploy profile. |
126
+
| region-name | The name of the CICS region name to interact with. |
116
127
| protocol | HTTP or HTTPS to use to connect to the CICS WUI server. |
117
128
| host | Host name of the CICS WUI server. |
118
129
| port | Port number of the CICS WUI server. |
@@ -121,18 +132,26 @@ The CICS profile identifies the connection to the CICS Web User Interface (WUI)
Copy file name to clipboardExpand all lines: docs/pages/cdp/cdp-Deploying-using-individual-actions.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
@@ -9,7 +9,7 @@ folder: cdp
9
9
toc: true
10
10
---
11
11
12
-
The `zowe cics-deploy push bundle` command performs a set of actions to deploy applications to CICS, as can be seen in [Deploying your first Node.js app](cdp-Deploying-your-first-nodejs-app). The main actions include:
12
+
The `zowe cics-deploy push bundle` command performs a set of actions to deploy applications to CICS, as can be seen in [Deploying a Node.js application](cdp-Deploying-a-nodejs-application). The main actions include:
13
13
14
14
* undeploy the old version of the CICS bundle in CICS
15
15
* upload the new version of the CICS bundle to z/OS
Copy file name to clipboardExpand all lines: docs/pages/cdp/cdp-Home.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
@@ -10,7 +10,7 @@ folder: cdp
10
10
11
11
The cics-deploy plug-in provides a CICS deployment workflow for developers and CI/CD automation pipelines similar to that experienced when deploying applications to cloud environments.
12
12
13
-
Before you start, and especially if you are not familiar with the world of z/OS, Zowe, and CICS, it's a good idea to read about some of the key concepts, which include [Zowe](cdp-zowe-and-cli), [Zowe CLI profiles](cdp-zowe-profiles) and [CICS bundles](cdp-cics-bundles). If you're keen to get going quickly, you can jump right in and follow along with our tutorial on [Deploying your first Node.js app](cdp-Deploying-your-first-nodejs-app).
13
+
Before you start, and especially if you are not familiar with the world of z/OS, Zowe, and CICS, it's a good idea to read about some of the key concepts, which include [Zowe](cdp-zowe-and-cli), [Zowe CLI profiles](cdp-zowe-profiles) and [CICS bundles](cdp-cics-bundles). If you're keen to get going quickly, you can jump right in and follow along with our tutorial on [Deploying a Node.js application](cdp-Deploying-a-nodejs-application).
14
14
15
15
When everything is [installed](cdp-Installing) and you have [created the Zowe CLI profiles](cdp-Creating-Zowe-CLI-profiles), you can deploy an application from your workstation to CICS in two steps:
Copy file name to clipboardExpand all lines: docs/pages/cdp/cdp-Preparing-a-zOS-PT-image.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
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 including 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
@@ -93,7 +93,7 @@ Run the following commands on your workstation.
93
93
94
94
#### Results
95
95
96
-
The image is now ready for developers to provision CICS regions and deploy their Node.js applications using [Deploying your first Node.js app](cdp-Deploying-your-first-nodejs-app). The image source can be stored with other images and shared using a source code management system.
96
+
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.
97
97
98
98
### Prepare a z/OS PT image for CICS including an application
99
99
@@ -107,7 +107,7 @@ Run the following commands on your workstation.
107
107
108
108
2. Create Zowe CLI profiles for at least z/OSMF and SSH following the steps in [Creating Zowe CLI profiles](cdp-Creating-Zowe-CLI-profiles).
109
109
110
-
3. Prepare your environment and Node.js application by following steps 1 to 4 in tutorial [Deploying your first Node.js app](cdp-Deploying-your-first-nodejs-app).
110
+
3. Prepare your environment and Node.js application by following steps 1 to 4 in tutorial [Deploying a Node.js application](cdp-Deploying-a-nodejs-application).
111
111
112
112
4. Setup environment variables for the name of your image, and paths for the image source on the workstation and z/OS.
0 commit comments