Skip to content

Commit cff33b0

Browse files
committed
Minor updates
1 parent 055dcdc commit cff33b0

File tree

1 file changed

+26
-10
lines changed

1 file changed

+26
-10
lines changed

docs/pages/cdp/cdp-Deploying-using-individual-actions.md

Lines changed: 26 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,18 @@ folder: cdp
99
toc: false
1010
---
1111

12-
The `zowe cics-deploy push bundle` command performs a set of actions to deploy applications to CICS. The actions include undeploying the old version of the CICS bundle, uploading the new version of the CICS bundle to z/OS, running `npm install` on z/OS to resolve dependencies, and finally deploying the new version of the CICS bundle.
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 app](cdp-cdp-Deploying-your-first-app). The main actions include:
13+
14+
* undeploying the old version of the CICS bundle
15+
* uploading the new version of the CICS bundle to z/OS
16+
* running `npm install` on z/OS to resolve dependencies
17+
* deploying the new version of the CICS bundle.
1318

1419
However, there may be situations where you need more control or perform alternate actions. The following sections describe how each of these actions could be performed independently, enabling you to form a sequence of commands to achieve your needs.
1520

1621
### Undeploy a CICS bundle
1722

18-
Undeploying a CICS bundle will first disable the BUNDLE resource in CICS. This will result in all CICS resources defined in the BUNDLE being disabled. To disable Node.js applications, CICS will send a SIGTERM signal to the application. The CICS bundle will then be discarded from CICS. This command will not remove the CICS bundle from the z/OS directory.
23+
Undeploying a CICS bundle will first disable the CICS bundle resource (BUNDLE) in CICS. This will result in all CICS resources defined in the BUNDLE being disabled. To disable Node.js applications, CICS will send a SIGTERM signal to the application. The CICS bundle will then be discarded from CICS. This command will not remove the CICS bundle from the z/OS directory.
1924

2025
```console
2126
zowe cics-deploy undeploy bundle --name Express
@@ -29,11 +34,22 @@ zowe cics-deploy undeploy bundle --name Express --target-state disabled
2934

3035
### Upload to z/OS
3136

32-
There are several ways to upload a CICS bundle to z/OS, such as FTP, Git, and Zowe. Typically you will need to upload some files as binary, some as text, and exclude others that are not required to run the application. It is best practice to tag files on z/OS as binary or with their text codepage to allow for correct viewing and loading by environments such as Node.js. You can specify these requirements in a .zosattributes file and use the Zowe CLI to upload and tag files in a single command.
37+
Before uploading the CICS bundle to z/OS, you will need to ensure the target directory is empty in order to prevent merging with a previously deployed version of the CICS bundle.
3338

34-
For example, create file **~/myExpressApp/.zosattributes** in the CICS bundle:
39+
There are several ways to run shell commands and scripts on z/OS, such as SSH, batch jobs, and Zowe. When using Zowe, an SSH connection will be established, the user will be logged in, the shell .profile will be run to setup the environment. Zowe will then run the specified command in the directory specified by the `--cwd` option.
3540

41+
For example, to remove the target directory:
42+
43+
```console
44+
zowe zos-uss issue ssh "rm -Rv *" --cwd "/var/cicsts/bundles/myexpressapp_1.0.0"
45+
echo $?
3646
```
47+
48+
Typically you will need to upload some files as binary, some as text, and exclude others that are not required to run the application. In addition it is best practice to tag files on z/OS as binary or with their text codepage to allow for correct viewing and loading by environments such as Node.js. You can specify these requirements in a .zosattributes file and use the Zowe CLI to upload and tag files in a single command.
49+
50+
For example, create file **~/myExpressApp/.zosattributes** in the CICS bundle:
51+
52+
```properties
3753
# Don't upload node_modules
3854
node_modules -
3955

@@ -57,26 +73,26 @@ node_modules -
5773
Then upload the CICS bundle to z/OS:
5874

5975
```console
60-
zowe zos-files upload dir-to-uss ~/myExpressApp/ /var/cicsts/bundles --recursive --attributes my_global_attributes
76+
zowe zos-files upload dir-to-uss ~/myExpressApp/ /var/cicsts/bundles/myexpressapp_1.0.0 --recursive --attributes ~/myExpressApp/.zosattributes
6177
```
6278

6379
### Run npm install on z/OS
6480

65-
There are several ways to run shell commands and scripts on z/OS, such as SSH, batch jobs, and Zowe. When using Zowe, an SSH connection will be established, the user will be logged in, the shell .profile will be run to setup the environment. Zowe will then run the specified command in the directory specified by the `--cdw` option.
81+
A Node.js application will typically depend on packages that are described in `package.json`. The dependencies can be installed by running `npm install`. For example:
6682

6783
```console
68-
zowe zos-uss issue ssh "npm install" --cdw "/var/cicsts/bundles"
84+
zowe zos-uss issue ssh "npm install" --cwd "/var/cicsts/bundles/myexpressapp_1.0.0"
6985
```
7086

7187
### Deploy a CICS bundle
7288

73-
Deploying a CICS bundle will define the BUNDLE resource in CICS, then install, then enable the BUNDLE.
89+
Deploying a CICS bundle will define a CICS bundle resource (BUNDLE), then install it, and finally enable it. When the CICS bundle is enabled, the Node.js application is started. For example:
7490

7591
```console
76-
zowe cics-deploy deploy bundle --name EXAMPLE --bundledir /var/cicsts/bundles/myExpressApp_1.0.0
92+
zowe cics-deploy deploy bundle --name Express --bundledir /var/cicsts/bundles/myexpressapp_1.0.0
7793
```
7894

79-
Alternatively, if you want to define and install the CICS bundle, but to not enable it:
95+
Alternatively, to define and install the BUNDLE but to not enable it:
8096

8197
```console
8298
zowe cics-deploy deploy bundle --name Express --target-state disabled

0 commit comments

Comments
 (0)