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

SSH Tectia 
PreviousNextUp[Contents] [Index]

    About This Document >>
    Installing SSH Tectia Server for IBM z/OS >>
    Using SSH Tectia Server for IBM z/OS >>
        Running the Server >>
        Setting Up a Shell User>>
        Running Client Programs>>
        Handling MVS Datasets and HFS File System Access>>
        Listing Datasets with SFTP Clients>>
            Setting the Home Directory
            Dataset Lists
            Dataset Hierarchy
            Using Dataset Listing on the z/OS sftp2 Client
    Configuring the Server >>
    Configuring the Client >>
    Authentication >>
    Troubleshooting SSH Tectia Server for IBM z/OS >>
    Examples of Use >>
    Man Pages >>
    Log Messages >>

Dataset Lists

The form of dataset lists depends on the file transfer client. To display dataset lists, on most clients 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 ls -l command shows additional information formatted by the server.

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

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 "//" ("/_").

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.

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

sftp> ls -l //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 the dataset resides on.

  • 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


  • File type

    The file type: PS, PO, POE, ESDS, KSDS, RRN

  • 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

PreviousNextUp[Contents] [Index]

[ Contact Information | Support | Feedback | SSH Home Page | SSH Products ]

Copyright © 2006 SSH Communications Security Corp.
This software is protected by international copyright laws. All rights reserved.
Copyright Notice




What to read next:

  • Reduce Secure Shell risk. Get to know the NIST 7966.

    The NISTIR 7966 guideline from the Computer Security Division of NIST is a direct call to action for organizations regardless of industry and is a mandate for the US Federal government.
    Download now
  • ISACA Practitioner Guide for SSH

    With contributions from practitioners, specialists and SSH.COM experts, the ISACA “SSH: Practitioner Considerations” guide is vital best practice from the compliance and audit community.
    Download now