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: