Skip to content

Commit 443ff17

Browse files
committed
Remove future tense
1 parent cff33b0 commit 443ff17

File tree

1 file changed

+19
-15
lines changed

1 file changed

+19
-15
lines changed

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

Lines changed: 19 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -9,18 +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 as can be seen in [Deploying your first app](cdp-cdp-Deploying-your-first-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 your first app](cdp-cdp-Deploying-your-first-app). The main actions include:
1313

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.
14+
* undeploy the old version of the CICS bundle in CICS
15+
* upload the new version of the CICS bundle to z/OS
16+
* run `npm install` on z/OS to resolve Node.js application dependencies
17+
* deploy the CICS bundle in CICS.
1818

19-
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.
19+
However, there may be situations where you need more control of these actions or perform alternate actions. The following sections describe how each of these actions can be performed independently, enabling you to form a sequence of commands to achieve your needs.
2020

2121
### Undeploy a CICS bundle
2222

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.
23+
Undeploying a CICS bundle disables the CICS bundle resource (BUNDLE) in CICS. Disabling the CICS bundle causes the resources defined in to also be disabled. For Node.js applications, CICS sends a SIGTERM signal that can be handled in the application to stop in a controlled manner, such as stopping new requests and completing existing requests. Once the CICS bundle has been disabled it is then discarded in CICS.
2424

2525
```console
2626
zowe cics-deploy undeploy bundle --name Express
@@ -32,11 +32,13 @@ Alternatively, if you want to disable the CICS bundle, but to not discard it:
3232
zowe cics-deploy undeploy bundle --name Express --target-state disabled
3333
```
3434

35-
### Upload to z/OS
35+
{% include note.html content="This command does not remove the CICS bundle from the z/OS directory." %}
3636

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.
37+
### Upload a CICS bundle to z/OS
3838

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.
39+
Before uploading the CICS bundle to z/OS, you need to ensure the target directory is empty in order to prevent merging with a previously deployed version of the CICS bundle.
40+
41+
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 using information in the Zowe ssh profile, and the shell .profile for the user will be run to setup the environment. The command is then run in the directory specified by the `--cwd` option.
4042

4143
For example, to remove the target directory:
4244

@@ -45,6 +47,8 @@ zowe zos-uss issue ssh "rm -Rv *" --cwd "/var/cicsts/bundles/myexpressapp_1.0.0"
4547
echo $?
4648
```
4749

50+
{% include tip.html content="You can run several commands in one request using the syntax described in [sh — Invoke a shell](https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.3.0/com.ibm.zos.v2r3.bpxa500/sh.htm)." %}
51+
4852
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.
4953

5054
For example, create file **~/myExpressApp/.zosattributes** in the CICS bundle:
@@ -76,24 +80,24 @@ Then upload the CICS bundle to z/OS:
7680
zowe zos-files upload dir-to-uss ~/myExpressApp/ /var/cicsts/bundles/myexpressapp_1.0.0 --recursive --attributes ~/myExpressApp/.zosattributes
7781
```
7882

79-
### Run npm install on z/OS
83+
### Run npm on z/OS
8084

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:
85+
A Node.js application typically depends on packages that are described in `package.json`. The dependencies can be installed by running `npm install` in the z/os directory containing `package.json`, for example:
8286

8387
```console
8488
zowe zos-uss issue ssh "npm install" --cwd "/var/cicsts/bundles/myexpressapp_1.0.0"
8589
```
8690

8791
### Deploy a CICS bundle
8892

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:
93+
Deploying a CICS bundle defines a CICS bundle resource (BUNDLE), then installs it, and finally enables it. When the CICS bundle is enabled, the Node.js application is started. For example:
9094

9195
```console
9296
zowe cics-deploy deploy bundle --name Express --bundledir /var/cicsts/bundles/myexpressapp_1.0.0
9397
```
9498

95-
Alternatively, to define and install the BUNDLE but to not enable it:
99+
Alternatively, to define and install the BUNDLE but not enable it:
96100

97101
```console
98-
zowe cics-deploy deploy bundle --name Express --target-state disabled
102+
zowe cics-deploy deploy bundle --name Express --bundledir /var/cicsts/bundles/myexpressapp_1.0.0 --target-state disabled
99103
```

0 commit comments

Comments
 (0)