RTVCFGSRC

Extraire source configuration

En bref

La commande RTVCFGSRC (Extraire le source d'une configuration) permet d'extraire les instructions source CL décrivant des objets de configuration existants.

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

Syntaxe minimale

RTVCFGSRC CFGD(…) CFGTYPE(…)

Paramètres

CFGD Description de configuration obligatoire
CFGTYPE Type obligatoire
SRCFILE Fichier source
SRCMBR Membre source
RTVOPT Option d'extraction
MBROPT Option de membre
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez RTVCFGSRC 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 RTVCFGSRC (Extraire le source d'une configuration) permet d'extraire les instructions source CL décrivant des objets de configuration existants. Ces instructions sont placées dans un membre de fichier source et permettent de recréer les objets.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
CFGD	Description de configuration	Valeurs uniques: ALL Autres valeurs (jusqu'à 256 répétitions): Nom générique, nom*	Obligatoire, positionnel 1
CFGTYPE	Type	ALL, NWSD, LIND, CTLD, DEVD, MODD, COSD, NTBD	Obligatoire, positionnel 2
SRCFILE	Fichier source	Nom d'objet qualifié	Facultatif, positionnel 3
	Qualificatif 1: Fichier source	Nom, QCLSRC
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
SRCMBR	Membre source	Nom, *CFGD	Facultatif, positionnel 4
RTVOPT	Option d'extraction	NET, OBJ	Facultatif
MBROPT	Option de membre	ADD, REPLACE	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, CFGDTXT, BLANK	Facultatif

Description de configuration (CFGD)

Indique le nom des objets de configuration à extraire.

Ce paramètre est obligatoire.

*ALL: Tous les objets de configuration du type indiqué (paramètre CFGTYPE) seront extraits.
nom-générique-objet-de-configuration: Indiquez le nom générique d'une description de configuration. Un nom générique est une chaîne composée d'un ou de plusieurs caractères suivis d'un astérisque (*), comme par exemple, ABC*. L'astérisque remplace tout caractère admis. Un nom générique désigne tous les objets dont le nom commence par le préfixe générique pour lequel l'utilisateur dispose de droits. Si le nom (préfixe) générique n'est pas suivi d'un astérisque, le système considère qu'il s'agit du nom d'objet complet.
nom-description-configuration: Indiquez le nom de description de configuration défini par l'utilisateur.

Vous pouvez indiquer 256 noms au maximum. Le panachage de noms spécifiques et génériques est permis.

Ce paramètre admet des valeurs multiples.

Type (CFGTYPE)

Indique le type de l'objet de configuration à extraire.

*ALL

L'ensemble des descriptions de serveur de réseau, des lignes, des contrôleurs, des unités, des modes, des classes de service et des descriptions NetBIOS correspondant aux noms indiqués sont extraits dans l'ordre suivant :

Listes de connexion
Descriptions de serveurs de réseau
Descriptions de lignes
Descriptions de contrôleurs
Descriptions d'unités
Descriptions de modes
Descriptions de classes de service
Descriptions NetBIOS
SWTLINLST pour les descriptions de contrôleurs
Imprimante pour les écrans éloignés

*NWSD: Toutes les descriptions de serveurs de réseau correspondant aux noms indiqués seront extraites.
*LIND: Toutes les descriptions de lignes correspondant au nom indiqué au paramètre Description de configuration (CFGD) seront extraites.
*CTLD: Toutes les descriptions de contrôleurs correspondant au nom indiqué au paramètre Description de configuration (CFGD) seront extraites.
*DEVD: Toutes les descriptions d'unités correspondant au nom indiqué au paramètre Description de configuration (CFGD) seront extraites.
*MODD: Toutes les descriptions de modes correspondant au nom indiqué au paramètre Description de configuration (CFGD) seront extraites.
*COSD: Toutes les descriptions de classes de service correspondant au nom indiqué au paramètre Description de configuration (CFGD) seront extraites.
*NTBD: Toutes les descriptions NetBIOS correspondant aux noms indiqués seront extraites.

Fichier source (SRCFILE)

Indique le nom et la bibliothèque du fichier source base de données précédemment créé contenant le membre.

Les valeurs possibles pour le fichier source sont les suivantes :

QCLSRC: Fichier source QCLSRC.
nom-fichier-source: Indiquez le nom d'un fichier source.

Pour la bibliothèque, les valeurs possibles sont les suivantes :

*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: La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

nom-bibliothèque: Entrez le nom de la bibliothèque contenant le fichier source.

Membre source (SRCMBR)

Désigne le membre de fichier source base de données dans lequel sont copiées les instructions source CL.

*CFGD: Si un seul nom d'objet de configuration (non générique et différent de *ALL) est indiqué, le membre source portera ce nom. Dans le cas contraire, il sera nommé CFGSRC.
nom-membre-source: Indiquez le nom du membre de fichier source devant contenir les instructions source CL.

Option d'extraction (RTVOPT)

Indique si l'extraction du source concerne les objets dépendant de l'objet spécifié.

*NET: Pour les interfaces de réseau, chaque description d'interface de réseau sera extraite, de même que les descriptions d'unités, de contrôleurs et de lignes louées qui en dépendent. Pour les lignes, chaque description de ligne sera extraite, ainsi que les descriptions d'unités et de contrôleurs loués qui en dépendent. Pour les contrôleurs, chaque description de contrôleur sera extraite, de même que les descriptions des unités dépendantes. Les informations concernant les connexions avec les objets commutés seront également extraites.
*OBJ: Chaque description d'objet de configuration indiquée sera extraite, avec toutes les informations concernant les liens avec les objets dépendants.

RTVOPT n'est pas pris en compte si la valeur du paramètre CFGTYPE est *ALL.

Option de membre (MBROPT)

Indique si les nouveaux enregistrements remplacent ou sont ajoutés aux enregistrements existants.

*REPLACE: Le système met à blanc le membre existant et ajoute les nouveaux enregistrements.

*ADD: Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*CFGDTXT: Si un seul nom d'objet (non générique) a été indiqué, le texte sera identique à celui de l'objet défini au paramètre CFGD. Dans le cas contraire, *BLANK est utilisé.
*BLANK: Aucun texte n'est indiqué.
'descriptif': Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Exemples

RTVCFGSRC   CFGD(CTL*)  CFGTYPE(*CTLD)
            SRCMBR(CTLS)  RTVOPT(*OBJ)

Cette commande place des instructions source CL dans le membre de fichier CTLS du fichier source QCLSRC. Ces instructions source permettent de recréer des descriptions d'objet pour tous les contrôleurs existants dont le nom commence par CTL.

Messages d'erreur

Messages *ESCAPE

CPF2207: Non autorisé à utiliser objet &1 de &3 type *&2.
CPF263E: Numéro de séquence maximal atteint pour le membre &1.
CPF263F: Aucun objet n'a été trouvé.
CPF264A: Longueur d'enreg trop petite pour fichier &1 de &2.
CPF264C: Membre de fichier source &1 non trouvé.
CPF9810: Bibliothèque &1 non trouvée.
CPF9820: Non autorisé à utiliser la bibliothèque &1.
CPF9847: Erreur lors de la fermeture du fichier &1 de bibliothèque &2.
CPF9848: Ouverture du membre &3 du fichier &1 de &2 impossible.
CPF9849: Erreur lors du traitement du membre &3 de &1 dans &2.