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.'
MVS prefix `'USER1.'' is the current directory.
'USER1.'
sftp>

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

sftp> cd //
MVS prefix `'USER1.'' is the current directory.
'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.
MVS prefix `'USER1.TEST.'' is the current directory.
'USER1.TEST.'
sftp> ls -l
'USER1.TEST.':
Volume Referred    Recfm Lrecl BlkSz Dsorg    Space  Dsname
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.
MVS prefix `'USER1.TEST.PS.'' is the current directory.
'USER1.TEST.PS.'
sftp> ls -l
'USER1.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

sftp>

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

sftp> cd ..
MVS prefix `'USER1.TEST.'' is the current directory.
'USER1.TEST.'
sftp> ls
'USER1.TEST.':
FILE
PS.FILE1
PS.FILE2
PS.FILE3

sftp> cd ..
MVS prefix `'USER1.'' is the current directory.
'USER1.'
sftp>

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

sftp> cd PDS
MVS prefix `'USER1.PDS'' is the current directory.
The working directory `'USER1.PDS'' is a partitioned data set.
'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.'
MVS prefix `'USER1.TEST.PS.'' is the current directory.
'USER1.TEST.PS.'