CHDIR

La commande Modifier répertoire en cours (CHDIR) permet de passer à un répertoire qui devient le répertoire de travail en cours. Il peut s'agir d'un répertoire classique, d'une bibliothèque, d'un dossier ou d'un fichier base de données. Le répertoire en cours est utilisé par les commandes pour la recherche d'objets.

Cette commande est un alias de la commande Modifier répertoire en cours (CHGCURDIR). Elle constitue également l'équivalent des commandes suivantes :

• CD
• CHGCURDIR

Pour plus d'informations sur les commandes du système de fichiers intégré, reportez-vous aux Rubriques Système de fichiers intégré de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Restrictions :

• Cette commande ne s'applique qu'à un seul objet. Si plusieurs objets correspondent au masque indiqué au paramètre Répertoire (DIR), l'utilisateur peut choisir l'objet voulu à partir d'une liste, dans le cadre d'un travail interactif. S'il s'agit d'un travail par lots, la commande n'aboutit pas et le message d'erreur CPFA08E, "Plusieurs noms correspondent au masque.", apparaît.
• Le répertoire et la bibliothèque en cours sont des entités distinctes. Une même bibliothèque peut être désignée comme bibliothèque et répertoire en cours, mais les modifications apportées à l'un n'affectent pas l'autre.

  Le répertoire en cours, défini à l'aide de cette commande, est utilisé par les commandes de système de fichiers intégré et les API. La bibliothèque en cours, définie à l'aide de la commande Modifier bibliothèque en cours (CHGCURLIB), est utilisée par des commandes telles que Créer un fichier écran CRTDSPF qui contient la valeur *CURLIB comme qualificateur de bibliothèque.

• L'utilisateur doit disposer du droit de lecture (*R) sur le répertoire.
• L'utilisateur doit disposer du droit d'exécution (*X) sur chacun des répertoires du chemin.

Paramètres

Répertoire (DIR)

Indique le nom de chemin du répertoire qui remplace le répertoire de travail en cours.

Ce paramètre est obligatoire.

Pour obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Exemples

L'autre nom de la commande CHDIR est CHGCURDIR. Il est utilisé dans les exemples ci-dessous, mais peut être remplacé directement par CHDIR.

Exemple 1 : Modification du répertoire en cours

CHGCURDIR   DIR(/REPERTOIRE2)

Cet commande remplace le répertoire en cours par le répertoire REPERTOIRE2.

Exemple 2 : Remplacement du répertoire en cours par le parent de celui-ci

CHGCURDIR   DIR('..')

Cet commande remplace le répertoire en cours par le répertoire parent du répertoire en cours avant l'exécution de cette commande.

Messages d'erreur

Messages *ESCAPE

CPFA085

Répertoire initial de l'utilisateur &1 introuvable.

CPFA08E

Plusieurs noms correspondent au masque.

CPFA093

Aucun nom ne correspond au masque indiqué.

CPFA09C

Aucun droit sur l'objet. L'objet est &1.

CPFA09D

Erreur dans le programme &1.

CPFA0A1

Erreur d'entrée ou de sortie.

CPFA0A3

La résolution du nom de chemin provoque une boucle.

CPFA0A7

Le nom de chemin est trop long.

CPFA0A9

Objet introuvable. L'objet est &1.

CPFA0AB

Erreur d'opération pour l'objet. L'objet est &1.