SSH Tectia  
Previous Next Up [Contents] [Index]

    About This Document >>
    Installing SSH Tectia Server for IBM z/OS >>
    Getting Started with SSH Tectia Server for IBM z/OS >>
    Configuring the Server >>
    Configuring the Client >>
    Authentication >>
    File Transfer Using SFTP >>
        Handling MVS Datasets and HFS File System Access>>
        Controlling File Transfer>>
        Staging
        Listing Datasets with SFTP Clients>>
            Dataset Lists
            Dataset Hierarchy
            Using Dataset Listing on the z/OS sftp2 Client
        Secure File Transfer Examples Using the z/OS Client>>
        Secure File Transfer Examples Using Windows and Unix Clients>>
    File Transfer Using Transparent FTP Tunneling >>
    Tunneling on the Command Line >>
    Troubleshooting SSH Tectia Server for IBM z/OS >>
    Advanced Information >>
    Man Pages >>
    Log Messages >>

Dataset Hierarchy

SSH Tectia Server for IBM z/OS presents z/OS datasets as if they formed a hierarchy of directories where the dataset name (DSN) qualifiers are the directory names.

The cd command can be used to change the DSN prefix. 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 "//" ("/_"). If the "directory" name has a qualifier, it needs to have a trailing dot.

For example, to change the working "directory" to //'USER1., use the command:

sftp> cd //'USER1.           (cd /__USER1.)
/__USER1.
sftp>

If the user is connected as USER1, use the command:

sftp> cd //                  (cd /_)
/__USER1.
sftp>

Once working in a "directory" (//'USER1., for example) you can go into a "subdirectory" by doing a cd to a qualifier:

sftp> cd TEST.
/__USER1.TEST.
sftp> ls -l
/__USER1.TEST.:
Z6SYS1 Jul 17 2006 VB 1024 27998 PS 50001 FILE
Z6SYS1 Jul 25 2006 VB 1024 27998 PS 50001 PS.FILE1
Z6SYS1 Jul 25 2006 VB 1024 27998 PS 50001 PS.FILE2
Z6SYS1 Jul 25 2006 VB 1024 27998 PS 50001 PS.FILE3

sftp> cd PS.
/__USER1.TEST.PS.
sftp> ls -l
/__USER1.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

sftp>

You can go "up" in the hierarchy with the "cd .." command:

sftp> cd ..
/__USER1.TEST.
sftp> ls
/__USER1.TEST.:
FILE*
PS.FILE1*
PS.FILE2*
PS.FILE3*

sftp> cd ..
/__USER1.
sftp>

The cd command can also be used for going into a PDS or PDSE dataset, for example:

sftp> cd PDS
/__USER1.PDS
sftp> ls
/__USER1.PDS:
MEM1*
MEM2*

Note: When navigating in qualifiers, the qualifier name needs to have a trailing dot. When doing cd to a dataset (PDS or PDSE), the dataset name should not have a trailing dot.

Instead of using the cd command to change the directory one qualifier at a time, the whole dataset name can be used, for example:

sftp> cd //'USER1.TEST.PS.   (cd /__USER1.TEST.PS.)
/__USER1.TEST.PS.

Previous Next Up [Contents] [Index]


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

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