zowe › caview › list › reports🖨️

List reports in a repository.
Use the returned 'ReportHandle' to reference a report in other commands.
For example, use the 'ReportHandle' in the 'download report' command to download that report.

Usage

zowe caview list reports <repositoryId> [options]

Positional Arguments

• repositoryId (number)

  • Repository identifier.

Options

• --filter-name | -n (string)

  • Filter (include) based on report name. Use the asterisk (*) as a wildcard to represent any number of characters.

    Default value: *

• --limit | -l (number)

  • Limit (maximum number) of retrieved records.

    Default value: 1000

• --latest-versions | --latest-version | --lv (number)

  • Number of latest versions (of reports) to include. If not specified, all versions of reports are included.

    Default value: 0

• --archival-since | --since | --archival-from | --from (string)

  • Date of earliest archived reports to include based on archival date. Specify a value in the ISO-8601 format.

• --archival-until | --until | --archival-to | --to (string)

  • Date of latest archived reports to include based on archival date. Specify a value in the ISO-8601 format.

• --output-header | --header (boolean)

  • Include header with field names in the output when you specify 'tabular' or 'csv' for the output format.
    This option is ignored when you specify any other output format.

    Default value: true

• --output-format | --output (string)

  • Output format. This option is ignored if '--response-format-json' is specified.

    Default value: tabular
    Allowed values: ^tabular$, ^csv$, ^json$, ^xml$

• --output-field | -f (array)

  • Field to include in the output. Multiple fields can be specified.
    Fields appear in the order you specify.

    Allowed values: ReportName,Lines,Pages,Type,ArchivalDate,Description,UserComments,ReportHandle,TotalPages,OriginalType,Destination,JobName,Origin,Generation,SequenceNumber,SysoutClass,Status,JobID,Forms,XCode,UserID,ReadDate,PrintDate,OnDisk,OnTape,OnOptical,IndexOnDisk,Location,TapeSequence,TapePosition,TapeCount,ExtendedRetentionOptionID,RemainingDays,RemainingGenerations,RemainingCopy,RemainingDiskDays,RemainingDiskGeneration,RemainingDiskCopy,RemainingDisk2days

    Default value: ReportName,Lines,Pages,Type,ArchivalDate,Description,UserComments,ReportHandle

Profile Options

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

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

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

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