Dataset Lists
The form of dataset lists depends on the file transfer client. To
display dataset lists, on most clients the users can use the ls
and ls -l commands. Usually the ls command shows the
list with relative dataset names and possibly some additional
information. The file size is one field in the additional information.
Many SFTP clients show the file sizes of MVS datasets as
"0" because SSH Tectia Server for IBM z/OS does not determine the exact file size when
listing files and does not set the size field in the protocol message.
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 server will treat the GDG name 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
/__USER1.:
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 username, start the
prefix with "//" ("/_").
Some older SSH Tectia and third-party command-line and GUI clients requires that a
dot sign is added after the dataset prefix you want to display. This applies
also to SSH Tectia Server for IBM z/OS file transfer clients.
For example, to list the datasets of a user's MVS home directory using
absolute DSN, use the following command:
sftp> ls /__USERID.
Or using a relative DSN, use the following command:
sftp> ls /_.
To list datasets 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.:
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:
- Volume
The volume or volumes the dataset resides on. If the volume cannot be
accessed, the text ":offline" is appended to the volume name.
- Date
The day on which the dataset was last referred to, or the creation date
- Record format
The RECFM or "VSAM"
- Record size
The LRECL
- Block size
The BLKSIZE
- 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 data set 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 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
The relative dataset name
