z/OS Communications Server: IP User's Guide and Commands
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Changing the directory of a z/OS FTP server

z/OS Communications Server: IP User's Guide and Commands
SC27-3662-00

If the remote server is z/OS® FTP, the directory value can specify either a z/OS UNIX file system name, a common prefix for a group of MVS™ data sets, or the qualifiers of a partitioned data set (PDS).

Procedure

  • When the CD subcommand is issued, the directory specified is appended to the current working directory. For example, if the current working directory is TCPUSR14.TEST, and you issue the CD subcommand:
    CD FILES
    the new working directory becomes TCPUSR14.TEST.FILES.
  • To override the existing directory rather than append to the directory, issue the directory parameter within single quotation marks. For example, if the current working directory is TCPUSR14.TEST, and you issued the CD subcommand:
    CD 'FTP.FILES'
    the new working directory would be FTP.FILES. If the subdirectory name contains white space, such as NEW SUBDIRECTORY, then the syntax for the CD command would be as follows:
    CD 'NEW SUBDIRECTORY'
    The command syntax must specify the full subdirectory name (including the blank) delimited within single quotation marks.
  • If a PDS exists with the exact name of the current working directory, FTP considers the working directory to be that PDS. Otherwise, FTP considers the working directory to be a common prefix qualifier for sequential data sets.
  • If a PDS exists with the same name as the current working directory, but you want the current working directory to be treated as a common prefix for sequential data sets, specify the working directory with a period (.) at the end. For example, if a PDS named TCPUSR14.TEST exists, the subcommand:
    CD 'TCPUSR14.TEST'
    makes the PDS TCPUSR14.TEST the current working directory. A subsequent PUt of file name1 adds a member name1 to the TCPUSR14.TEST PDS. In contrast, the subcommand
    CD 'TCPUSR14.TEST.'
    makes the current working directory, TCPUSR14.TEST., a prefix for sequential data sets. A subsequent PUt command used to copy data set name1 would create the sequential data set TCPUSR14.TEST.name1.
  • To back up one level of the current working directory, issue the CD subcommand with two periods (..) at the end. For example, if the working directory is jones.source, the subcommand
    CD ..
    makes jones. the working directory. You can also use the CDUp command to back up one level of the current working directory. See CDUp subcommand—Change to the parent of the working directory for more details.

Example

The following sample commands and responses are displayed as a result of the CD subcommand.

For an MVS data set:
cd hsmtest
 >>>CWD hsmtest
 250 "'USER17.HSMTEST.'" is working directory name prefix.
 Command:
For a z/OS UNIX file:
cd '/u/user121/A/B/C'
  >>>CWD '/u/user121/A/B/C'
 250 HFS directory /u/user121/A/B/C is the current working directory
  Command:

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2013
This information center is Built on Eclipse™ ( www.eclipse.org ).