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:

• CHDIR
• CHGCURDIR

For more information about integrated file system commands, see the Integrated file system information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.

Restrictions:

1. This command works on only one object. If a pattern is specified on the Directory (DIR) parameter and more than one object matches the pattern, the user can select the object from a list in an interactive job. If this is a batch job, the command fails with error message CPFA08E, "More than one name matches pattern.".
2. The current directory and current library are separate and distinct entities. The current library and current directory can be set to the same library, but a change to either the current library or current directory does not affect the other.

   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.

3. The user must have read (*R) authority to the directory.
4. The user must have execute (*X) authority to each directory in the path.

Parameters

Keyword	Description	Choices	Notes
DIR	Directory	Path name	Required, Positional 1

Top

Directory (DIR)

Specifies the path name of the directory that replaces the current working directory of the job.

For more information on specifying path names, refer to "Object naming rules" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.

This is a required parameter.

Examples

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

CHGCURDIR   DIR(/DIRECTORY2)

This command changes the current directory to the directory named DIRECTORY2.

Example 2: Changing a Current Directory to the Parent of the Current Directory

CHGCURDIR   DIR('..')

This command changes the current directory to the parent directory of the directory that contains the current directory before this command is run.

Error messages

*ESCAPE Messages

CPFA085

Home directory not found for user &1.

CPFA08E

More than one name matches pattern.

CPFA093

Name matching pattern not found.

CPFA09C

Not authorized to object. Object is &1.

CPFA09D

Error occurred in program &1.

CPFA0A1

An input or output error occurred.

CPFA0A3

Path name resolution causes looping.

CPFA0A7

Path name too long.

CPFA0A9

Object not found. Object is &1.

CPFA0AB

Operation failed for object. Object is &1.