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

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 file, for example:

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

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.