lcd - Change local working directory

The lcd command changes the current local working directory or the file system on the local host. Changing the file system always takes you to the corresponding HOME directory. The current local working directory can be determined with the lpwd command. The remote working directory can be set with the cd command.

lcd

. | .. | %POSIX | %BS2000 | $HOME | <path>

.

The local working directory is not changed (included only for compatibility with other implementations).

..

The last partial qualifier (on the extreme right) is removed from the name of the local working directory in the DMS file system.In the POSIX file system, the directory is changed to the next higher level.

%POSIX

Changes to the local POSIX HOME directory.

%BS2000

Changes to the local DMS HOME directory. In the DMS file system, the %BS2000 specification is synonymous with $HOME.

$HOME

Changes to the local DMS HOME directory. In order to specify $HOME, you must already be in a DMS directory.

<path>

If a full path name (beginning with the specification of a catalog and/or user ID) isspecified in the DMS directory, the existing working directory is replaced. If the specification of the catalog and the user ID are omitted, the <old.name>.<path> is set.

The path names are not validated in the DMS file system.
In the POSIX file system, <path> may be an absolute or relative POSIX path name.

Example

1. Query the local working directory.

   lpwd

   Local directory is :5:$TCPTEST.

2. Change the working directory by adding the partial qualifier MAN.

   lcd man

   Local directory now :5:$TCPTEST.MAN.

3. Change to the POSIX HOME directory.

   lcd %POSIX

   Local directory now /home/usr

4. Change the working directory to /home/usr/test.

   lcd test

   Local directory now /home/usr/test

5. Change to the DMS HOME directory.

   lcd %BS2000

   Local directory now :5:$TCPTEST.

6. Change the working directory by adding a partial qualifier.

   lcd XXX

   Local directory now :5:$TCPTEST.XXX.

7. Change the working directory by removing a partial qualifier.

   lcd ..

   Local directory is :5:$TCPTEST.