|Where allowed to run: All environments (*ALL)
The Change Current Directory (CD) command changes a specified directory to the current working directory. The current directory can be a directory, library, folder, or database file. The current directory is used to locate objects used by the commands.
This command is an alias for the Change Current Directory (CHGCURDIR) command and can also be issued using the following alternative command names:
For more information about integrated file system commands, see the Integrated file system topic collection in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.
The current directory, set with this command, affects the integrated file system commands and APIs. The current library, set with the Change Current Library (CHGCURLIB) command, affects commands such as the Create Display File (CRTDSPF) command, that uses the value *CURLIB as a library qualifier.
Specifies the path name of the directory that replaces the current working directory of the job.
This is a required parameter.
For more information on specifying path names, refer to "Object naming rules" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.
Note: This parameter is Unicode-enabled. See "Unicode support in CL" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/ for additional information.
The alternative command name for CD is CHGCURDIR. The following examples use the alternative command name, but CD can be replaced directly for CHGCURDIR in all of them.
Example 1: Changing a Current Directory
This command changes the current directory to the directory named DIRECTORY2.
Example 2: Changing a Current Directory to the Parent of the Current Directory
This command changes the current directory to the parent directory of the directory that contains the current directory before this command is run.