Zos download attributes

packages/cli/src/zosfiles/download/uss/UssFile.definition.ts

@@ -39,6 +39,7 @@ export const UssFileDefinition: ICommandDefinition = {
         }
     ],
     options: [
+        DownloadOptions.attributes,
         DownloadOptions.file,
         DownloadOptions.binary,
         DownloadOptions.encoding

packages/cli/src/zosfiles/download/uss/UssFile.handler.ts

@@ -11,7 +11,8 @@
 
 import { ZosFilesBaseHandler } from "../../ZosFilesBase.handler";
 import { AbstractSession, IHandlerParameters, ITaskWithStatus, TaskStage } from "@zowe/imperative";
-import { Download, IZosFilesResponse } from "@zowe/zos-files-for-zowe-sdk";
+import { Download, IDownloadOptions, IZosFilesResponse, ZosFilesAttributes } from "@zowe/zos-files-for-zowe-sdk";
+import { UploadOptions } from "../../upload/Upload.options";
 
 /**
  * Handler to download an uss file
@@ -25,13 +26,21 @@
             stageName: TaskStage.IN_PROGRESS
         };
         commandParameters.response.progress.startBar({task});
-        return Download.ussFile(session, commandParameters.arguments.ussFileName, {
+
+        const downloadOptions: IDownloadOptions = {
             binary: commandParameters.arguments.binary,
             encoding: commandParameters.arguments.encoding,
             file: commandParameters.arguments.file,
             task,
             responseTimeout: commandParameters.arguments.responseTimeout,
-            overwrite: commandParameters.arguments.overwrite
-        });
+            overwrite: commandParameters.arguments.overwrite,
+        };
+        const attributes = ZosFilesAttributes.loadFromFile(
+            commandParameters.arguments.attributes,
+        );
+        if (attributes != null) {
+            downloadOptions.attributes = attributes;
+        }
+        return Download.ussFile(session, commandParameters.arguments.ussFileName, downloadOptions);
     }
 }

packages/zosfiles/src/doc/IOptions.ts

@@ -11,6 +11,7 @@
 
 import { ITaskWithStatus } from "@zowe/imperative";
 import { IZosFilesOptions } from "./IZosFilesOptions";
+import { ZosFilesAttributes } from "../utils/ZosFilesAttributes";
 
 /**
  * This interface defines the options that can be sent to get a data set or USS file function
@@ -57,4 +58,8 @@ export interface IOptions extends IZosFilesOptions {
      * @type {ITaskWithStatus}
      */
     task?: ITaskWithStatus;
+    /**
+     * The path to a .zosattributes file used to control file conversion and tagging.
+     */
+    attributes?: ZosFilesAttributes;
 }

packages/zosfiles/src/methods/download/Download.ts

@@ -531,6 +531,11 @@ export class Download {
             ussFileName = ZosFilesUtils.sanitizeUssPathForRestCall(ussFileName);
             const endpoint = posix.join(ZosFilesConstants.RESOURCE, ZosFilesConstants.RES_USS_FILES, ussFileName);
 
+            if(options.attributes)
+            {
+                options.encoding = options.attributes.getRemoteEncoding(ussFileName);
+            }
+
             const reqHeaders: IHeaderContent[] = this.generateHeadersBasedOnOptions(options);
 
             // Use specific options to mimic ZosmfRestClient.getStreamed()

packages/zosfiles/src/methods/download/doc/IDownloadOptions.ts

@@ -58,9 +58,13 @@ export interface IDownloadSingleOptions extends IGetOptions {
     overwrite?: boolean;
 
     /**
-     * Optional stream to read the file contents
+     * Optional stream to write the file contents
      */
     stream?: Writable;
+    /**
+     * The ZosFilesAttributes instance describe upload attributes for the files and directories
+     */
+    attributes?: ZosFilesAttributes;
 }
 
 /**

usstest.txt

@@ -0,0 +1 @@
+E@Q@U@�@�@I@h@Y@�����@Z|{[l@_@�@�@[@�@?