Change Current Directory (CHGCURDIR)

The Change Current Directory (CHGCURDIR) 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 can also be issued using the following alternative file system command names:

• CD
• CHDIR

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

Restrictions:

• 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.".
• 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.

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

Parameters

Directory (DIR)

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.

Examples

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.