To display data set lists, use the ls and ls -l commands. The ls command shows the list with relative data set 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 data sets that are not in the GDG index but do have data set 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 BINARY.FILE CONT2.TEST2 DEMO.ZIP FILE.Z FILE1.PS FILE1.VSAM FILE2.PS ISPF.ISPPROF PDS SAMPLIB TEST.FILE WINFILE.PS WINPDS
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 user name, start the prefix with "
When listing data sets 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 data sets with the DSNs
USER1.TEST.PS.*, use the following command:
sftp> ls //'USER1.TEST.PS.' //'USER1.TEST.PS.': FILE1 FILE2 FILE3
If the user is connected as
USER1, use the following command for an extended list:
sftp> ls -l //TEST.PS. //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 data set resides on. If the volume cannot be accessed, the text "
:offline" is appended to the volume name.
- Date (Referred)
The day on which the data set was last referred to, or the creation date
- Record format (Recfm)
- Record size (Lrecl)
- Block size (BlkSz)
- File type (Dsorg)
The file type: PS, PO, POE, ESDS, KSDS, RRN, or PS/PO. PS/PO is used for non-VSAM data sets on off-line volumes.
- Size Estimate (Space)
An estimate of the count of data bytes in the data set which is based on the number of used tracks; or for VSAM files, the High RBA; and for PDSEs, the number of allocated tracks. 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 data set, if it has an efficient block size. The size of the data set when transferred may differ greatly from the size estimate, depending on such factors as character encoding, line delimiters, and trailing blanks.
- Name (Dsname)
The relative data set name