RTVCURDIR

Extraire répertoire en cours

En bref

La commande Extraire répertoire en cours (RTVCURDIR) est utilisée dans un programme CL pour extraire le nom du répertoire en cours dans la variable CL spécifiée.

RTVCURDIR se lit RTV (Extraire (récupérer)) + CURDIR. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RTVCURDIR RTNDIR(…) DIRNAMLEN(…)

Paramètres

RTNDIR Variable pour RTNDIR (9999) obligatoire
DIRNAMLEN Variable pour DIRNAMLEN (7 0) obligatoire

Astuce : dans une session 5250, tapez RTVCURDIR 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 : Compiled CL program or interpreted REXX (*BPGM *IPGM *BREXX *IREXX)
Compatible multitâche : Non

La commande Extraire répertoire en cours (RTVCURDIR) est utilisée dans un programme CL pour extraire le nom du répertoire en cours dans la variable CL spécifiée. Un nom de chemin absolu qui ne comporte pas de liens symboliques est extrait ainsi que la longueur du nom du répertoire en cours.

L'invite CL pour cette commande répertorie la longueur minimale des variables extraites en regard des paramètres appropriés. Pour les variables de type alphanumérique, un numéro unique s'affiche. Pour les variables décimales, deux numéros s'affichent. Le premier correspond à la longueur minimale de la variable et le deuxième, au nombre minimal de décimales.

Restrictions :

L'utilisateur doit disposer du droit d'exécution (*X) sur le répertoire en cours ainsi que du droit de lecture et d'exécution (*RX) sur chacun des répertoires du chemin.
Cette commande n'est admise que dans un programme CL.
La longueur maximale d'un nom de répertoire pouvant être extraite est limitée par la longueur maximale d'une variable de type alphanumérique.
Remarque :La longueur maximale d'une variable de type alphanumérique ne peut pas dépasser 9999 octets.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
RTNDIR	Variable pour RTNDIR (9999)	Valeur caractère	Obligatoire, positionnel 1
DIRNAMLEN	Variable pour DIRNAMLEN (7 0)	Nombre décimal	Obligatoire, positionnel 2

Variable pour RTNDIR (9999) (RTNDIR)

Indique le nom de la variable CL qui reçoit le nom du répertoire en cours. Elle doit être de type alphanumérique. Si la longueur du nom du répertoire en cours est inférieure à celle définie par la variable, la valeur n'est pas complétée.

Variable pour DIRNAMLEN (7 0) (DIRNAMLEN)

Indique le nom de la variable CL qui reçoit la longueur (en octets) du nom du répertoire en cours. Cette longueur peut dépasser celle de la variable de type alphanumérique qui doit recevoir le nom du répertoire. Cette variable doit être de type décimal et comporter 7 chiffres sans aucun séparateur décimal.

Exemples

Exemple 1 : Extraction du répertoire en cours

RTVCURDIR   RTNDIR(&CD)  DIRNAMLEN(&CDLEN)

Cette commande extrait le nom du répertoire en cours et la longueur de ce nom et les place dans les variables &CD et &CDLEN du programme CL.

Messages d'erreur

Messages *ESCAPE

CPFA085: Répertoire initial de l'utilisateur &1 introuvable.
CPFA09C: Aucun droit sur l'objet. L'objet est &1.
CPFA0A1: Erreur d'entrée ou de sortie.
CPFA0A9: Objet introuvable. L'objet est &1.