CVTCLSRC

Convertir un source CL 38

En bref

La commande CVTCLSRC (Convertir un source CL) permet de convertir le code source du langage de contrôle (CL) de la syntaxe IBM 38 en syntaxe IBM i.

CVTCLSRC se lit CVT (Convertir) + CLSRC. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CVTCLSRC FROMFILE(…) TOFILE(…) FROMMBR(…)

Paramètres

FROMFILE Fichier d'origine obligatoire
TOFILE Fichier de destination obligatoire
FROMMBR Membre d'origine obligatoire

Astuce : dans une session 5250, tapez CVTCLSRC 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 CVTCLSRC (Convertir un source CL) permet de convertir le code source du langage de contrôle (CL) de la syntaxe IBM 38 en syntaxe IBM i. Les différentes conversions effectuées sont les suivantes :

nom-objet.nom-bibliothèque IBM 38 en
- nom-bibliothèque/nom-objet
nom-travail.nom-utilisateur.numéro-travail IBM 38 en
- numéro-travail/nom-utilisateur/nom-travail
Délimiteurs de commentaires de début : (/*) en (/* )
Nom de commandes
Valeurs et noms de mots clés
Des paramètres obligatoires pour des commandes sont manquants et doivent être ajoutés.

En ce qui concerne les commandes définies par l'utilisateur, la conversion est limitée au reclassement des noms qualifiés et à la réorganisation de la syntaxe des commentaires.

La commande CVTCLSRC permet de créer un état indiquant si la conversion du fichier source a abouti ou échoué. Cet état est contenu dans un fichier imprimante appelé "CVTCLSRC". Les conversions réussies des sources IBM 38 sont consignées dans cet état avec le message suivant :

CPF0786   Le membre a été converti.

Des messages d'erreur sont imprimés pour les conversions qui n'aboutissent pas. Voici quelques exemples de fonctions qui ne peuvent pas être converties et qui peuvent figurer dans l'état en tant que messages d'erreur :

noseq  CPF0785  La commande ne peut pas être convertie.
noseq  CPF0789  Le mot clé dans la commande ne peut pas être converti.

Vous pouvez écrire un programme, par exemple à l'aide de la commande CPYSPLF (Copier un fichier spoule), afin de traiter l'état en fonction de l'aboutissement ou de l'échec des conversions.

Restrictions : La présence de la bibliothèque système QSYS38 est nécessaire à la conversion et à la détection de fonctions non acceptées. Toute commande comportant un nom de commande, un mot clé ou une valeur de mot clé non pris en charge n'est pas convertie.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FROMFILE	Fichier d'origine	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Fichier d'origine	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
TOFILE	Fichier de destination	Nom d'objet qualifié	Obligatoire, positionnel 2
	Qualificatif 1: Fichier de destination	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
FROMMBR	Membre d'origine	Valeurs uniques: ALL Autres valeurs (jusqu'à 50 répétitions): Nom générique, nom*	Obligatoire, positionnel 3

Fichier d'origine (FROMFILE)

Indique le fichier source CL de l'IBM 38 dont la syntaxe est à convertir.

Ce paramètre est obligatoire.

Qualificatif 2: Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier source. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom: Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Fichier de destination (TOFILE)

Indique le fichier devant contenir le source CL converti. Il doit être différent du nom indiqué au paramètre FROMFILE.

Ce paramètre est obligatoire.

Qualificatif 2: Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier source. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom: Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Membre (FROMMBR)

Indique les membres du fichier indiqués au paramètre Fichier d'origine (FROMFILE) à convertir.

*ALL: Tous les membres du fichier source indiqué doivent être convertis.
nom-générique: Indiquez le nom générique des membres à convertir.
nom: Indiquez le nom des membres à convertir. Vous pouvez entrer jusqu'à cinquante noms. Notez que le nom du membre source converti est identique à celui du membre source non converti contenu dans le fichier indiqué au paramètre FROMFILE.

Exemples

CVTCLSRC   FROMFILE(OLDLIB/FILEA)  TOFILE(NEWLIB/FILEB)
           FROMMBR(PGM1 PGM2 PGM3)

Cette commande convertit en fichier source IBM i trois membres (PGM1, PGM2, PGM3) d'un fichier source IBM 38 (FILEA) de la bibliothèque OLDLIB. Les membres convertis du fichier source son placés dans FILEB situé dans la bibliothèque NEWLIB. Ces membres conservent leurs noms d'origine PGM1, PGM2 et PGM3.

Messages d'erreur

Messages *ESCAPE

CPF0781: Le fichier &1 de la bibliothèque &2 n'est pas un fichier source.
CPF0784: Le fichier destination est le même que le fichier origine.