Contribute zowe files download dataset-matching command

packages/cli/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to the Zowe CLI package will be documented in this file.
 
+## Recent Changes
+
+- Enhancement: Added the `zowe files download data-sets-matching` command to download multiple data sets at once. [#1287](https://github.com/zowe/zowe-cli/issues/1287)
+  - Note: If you used this command previously in the extended files plug-in for Zowe v1, the `--fail-fast` option now defaults to true which is different from the original behavior.
+
 ## `7.2.3`
 
 - BugFix: Updated Imperative to address `ProfileInfo` related issues.

packages/cli/__tests__/zosfiles/__integration__/download/dsm/__scripts__/command/command_download_dsm.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+dsn=$1
+rfj=$2
+set -e
+
+echo "================Z/OS FILES DOWNLOAD DATASET MATCHING==============="
+zowe zos-files download dsm "$1" $2 $3
+if [ $? -gt 0 ]
+then
+    exit $?
+fi

packages/cli/__tests__/zosfiles/__integration__/download/dsm/__scripts__/command_download_dsm_help.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+set -e
+
+echo "================Z/OS FILES DOWNLOAD DATASET MATCHING HELP==============="
+zowe zos-files download dsm --help
+if [ $? -gt 0 ]
+then
+    exit $?
+fi
+
+echo "================Z/OS FILES DOWNLOAD DATASET MATCHING HELP WITH RFJ==========="
+zowe zos-files download dsm --help --rfj
+exit $?

packages/cli/__tests__/zosfiles/__integration__/download/dsm/cli.files.download.dsm.integration.test.ts

@@ -0,0 +1,67 @@
+/*
+* This program and the accompanying materials are made available under the terms of the
+* Eclipse Public License v2.0 which accompanies this distribution, and is available at
+* https://www.eclipse.org/legal/epl-v20.html
+*
+* SPDX-License-Identifier: EPL-2.0
+*
+* Copyright Contributors to the Zowe Project.
+*
+*/
+
+import * as path from "path";
+import { ITestEnvironment, runCliScript } from "@zowe/cli-test-utils";
+import { TestEnvironment } from "../../../../../../../__tests__/__src__/environment/TestEnvironment";
+import { ITestPropertiesSchema } from "../../../../../../../__tests__/__src__/properties/ITestPropertiesSchema";
+
+// Test Environment populated in the beforeAll();
+let TEST_ENVIRONMENT: ITestEnvironment<ITestPropertiesSchema>;
+
+describe("Download Dataset Matching", () => {
+
+    beforeAll(async () => {
+        TEST_ENVIRONMENT = await TestEnvironment.setUp({
+            testName: "download_data_set_matching",
+            skipProperties: true
+        });
+    });
+
+    afterAll(async () => {
+        await TestEnvironment.cleanUp(TEST_ENVIRONMENT);
+    });
+
+    it("should display the help", () => {
+        const shellScript = path.join(__dirname, "__scripts__", "command_download_dsm_help.sh");
+        const response = runCliScript(shellScript, TEST_ENVIRONMENT);
+
+        expect(response.stderr.toString()).toBe("");
+        expect(response.status).toBe(0);
+        expect(response.stdout.toString()).toMatchSnapshot();
+    });
+
+    it("should fail due to missing pattern", async () => {
+        const shellScript = path.join(__dirname, "__scripts__", "command", "command_download_dsm.sh");
+        const response = runCliScript(shellScript, TEST_ENVIRONMENT, [""]);
+        expect(response.status).toBe(1);
+        expect(response.stderr.toString()).toContain("pattern");
+        expect(response.stderr.toString()).toContain("Missing Positional");
+    });
+
+    it("should fail due to specifying both binary and record", async () => {
+        const shellScript = path.join(__dirname, "__scripts__", "command", "command_download_dsm.sh");
+        const response = runCliScript(shellScript, TEST_ENVIRONMENT, ["test", "--binary", "--record"]);
+        expect(response.status).toBe(1);
+        expect(response.stderr.toString()).toContain("following options conflict");
+        expect(response.stderr.toString()).toContain("--record");
+        expect(response.stderr.toString()).toContain("--binary");
+    });
+
+    it("should fail due to specifying both extension and extensionMap", async () => {
+        const shellScript = path.join(__dirname, "__scripts__", "command", "command_download_dsm.sh");
+        const response = runCliScript(shellScript, TEST_ENVIRONMENT, ["test", "--extension", "--extension-map"]);
+        expect(response.status).toBe(1);
+        expect(response.stderr.toString()).toContain("following options conflict");
+        expect(response.stderr.toString()).toContain("--extension");
+        expect(response.stderr.toString()).toContain("--extension-map");
+    });
+});

packages/cli/__tests__/zosfiles/__system__/download/dsm/__scripts__/command_download_dsm.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+set -e
+
+zowe zos-files download dsm $*
+if [ $? -gt 0 ]
+then
+    exit $?
+fi

packages/cli/__tests__/zosfiles/__system__/download/dsm/__scripts__/command_download_dsm_fully_qualified.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+HOST=$2
+PORT=$3
+USER=$4
+PASS=$5
+
+zowe zos-files download dsm "$1" --host $HOST --port $PORT --user $USER --password $PASS --ru=false
+exit $?