CVTRPGSRC

Convertir source RPG

En bref

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

Syntaxe minimale

CVTRPGSRC FROMFILE(…) FROMMBR(…)

Paramètres

FROMFILE Fichier d'origine obligatoire
FROMMBR Membre d'origine obligatoire
TOFILE Fichier de destination
TOMBR Membre de destination
EXPCPY Développer membre COPY
CVTRPT Imprimer rapport de conversion
SECLVL Inclure texte deuxième niveau
INSRTPL Insérer grille spécifications
LOGFILE Fichier de consignation
LOGMBR Membre de consignation

Astuce : dans une session 5250, tapez CVTRPGSRC 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 QDEVTOOLS)

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

Convertir source RPG

La commande CVTRPGSRC convertit le code source RPG III ou RPG/400 en code source ILE RPG.

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: Bibliothèque	Nom, LIBL, CURLIB
FROMMBR	Membre d'origine	Nom générique, nom, *ALL	Obligatoire, positionnel 2
TOFILE	Fichier de destination	Valeurs uniques: NONE Autres valeurs: Nom d'objet qualifié*	Facultatif, positionnel 3
	Qualificatif 1: Fichier de destination	Nom, QRPGLESRC
	Qualificatif 2: Bibliothèque	Nom, LIBL, CURLIB
TOMBR	Membre de destination	Nom, *FROMMBR	Facultatif, positionnel 4
EXPCPY	Développer membre COPY	NO, YES	Facultatif
CVTRPT	Imprimer rapport de conversion	YES, NO	Facultatif
SECLVL	Inclure texte deuxième niveau	NO, YES	Facultatif
INSRTPL	Insérer grille spécifications	NO, YES	Facultatif
LOGFILE	Fichier de consignation	Valeurs uniques: NONE Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: Fichier de consignation	Nom, QRNCVTLG
	Qualificatif 2: Bibliothèque	Nom, LIBL, CURLIB
LOGMBR	Membre de consignation	Nom, FIRST, LAST	Facultatif

Fichier d'origine (FROMFILE)

Indique le nom du fichier source contenant le code source RPG III ou RPG/400 à convertir et la bibliothèque dans laquelle le fichier source est stocké. Il s'agit d'un paramètre obligatoire ; aucun nom de fichier par défaut n'existe.

nom-fichier-source: Entrez le nom du fichier source contenant le(s) membre(s) source à convertir.
*LIBL: Le système recherche la bibliothèque de stockage du fichier source dans la liste des bibliothèques.
*CURLIB: Le fichier source est recherché dans la bibliothèque en cours. Si vous n'en avez indiqué aucune, la bibliothèque QGPL est utilisée.
nom-bibliothèque: Entrez le nom de la bibliothèque dans laquelle le fichier source est stocké.

Membre d'origine (FROMMBR)

Indique le(s) nom(s) du(es) membre(s) source à convertir. Il s'agit d'un paramètre obligatoire ; aucun nom de membre par défaut n'existe.

Les types admis de membre source à convertir sont les suivants : RPG, RPT, RPG38, RPT38, SQLRPG et espace. La commande CVTRPGSRC ne prend pas en charge les types de membre source RPG36, RPT36 et d'autres types de membre source non RPG (par exemple, CLP et TXT).

nom-membre-fichier-source: Entrez le nom du membre source à convertir.
*ALL: La commande convertit tous les membres dans le fichier source indiqué.
nom-générique*-membre-fichier-source: Entrez le nom générique des membres dont le nom comprend le même préfixe suivi de '*' (astérisque). La commande convertit tous les membres portant le nom générique dans le fichier source indiqué. Par exemple, en spécifiant FROMMBR(PR*), vous aboutirez à la conversion de tous les membres dont le nom commence par 'PR'.

Fichier de destination (TOFILE)

Indique le nom du fichier source contenant les membres source convertis et la bibliothèque dans laquelle est stocké le fichier source converti. Celui-ci doit exister et sa longueur d'enregistrement doit être de 112 caractères : 12 pour le numéro de séquence et la date, 80 pour le code et 20 pour les commentaires.

QRPGLESRC: Le fichier source par défaut QRPGLESRC contient le(s) membre(s) source converti(s).
*NONE: Aucun membre source n'est généré. Le paramètre TOMBR n'est pas pris en compte. CVTRPT(*YES) doit également être indiqué, faute de quoi la conversion prend fin immédiatement.
Grâce à ce dispositif, vous pouvez détecter rapidement si des problèmes se posent, sans avoir à convertir le membre source.
nom-fichier-source: Entrez le nom du fichier source converti contenant le(s) membre(s) source converti(s).
Le nom du fichier source TOFILE doit différer du nom de fichier source FROMFILE si le nom de la bibliothèque TOFILE est le même que celui de la bibliothèque FROMFILE.
*LIBL: Le système recherche la bibliothèque dans laquelle est stocké le fichier source converti dans la liste des bibliothèques.
*CURLIB: Le fichier source converti est recherché dans la bibliothèque en cours. Si vous n'en avez indiqué aucune, la bibliothèque QGPL est utilisée.
nom-bibliothèque: Entrez le nom de la bibliothèque dans laquelle est stocké le fichier source converti.

Membre de destination (TOMBR)

Indique le nom du ou des membres source convertis dans le fichier source converti. Si la valeur indiquée au paramètre FROMMBR est (*ALL) ou générique*, la valeur de TOMBR doit être *FROMMBR.

*FROMMBR: Le nom du membre indiqué au paramètre FROMMBR est utilisé comme nom de membre source converti. Si FROMMBR(*ALL) est spécifié, tous les membres source dans FROMFILE sont convertis. Ces derniers portent le même nom que les membres source d'origine. Si un nom générique est indiqué au paramètre FROMMBR, tous les membres source dont le nom comprend le même préfixe sont convertis. Les membres résultants portent le même nom que les membres source génériques d'origine.
nom-membre-fichier-source: Entrez le nom du membre source converti. Si le membre n'existe pas, il est créé.

Développer membre COPY (EXPCPY)

Indique si les membres /COPY sont étendus dans le membre source converti. EXPCPY(*YES) ne doit être indiqué que si des problèmes de conversion relatifs aux membres /COPY se posent.

*NO: Les membres /COPY ne sont pas étendus dans le membre source converti. Il s'agit de la valeur par défaut.
*YES: Les membres /COPY du fichier sont étendus dans le membre source converti.

Remarque :Si le membre est de type RPT ou RPT38, EXPCPY(*YES) ou EXPCPY(*NO) est inutile car le programme d'auto-édition étend toujours les membres /COPY.

Imprimer rapport de conversion (CVTRPT)

Indique si un rapport de conversion est imprimé.

*YES: Un rapport de conversion est imprimé. Il s'agit de la valeur par défaut.
*NO: Aucun rapport de conversion n'est imprimé.

Inclure texte deuxième niveau (SECLVL)

Indique si le message de deuxième niveau est imprimé dans le rapport de conversion.

*NO: Aucun message de deuxième niveau n'est imprimé dans le rapport de conversion. Il s'agit de la valeur par défaut.
*YES: Le message de deuxième niveau est imprimé dans le rapport de conversion.

Insérer grille spécifications (INSRTPL)

Indique si les modèles de spécification ILE RPG (H-, F-, D-, I-, C- et/ou O) sont insérés dans les membres source convertis.

*NO: Aucun modèle de spécification n'est inséré dans le membre source converti. Il s'agit de la valeur par défaut.
*YES: Un modèle de spécification est inséré dans le membre source converti. Chaque modèle de spécification est inséré au début de la section de spécification correspondante.

Fichier de consignation (LOGFILE)

Indique le nom du fichier de consignation utilisé pour le suivi des informations relatives à la conversion. Le fichier doit exister sauf si *NONE est indiqué. Il doit s'agir d'un fichier de données physique existant. Créez le fichier de consignation à l'aide de la commande CPYF en indiquant le fichier QARNCVTLG de la bibliothèque QRPGLE pour le paramètre "Objet d'origine" et le fichier QRNCVTLG de votre bibliothèque pour le paramètre "Nouvel objet".

QRNCVTLG: Le fichier de consignation par défaut QRNCVTLG est utilisé pour l'enregistrement des informations relatives à la conversion.
*NONE: Les informations relatives à la conversion ne sont pas écrites dans un fichier de consignation.
nom-fichier-consignation: Entrez le nom du fichier de consignation qui permet de faire le suivi des informations relatives à la conversion.
*LIBL: Le système recherche la bibliothèque dans laquelle est stocké le fichier de consignation dans la liste des bibliothèques.
nom-bibliothèque: Entrez le nom de la bibliothèque dans laquelle est stocké le fichier de consignation.

Membre de consignation (LOGMBR)

Indique le nom du membre de consignation utilisé pour le suivi des informations relatives à la conversion. Les nouvelles informations sont ajoutées aux données existantes dans le membre de consignation spécifié.

Si le fichier de consignation ne contient aucun membre, un membre est créé sous le nom de ce fichier.

*FIRST: La commande exécute le premier membre dans le fichier de consignation indiqué. Il s'agit de la valeur par défaut.
*LAST: La commande exécute le dernier membre dans le fichier de consignation indiqué.
nom-membre-consignation: Entrez le nom du membre de fichier utilisé pour le suivi des informations relatives à la conversion.

Exemples

Exemple 1 : conversion du source RPG III en source RPG IV

CVTRPGSRC   FROMFILE(MABIB/QRPGSRC) FROMMBR(XMPLE1)
            TOFILE(MABIB/QRPGLESRC) TOMBR(*FROMMBR)
            EXPCPY(*NO)
            CVTRPT(*YES) LOGFILE(MABIB/QRNCVTLG)

Cette commande permet de convertir le membre source RPG III XMPLE1 du fichier MABIB/QRPGSRC en membre source RPG IV du même nom dans le fichier MABIB/QRPGLESRC. Les instructions /COPY du programme RPG III ne sont pas étendues ; elles restent des instructions /COPY dans le programme RPG IV. Un rapport est imprimé. L'état de chaque conversion est consigné dans le fichier MABIB/QRNCVTLG.

Messages d'erreur

Messages *ESCAPE

RNS9350: Conversion arrêtée