zowe › rse-api-for-zowe-cli › search › uss-file🖨️

Search for UNIX Files by specifying the path, file name, and text pattern. If Regex pattern is not used, wildcard patterns are used.

Usage

zowe rse-api-for-zowe-cli search uss-file <path> <fileName> [options]

Positional Arguments

• path (string)

  • The working directory. Example: /u/IBM/test.

• fileName (string)

  • The name of the file to perform the action on. Example: test.txt or ***.txt

Options

• --text | -t (string)

  • The text pattern to be searched for in the provided file. Example: hello

• --regex-file-name | --rfn (boolean)

  • Regex for filename. If Regex pattern is not used, wildcard patterns are used.

    Default value: false

• --regex-content | --rc (boolean)

  • Regex for text pattern. If Regex pattern is not used, wildcard patterns are used.

    Default value: false

• --case-sensitive-file-name | --csfn (boolean)

  • Case-sensitive search for filename

    Default value: false

• --case-sensitive-content | --csc (boolean)

  • Case-sensitive search for content

    Default value: false

• --path-results-only | --pro (boolean)

  • Reduce the response to only the path results

    Default value: false

• --response-format-type | --rft (string)

  • The command response output format type. Must be one of the following: table, list, object, string

    Default value: list

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

• Search for a Unix System Services file with a file format of *.txt in /u/myuser/myfiles:

  • zowe rse-api-for-zowe-cli search uss-file "/u/ibmuser/" "*.txt" Copy