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


LCd subcommand—Change the local working directory

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

Purpose

Use the LCd subcommand to change the current working directory on the local host.

Format

  • In a TSO Environment:
    Read syntax diagramSkip visual syntax diagram
    >>-LCd--qualifier----------------------------------------------><
    
    
  • In a z/OS UNIX System Services Environment:
    Read syntax diagramSkip visual syntax diagram
    >>-LCd--+-----------+------------------------------------------><
            '-qualifier-'   
    
    

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.

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 ).