## zowe › rse-api-for-zowe-cli › download › data-set

Download content from a z/OS data set to a local file

#### Usage

zowe rse-api-for-zowe-cli download data-set <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set that you want to download

#### Options

- `--binary` | `-b` (boolean)

  - Download the file content in binary mode, which means that no data conversion is performed. The data transfer process returns each line as-is, without translation. No delimiters are added between records.

- `--encoding` | `--ec` (string)

  - Upload the file content with encoding mode, which means that data conversion is performed using the file encoding specified.

- `--extension` | `-e` (string)

  - Save the local files with a specified file extension. For example, .txt. Or "" for no extension. When no extension is specified, .txt is used as the default file extension.

- `--file` | `-f` (string)

  - The path to the local file where you want to download the content. When you omit the option, the command generates a file name automatically for you.

- `--mappings-file` | `--maps` (string)

  - Location of an alternate MVS Mappings file.

- `--volume-serial` | `--vs` (string)

  - The volume serial (VOLSER) where the data set resides. You can use this option at any time. However, the VOLSER is required only when the data set is not cataloged on the system. A VOLSER is analogous to a drive name on a PC.

#### Profile Options

- `--rse-profile` | `--rse-p` (string)

  - The name of a (rse) profile to load for this command execution.

- `--base-profile` | `--base-p` (string)

  - The name of a (base) profile to load for this command execution.

#### Base Connection Options

- `--host` | `-H` (string)

  - Host name of service on the mainframe.

- `--port` | `-P` (number)

  - Port number of service on the mainframe.

- `--user` | `-u` (string)

  - User name to authenticate to service on the mainframe.

- `--password` | `--pass` | `--pw` (string)

  - Password to authenticate to service on the mainframe.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--token-type` | `--tt` (string)

  - The type of token to get and use for the API. Omit this option to use the default token type, which is provided by 'zowe auth login'.

- `--token-value` | `--tv` (string)

  - The value of the token to pass to the API.

- `--cert-file` (local file path)

  - The file path to a certificate file to use for authentication.

    Note: The CLI does not support certificate files that require a password. For more information, search Troubleshooting PEM Certificates in Zowe Docs.

- `--cert-key-file` (local file path)

  - The file path to a certificate key file to use for authentication

#### Examples

- Download the data set "ibmuser.loadlib(main)" to the local file "main.obj".:

  - `zowe rse-api-for-zowe-cli download data-set "ibmuser.loadlib(main)" -f main.obj`

- Download the data set "ibmuser.loadlib(main)" to the local file "main.obj" in binary mode.:

  - `zowe rse-api-for-zowe-cli download data-set "ibmuser.loadlib(main)" -b "./main.obj"`