zowe › zos-files › compare › local-file-uss-file🖨️

Compare the contents of a local file and a z/OS USS file in your terminal (stdout).

Usage

zowe zos-files compare local-file-uss-file <localFilePath> <ussFilePath> [options]

Positional Arguments

• localFilePath (string)

  • The path of the local file you want to compare.

• ussFilePath (string)

  • The path of the USS file set you want to compare.

Options

• --binary | -b (boolean)

  • Transfer the content of the first data set in binary mode (no EBCDIC to ASCII conversion). If binary mode is set and the binary2 flag is not set then both data sets are transferred in binary mode.

• --encoding | --ec (string)

  • Transfer the content of the first data set with encoding mode, which means that data conversion is performed using the file encoding specified. If encoding mode is set and the encoding2 flag is not set both data sets are transferred in encoding mode.

• --seqnum | --sn (boolean)

  • If you are comparing two files that contain sequence numbers, this option controls if the sequences numbers are removed from the end of each string. The default is to keep the sequence numbers. Use the --no-seqnum option to not include them.

    Default value: true

• --context-lines | --cl (number)

  • The number of context lines that display before and after detected non-matching lines. By default all matching lines display. If you want to limit the amount of data returned to only lines with differences use the context lines option to reduce the matching lines to only those before and after non-matching lines. Using the value of 0 strips all matching lines.

• --browser-view | --bv (boolean)

  • Opens the diffs between two given files in browser.

• --response-timeout | --rto (number)

  • The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

Zosmf Connection Options

• --host | -H (string)

  • The z/OSMF server host name.

• --port | -P (number)

  • The z/OSMF server port.

    Default value: 443

• --user | -u (string)

  • Mainframe (z/OSMF) user name, which can be the same as your TSO login.

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

  • Mainframe (z/OSMF) password, which can be the same as your TSO password.

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

  • Reject self-signed certificates.

    Default value: true

• --base-path | --bp (string)

  • The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

• --protocol (string)

  • The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

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

Profile Options

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

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

Examples

• Compare the contents of the local file and the USS file "./a.txt" and "/u/user/test.txt":

  • zowe zos-files compare local-file-uss-file "./a.txt" "/u/user/test.txt" Copy

• Compare the contents of the local file and the USS file "./a.txt" and "/u/user/test.txt" without sequence numbers:

  • zowe zos-files compare local-file-uss-file "./a.txt" "/u/user/test.txt" --no-seqnum Copy