Commande CL IBM i (AS/400)

CHGCURDIR

Modifier répertoire en cours

En bref

La commande Modifier répertoire en cours (CHGCURDIR) permet de passer à un répertoire qui devient le répertoire de travail en cours.

CHGCURDIR se lit CHG (Modifier) + CURDIR. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGCURDIR DIR(…)

Paramètres

DIR Répertoire obligatoire

Astuce : dans une session 5250, tapez CHGCURDIR puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande Modifier répertoire en cours (CHGCURDIR) 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 peut également être lancée en utilisant les commandes de système de fichiers suivantes :

CD
CHDIR

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

Mot-clé	Description	Valeurs possibles	Remarques
DIR	Répertoire	Chemin d'accès	Obligatoire, positionnel 1

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

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.