Your browser does not allow storing cookies. We recommend enabling them.

SSH Tectia

Dataset Lists

To display dataset lists, use the ls and ls -l commands. The ls command shows the list with relative dataset names. The ls -l command shows additional information formatted by the server.

When listing a PDS or PDSE, the member names are listed.

When listing a GDG, the GDG name is treated as a prefix. The listing may contain datasets that are not in the GDG index but do have dataset names that have the GDG name as a prefix.

Using the ls command without any parameters displays the content of the current working directory.

sftp> ls

Users can also define the DSN qualifier or HFS path they want to list. To use an absolute DSN, start the prefix with "//'". To use a relative DSN, which will be completed with the username, start the prefix with "//".


When listing datasets in the main catalog, the listing shows only catalog entries. The catalog does not have entries for users. The user's name will be in the listing only if there is a user catalog connector entry with that name.

To list datasets with the DSNs USER1.TEST.PS.*, use the following command:

sftp> ls //'USER1.TEST.PS.'

If the user is connected as USER1, use the following command for an extended list:

sftp> ls -l //TEST.PS.
Volume Referred    Recfm Lrecl BlkSz Dsorg    Space  Dsname
Z6SYS1 Jul 25 2006 VB     1024 27998 PS       50001  FILE1
Z6SYS1 Jul 25 2006 VB     1024 27998 PS       50001  FILE2
Z6SYS1 Jul 25 2006 VB     1024 27998 PS       50001  FILE3

The fields in the extended list are:


The volume or volumes the dataset resides on. If the volume cannot be accessed, the text ":offline" is appended to the volume name.


The day on which the dataset was last referred to, or the creation date

Record format


Record size


Block size


File type

The file type: PS, PO, POE, ESDS, KSDS, RRN, or PS/PO. PS/PO is used for non-VSAM datasets on off-line volumes.

Size Estimate

An estimate of the count of data bytes in the dataset which is based on the number of used tracks, or for VSAM files, the High RBA. A 3390 track is estimated to hold 50001 bytes (the track count can be seen in the least significant digits). The size may be smaller than the number of data bytes in the dataset, if it has an efficient block size. The size of the dataset when transferred may differ greatly from the size estimate, depending on such factors as character encoding, line delimiters, and trailing blanks.


The relative dataset name


Highlights from the SSH.COM blog:

  • Cryptomining with the SSH protocol: what big enterprises need to know about it

    Cryptomining malware is primarily thought of as targeting desktops and laptops and is used to hijack system resources to mine cryptocurrency.
    Read more
  • SLAM the door shut on traditional privileged access management

    Did you know that something as trivial-sounding as granting access for your developers or third parties to a product development environment can throw a gorilla-sized monkey wrench into your operations and productivity?
    Read more
  • We broke the IT security perimeter

    Everyone understands the concept of a security perimeter. You only gain access if you are identified and authorized to do so.
    Read more