zowe › zos-ftp › view › uss-file🖨️

View the contents of a Unix System Services File

Usage

zowe zos-ftp view uss-file <ussFile> [options]

Positional Arguments

• ussFile (string)

  • The USS file you'd like to view the contents of.

Options

• --binary | -b (boolean)

  • View content in binary form without converting to ASCII text

• --secure-ftp (boolean)

  • Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

• --connection-timeout | --ct (number)

  • How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

Required Options

• --host | -H (string)

  • The hostname or IP address of the z/OS server to connect to.

• --port | -P (number)

  • The port of the z/OS FTP server.

    Default value: 21

• --user | -u (string)

  • Username for authentication on z/OS

• --password | -p | --pass | --pw (string)

  • Password to authenticate to FTP.

TLS / Secure Connection options

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

  • Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

• --server-name | --sn (string)

  • Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

Profile Options

• --zftp-profile | --zftp-p (string)

  • The name of a (zftp) 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

• --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

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

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

Examples

• View the content of the USS file "/u/users/ibmuser/myfile.txt":

  • zowe zos-ftp view uss-file "/u/users/ibmuser/myfile.txt" Copy

• View the content of the USS file "/u/users/ibmuser/myjava.jar" in binary mode and pipe it into the hex viewer command xxd:

  • zowe zos-ftp view uss-file "/u/users/ibmuser/myjava.jar" -b | xxd Copy