Purpose
Use the LCd subcommand to change
the current working directory on the local host.
Parameters
- qualifier
- Specifies either a common prefix for a group of sequential data
sets or the qualifiers of a PDS.
Note: In a z/OS UNIX environment,
you can omit the qualifier on the LCd subcommand. Doing so changes
the current working directory to your home directory. If you do not
have a home directory, the working directory is not changed, and no
message is issued.
Examples
- Change the local current working directory:
lcd ftp.test1
Local directory name set to partitioned data set USER14.FTP.TEST1.
Command:
- When the LCd subcommand is issued, qualifier is appended to the current local working directory. For
example, if the current local working directory is TCPUSR14.TEST and you issue the LCd subcommand LCD FILES, the
new working directory becomes TCPUSR14.TEST.FILES.
- To override the existing directory rather than append to the directory,
issue the qualifier in single quotation
marks ('). For example, if the current local working directory is TCPUSR14.TEST and you issued the LCd subcommand LCD 'FTP.FILES', the new working directory is FTP.FILES.
- If a PDS exists with the exact name of the current local 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 local working directory, but you want the current local
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 LCD 'TCPUSR14.TEST' makes the PDS TCPUSR14.TEST the current local working directory. A subsequent
Get command used to copy data set name1 would add
the member name1 to the TCPUSR14.TEST PDS. In contrast, the statement LCD 'TCPUSR14.TEST.' would make the current local working directory TCPUSR14.TEST., a prefix for sequential data sets. A subsequent Get command used
to copy data set name1 would create the sequential
data set TCPUSR14.TEST.name1.
- To back up one level of the current local working directory, issue
the LCd subcommand with two periods (..) at the end. For example,
if the working directory is jones.source, the subcommand LCD .. makes jones. the working directory.
Usage
When you enter an FTP session, the
working directory on the local host is set according to the environment
in which the FTP client is invoked: $HOME in z/OS UNIX, your MVS™ user ID in TSO.