zowe → zos-files → list → data-set

List data sets that match a pattern in the data set name

Usage

zowe zos-files list data-set <dataSetName> [options]

Positional Arguments

• dataSetName (string)

  • The name or pattern of the data set that you want to list

Options

• --attributes | -a (boolean)

  • Display more information about each member. Data sets with an undefined record format display information related to executable modules. Variable and fixed block data sets display information about when the members were created and modified.

• --max-length | --max (number)

  • The option --max-length specifies the maximum number of items to return. Skip this parameter to return all items. If you specify an incorrect value, the parameter returns up to 1000 items.

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.

Profile Options

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

  • The name of a (zosmf) profile to load for this command execution.

Examples

• Show the data set "ibmuser.asm":

  • zowe zos-files list data-set "ibmuser.asm" Copy

• Show attributes of the data set "ibmuser.cntl":

  • zowe zos-files list data-set "ibmuser.cntl" -a Copy

• Show all data sets of the user "ibmuser":

  • zowe zos-files list data-set "ibmuser.*" Copy

• Show attributes of all data sets of the user "ibmuser":

  • zowe zos-files list data-set "ibmuser.*" -a Copy

• Show the first 5 data sets of the user "ibmuser":

  • zowe zos-files list data-set "ibmuser.cntl" --max 5 Copy