zowe · ATorrise · Jan 31, 2025 · Feb 11, 2025 · Feb 11, 2025 · Feb 11, 2025
diff --git a/.gitignore b/.gitignore
@@ -14,6 +14,7 @@ package-lock.json
 /packages/cli/npm-shrinkwrap.json
 /zowe-cli
 /dist/
+.prettierrc
 # Sonar Files
 .sonar_lock
 .scannerwork/

diff --git a/jest.config.js b/jest.config.js
@@ -9,7 +9,9 @@ const sharedConfig = {
         ".*/lib/.*"
     ],
     "setupFilesAfterEnv": [
-        "<rootDir>/__tests__/beforeTests.js"
+        "<rootDir>/__tests__/beforeTests.js",
+        "<rootDir>/jest.setup.ts",
+        "jest-extended/all"
     ],
     "transformIgnorePatterns": [ "^.+\\.js$", "^.+\\.json$" ],
     "snapshotFormat": {

diff --git a/jest.setup.ts b/jest.setup.ts
@@ -0,0 +1 @@
+import 'jest-extended';
diff --git a/npm-shrinkwrap.json b/npm-shrinkwrap.json
diff --git a/package.json b/package.json
@@ -64,6 +64,7 @@
     "jest": "^29.0.0",
     "jest-environment-node": "^29.0.0",
     "jest-environment-node-debug": "^2.0.0",
+    "jest-extended": "^4.0.2",
     "jest-html-reporter": "^3.6.0",
     "jest-junit": "^16.0.0",
     "jest-sonar-reporter": "^2.0.0",

diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
@@ -1,6 +1,11 @@
 # Change Log
+
 All notable changes to the Zowe CLI package will be documented in this file.
 
+## Recent Changes
+
+- Enhancement: Created a centralized header class with `packages/zosfiles/src/utils/ZosFilesHeaders.ts` to be used across all methods in the ZosFiles SDK. [#2436](https://github.com/zowe/zowe-cli/pull/2436)
+
 ## `8.15.0`
 
 - Enhancement: Added the `overwrite` parameter to the `Copy.DataSet()` command to allow for overwriting all members of a target data set with source data set members. [#2450] (https://github.com/zowe/zowe-cli/pull/2450)
@@ -25,16 +30,19 @@ All notable changes to the Zowe CLI package will be documented in this file.
 - Enhancement: The `zowe zos-files copy data-set` command no longer requires the target data set to be preallocated. [##2349] (https://github.com/zowe/zowe-cli/issues/2349)
 
 ## `8.10.4`
+
 - BugFix: Fixed an issue where the `zowe files upload dir-to-uss` command was missing progress bar to track progress of file uploads. [#2344](https://github.com/zowe/zowe-cli/issues/2344)
 
 ## `8.10.3`
 
 - BugFix: The `zowe files copy data-set` command no longer copies all partitioned data set members if a member is specified. [#2402](https://github.com/zowe/zowe-cli/pull/2402)
 
 ## `8.10.0`
+
 -Enhancement: The `zowe zos-files copy data-set` command now copies members from a source partitioned data set to an existing target partitioned data set.[#2386](https://github.com/zowe/zowe-cli/pull/2386)
 
 ## `8.9.0`
+
 - Enhancement: Added new command zowe zos-files download all-members-matching, (zowe files dl amm), to download members matching specified pattern(s). The success message for the Download.allMembers API was changed from originally "Data set downloaded successfully" to "Member(s) downloaded successfully." The change also alters the commandResponse when using the --rfj flag. [#2359](https://github.com/zowe/zowe-cli/pull/2359)
 
 ## `8.8.0`
@@ -60,12 +68,10 @@ All notable changes to the Zowe CLI package will be documented in this file.
 
 - Enhancement: Added support for running applications on TSO/E address spaces. Start applications and receive/transmit messages using the new `tso start`, `tso receive` and `tso send` commands. [#2280](https://github.com/zowe/zowe-cli/pull/2280)
 
-
 ## `8.4.0`
 
 - Enhancement: Added optional `--attributes` flag to `zowe zos-files upload file-to-uss` to allow passing a .zosattributes file path for upload encoding format. [#2319](https://github.com/zowe/zowe-cli/pull/2319)
 
-
 ## `8.3.0`
 
 - Enhancement: Issue the `zowe files search data-sets` command with the new `encoding` option to use a different code page when searching data set contents. [#2161](https://github.com/zowe/zowe-cli/issues/2161)
@@ -76,7 +82,7 @@ All notable changes to the Zowe CLI package will be documented in this file.
 
 ## `8.1.0`
 
-- Enhancement: Added `--stateful` flag to `zos-tso issue cmd` to allow declaring the statefulness of the address space being created.  [#2240](https://github.com/zowe/zowe-cli/pull/2240)
+- Enhancement: Added `--stateful` flag to `zos-tso issue cmd` to allow declaring the statefulness of the address space being created. [#2240](https://github.com/zowe/zowe-cli/pull/2240)
 - Enhancement: `--suppress-startup-messages` flag default value changed to `true`. [#2240](https://github.com/zowe/zowe-cli/pull/2240)
 
 ## `8.0.0`
@@ -186,21 +192,22 @@ All notable changes to the Zowe CLI package will be documented in this file.
 ## `8.0.0-next.202402021649`
 
 LTS Breaking: Removed the following previously deprecated items: [#1981](https://github.com/zowe/zowe-cli/pull/1981)
-  - Moved the many constants from `zowe-cli/packages/cli/src/Constants.ts` to `zowe-cli/packages/core/src/constants/Core.constants.ts`
-  - Removing `ZosFilesCreateExtraOptions.showAttributes` without replacement
-  - Moved all constants from `zowe-cli/packages/cli/src/zostso/constants/ZosTso.constants.ts` to  `@zowe/zos-tso-for-zowe-sdk`
-  - Removed `isStderrEmptyForProfilesCommand` use `stripProfileDeprecationMessages` from `zowe-cli/__tests__/__packages__/cli-test-utils/src/TestUtils.ts` instead
-  - Removed  `allDataSetsArchived`, `datasetsDownloadedSuccessfully`, `noDataSetsMatchingPatternRemain` and `onlyEmptyPartitionedDataSets` from    ZosFiles.messages.ts
-  - Removed `getSpoolDownloadFile` use `getSpoolDownloadFilePath` instead
-  - Removed constants from ZosmfSession
-    - ZOSMF_OPTION_HOST_PROFILE use ZOSMF_OPTION_HOST instead
-    - ZOSMF_OPTION_USER_PROFILE use ZOSMF_OPTION_USER instead
-    - ZOSMF_OPTION_PASSWORD_PROFILE use ZOSMF_OPTION_PASSWORD instead
-  - Removed constants from SshSession.ts
-    - SSH_OPTION_USER_PROFILE use SSH_OPTION_USER
-    - SSH_OPTION_HOST_PROFILE use SSH_OPTION_HOST
-  - Removed zosmfProfile from `ZosFilesBase.handler.ts`
-  - Removed statCmdFlag as an export from Shell.ts
+
+- Moved the many constants from `zowe-cli/packages/cli/src/Constants.ts` to `zowe-cli/packages/core/src/constants/Core.constants.ts`
+- Removing `ZosFilesCreateExtraOptions.showAttributes` without replacement
+- Moved all constants from `zowe-cli/packages/cli/src/zostso/constants/ZosTso.constants.ts` to `@zowe/zos-tso-for-zowe-sdk`
+- Removed `isStderrEmptyForProfilesCommand` use `stripProfileDeprecationMessages` from `zowe-cli/__tests__/__packages__/cli-test-utils/src/TestUtils.ts` instead
+- Removed `allDataSetsArchived`, `datasetsDownloadedSuccessfully`, `noDataSetsMatchingPatternRemain` and `onlyEmptyPartitionedDataSets` from ZosFiles.messages.ts
+- Removed `getSpoolDownloadFile` use `getSpoolDownloadFilePath` instead
+- Removed constants from ZosmfSession
+  - ZOSMF_OPTION_HOST_PROFILE use ZOSMF_OPTION_HOST instead
+  - ZOSMF_OPTION_USER_PROFILE use ZOSMF_OPTION_USER instead
+  - ZOSMF_OPTION_PASSWORD_PROFILE use ZOSMF_OPTION_PASSWORD instead
+- Removed constants from SshSession.ts
+  - SSH_OPTION_USER_PROFILE use SSH_OPTION_USER
+  - SSH_OPTION_HOST_PROFILE use SSH_OPTION_HOST
+- Removed zosmfProfile from `ZosFilesBase.handler.ts`
+- Removed statCmdFlag as an export from Shell.ts
 
 ## `8.0.0-next.202401262128`
 
@@ -230,7 +237,7 @@ LTS Breaking: Removed the following previously deprecated items: [#1981](https:/
 ## `8.0.0-next.202311141517`
 
 - LTS Breaking: Alter the format of error messages to be more clear and actionable.
-- LTS Breaking: Remove the ```bright``` command from the product.
+- LTS Breaking: Remove the `bright` command from the product.
 
 ## `8.0.0-next.202311132045`
 
@@ -365,7 +372,6 @@ LTS Breaking: Removed the following previously deprecated items: [#1981](https:/
 
 - BugFix: Fixed `secondary` option being specified as `1` on `BLANK` type datasets with the `zowe files create data-set` command [#1595](https://github.com/zowe/zowe-cli/issues/1595)
 
-
 ## `7.16.3`
 
 - BugFix: Updated `imperative` to fix undesired behavior in the `zowe config list` command in certain situations.
@@ -386,7 +392,7 @@ LTS Breaking: Removed the following previously deprecated items: [#1981](https:/
 
 ## `7.15.0`
 
-- Enhancement: Added the `zowe files copy dsclp` command to copy a dataset from one LPAR to another.  [#1098](https://github.com/zowe/zowe-cli/issues/1098)
+- Enhancement: Added the `zowe files copy dsclp` command to copy a dataset from one LPAR to another. [#1098](https://github.com/zowe/zowe-cli/issues/1098)
 
 ## `7.14.1`:
 
@@ -421,16 +427,20 @@ LTS Breaking: Removed the following previously deprecated items: [#1981](https:/
 - BugFix: Solved daemon issue where Windows usernames were treated as case-sensitive when checking the daemon process owner during Zowe commands.
 
 ## `7.11.0`
+
 - Enhancement: Added support for a CLI specific environment variable file. [#1484](https://github.com/zowe/zowe-cli/issues/1484)
 - BugFix: Enabled option to download output from a submitted job with the -d flag. The -e flag now enables changes to file extension as originally intended. [#729](https://github.com/zowe/zowe-cli/issues/729)
 
 ## `7.10.4`
+
 - BugFix: Changed default value for modify-jobs option in the zowe jobs command group to 2.0. This change results in calls to z/OSMF becoming synchronous, and a successful response from the modify, cancel, and delete commands indicates the requested action was completed successfully. [#1459](https://github.com/zowe/zowe-cli/issues/1459)
 
 ## `7.10.3`
+
 - BugFix: Fix in employing `--context-lines` option for all diff/compare commands. Fixed broken `--seqnum` option implementation.[#1529](https://github.com/zowe/zowe-cli/issues/1529)
 
 ## `7.10.2`
+
 - BugFix: Updated Imperative to include bugfixes in version `5.8.2`.
 
 ## `7.10.0`
@@ -547,7 +557,7 @@ LTS Breaking: Removed the following previously deprecated items: [#1981](https:/
 
 - BugFix: Fixed name of the positional in `zowe zos-jobs submit uss-file` command.
 - BugFix: Updated the description of the `zowe zos-jobs view all-spool-content` command.
-- BugFix: Updated the descriptions of the `zowe zos-files view uss-file` and  `zowe zos-files view data-set` commands.
+- BugFix: Updated the descriptions of the `zowe zos-files view uss-file` and `zowe zos-files view data-set` commands.
 - BugFix: Removed the `zowe zos-files view uss-file <file> --record` option.
 - BugFix: Fixed description of the `zowe zos-jobs delete` command group.
 - BugFix: Added `--modify-version` option to `zowe zos-jobs delete old-jobs` command for feature parity with `zowe zos-jobs delete job`.
@@ -698,7 +708,7 @@ LTS Breaking: Removed the following previously deprecated items: [#1981](https:/
 
 ## `7.0.0-next.202112281543`
 
-- Enhancement: update a "show attributes" flag to be `-a` instead of `--pa`.  `--pa` is a "hidden" alias.
+- Enhancement: update a "show attributes" flag to be `-a` instead of `--pa`. `--pa` is a "hidden" alias.
 
 ## `7.0.0-next.202112201801`
 
@@ -724,14 +734,14 @@ LTS Breaking: Removed the following previously deprecated items: [#1981](https:/
 ## `7.0.0-next.202111111904`
 
 - Daemon mode updates:
-    - Enhancements:
-        - Renamed the platform-specific executable from zowex to zowe, so that existing zowe commands used from the command line or in scripts do not have to change when running in daemon mode.
-        - Automatically launch the background daemon when one is not running.
-        - The daemon no longer has its own visible window, making it much more daemon-like.
-        - An environment variable named ZOWE_USE_DAEMON can be set to "no" to prevent the use of the daemon. Commands are then passed to the traditional zowe-CLI command. Thus, you can temporarily use the traditional Zowe CLI command to correct some display limitations (like displaying colors).
-    - Bug fixes:
-        - Eliminate the display of escape characters when colors are displayed while running in daemon mode. [#938](https://github.com/zowe/zowe-cli/issues/938). Currently accomplished by not displaying colors in daemon mode.
-        - Command-line arguments that contain spaces no longer require extra quotes or escapes. [#978](https://github.com/zowe/zowe-cli/issues/978)
+  - Enhancements:
+    - Renamed the platform-specific executable from zowex to zowe, so that existing zowe commands used from the command line or in scripts do not have to change when running in daemon mode.
+    - Automatically launch the background daemon when one is not running.
+    - The daemon no longer has its own visible window, making it much more daemon-like.
+    - An environment variable named ZOWE_USE_DAEMON can be set to "no" to prevent the use of the daemon. Commands are then passed to the traditional zowe-CLI command. Thus, you can temporarily use the traditional Zowe CLI command to correct some display limitations (like displaying colors).
+  - Bug fixes:
+    - Eliminate the display of escape characters when colors are displayed while running in daemon mode. [#938](https://github.com/zowe/zowe-cli/issues/938). Currently accomplished by not displaying colors in daemon mode.
+    - Command-line arguments that contain spaces no longer require extra quotes or escapes. [#978](https://github.com/zowe/zowe-cli/issues/978)
 
 ## `7.0.0-next.202111111709`
 
@@ -799,7 +809,6 @@ LTS Breaking: Removed the following previously deprecated items: [#1981](https:/
 
 - BugFix: Updated Imperative to consume security updates in `4.18.2`.
 
-
 ## `6.39.0`
 
 - BugFix: Provided more accurate output for `zowe zos-jobs delete job` and `zowe zos-jobs cancel job` commands [#1333](https://github.com/zowe/zowe-cli/issues/1333)
@@ -902,15 +911,15 @@ LTS Breaking: Removed the following previously deprecated items: [#1981](https:/
 
 ## `6.31.2`
 
-- Enhancement: Added new aliases for zos-files commands in delete, download, and list relating to USS files. You can now interact with `uf` or `uss`.  [#983](https://github.com/zowe/zowe-cli/issues/983)
+- Enhancement: Added new aliases for zos-files commands in delete, download, and list relating to USS files. You can now interact with `uf` or `uss`. [#983](https://github.com/zowe/zowe-cli/issues/983)
 
 ## `6.31.0`
 
 - Enhancement: Add the option --jcl-symbols to the jobs submit command to enable users to specify JCL symbol names and values.
 
 ## `6.30.0`
 
-- Enhancement: made changes to definition files for zowe ssh commands  [#603](https://github.com/zowe/zowe-cli/issues/603)
+- Enhancement: made changes to definition files for zowe ssh commands [#603](https://github.com/zowe/zowe-cli/issues/603)
 
 ## `6.29.0`
 

diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
@@ -2,6 +2,10 @@
 
 All notable changes to the Zowe core SDK package will be documented in this file.
 
+## Recent Changes
+
+- Enhancement: Added the recursive header option, `X_IBM_RECURSIVE`, to `packages/core/src/rest/ZosmfHeaders.ts`. [#2436](https://github.com/zowe/zowe-cli/pull/2436)
+
 ## `8.1.1`
 
 - BugFix: Updated peer dependencies to `^8.0.0`, dropping support for versions tagged `next`. [#2287](https://github.com/zowe/zowe-cli/pull/2287)

diff --git a/packages/core/src/rest/ZosmfHeaders.ts b/packages/core/src/rest/ZosmfHeaders.ts
@@ -32,6 +32,13 @@ export class ZosmfHeaders {
     public static readonly X_IBM_INTRDR_LRECL = "X-IBM-Intrdr-Lrecl";
 
 
+    /**
+     * header indicating recursive = true
+     * @static
+     * @memberof ZosmfHeaders
+     */
+    public static readonly X_IBM_RECURSIVE: IHeaderContent = {"X-IBM-Option": "recursive"};
+
     /**
      * recfm header
      * @static
@@ -115,7 +122,7 @@ export class ZosmfHeaders {
      * @static
      * @memberof ZosmfHeaders
      */
-    public static readonly X_CSRF_ZOSMF_HEADER: object = { "X-CSRF-ZOSMF-HEADER": true }; // "the value does not matter"
+    public static readonly X_CSRF_ZOSMF_HEADER: IHeaderContent = { "X-CSRF-ZOSMF-HEADER": "true" }; //value doesn't matter
 
     /**
      * binary transfer header
@@ -153,7 +160,7 @@ export class ZosmfHeaders {
     public static readonly X_IBM_TEXT_ENCODING: string = ";fileEncoding=";
 
     /**
-     * octet stream header
+     * octet stream header, related to binary encoding
      * @static
      * @memberof ZosmfHeaders
      */

diff --git a/packages/imperative/__tests__/config/integration/jest.config.json b/packages/imperative/__tests__/config/integration/jest.config.json
@@ -26,6 +26,8 @@
     ],
     "testRegex": "__integration__.*(test|spec)\\.(ts|js)",
     "setupFilesAfterEnv": [
-        "<rootDir>/__tests__/beforeTests.js"
+        "<rootDir>/__tests__/beforeTests.js",
+        "<rootDir>/jest.setup.ts",
+        "jest-extended/all"
     ]
 }
diff --git a/packages/zosfiles/CHANGELOG.md b/packages/zosfiles/CHANGELOG.md
@@ -2,15 +2,20 @@
 
 All notable changes to the Zowe z/OS files SDK package will be documented in this file.
 
+## Recent Changes
+
+- Enhancement: Created a centralized header class with `packages/zosfiles/src/utils/ZosFilesHeaders.ts` to be used across all methods in the ZosFiles SDK. [#2436](https://github.com/zowe/zowe-cli/pull/2436)
+
 ## `8.15.0`
 
 - BugFix: Modified the `Copy.copyPDS()` function to have `sourceMemberList` as an optional parameter to avoid a breaking change. [#2453](https://github.com/zowe/zowe-cli/pull/2453)
 - Enhancement: Added the `overwrite` parameter to the `Copy.DataSet()` command to allow for overwriting all members of a target data set with source data set members. [#2450] (https://github.com/zowe/zowe-cli/pull/2450)
 
 ## `8.14.1`
 
--BugFix: When using the copy command with a non existent source data set, an unclear error was displayed to the user.  Now, a more user-friendly message is provided [#2447] (https://github.com/zowe/zowe-cli/issues/2447).
+-BugFix: When using the copy command with a non existent source data set, an unclear error was displayed to the user. Now, a more user-friendly message is provided [#2447] (https://github.com/zowe/zowe-cli/issues/2447).
 -BugFix: The updated logic to determine whether a data set is a partitioned data set now ensures that the `dsorg` attributes of types `PO-E`, `PO-L`, `PO-U` are handled correctly. [#2390] (https://github.com/zowe/zowe-cli/issues/2390).
+
 - BugFix: When using the `copy` command, if a target partitioned data set has a smaller record length than a source partitioned data set, the operation for subsequent members no longer stops. The user can now view the affected members in a local file. [#2349] (https://github.com/zowe/zowe-cli/issues/2349)
 - BugFix: Users were not warned when copying partitioned data sets with identical member names. Now, the user is prompted to confirm before continuing the copy operation to avoid potential data loss. [#2349] (https://github.com/zowe/zowe-cli/issues/2349)
 
@@ -21,6 +26,7 @@ All notable changes to the Zowe z/OS files SDK package will be documented in thi
 - BugFix: The `Copy.data.set` function now prompts the user to confirm before overwriting the contents of the target data set with the addition of the `--safe-replace` option. [#2369] (https://github.com/zowe/zowe-cli/issues/2369)
 
 ## `8.12.0`
+
 - Enhancement: The `Copy.dataset` function now creates a new data set if the entered target data set does not exist. [#2349](https://github.com/zowe/zowe-cli/issues/2349)
 - Enhancement: Added the `maxLength` option to List SDK functions (`allMembers`, `dataSetsMatchingPattern`, `membersMatchingPattern`) to specify the maximum number of items to return. [#2409](https://github.com/zowe/zowe-cli/pull/2409)
 - Enhancement: Added the `start` option to List SDK functions (`allMembers`, `dataSetsMatchingPattern`, `membersMatchingPattern`) to specify the first data set/member name to return in the response. [#2409](https://github.com/zowe/zowe-cli/pull/2409)