RTVTBLSRC

Extraire source de table

En bref

La commande RTVTBLSRC sert à extraire le source d'une table *CVT ou *SRTSEQ.

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

Syntaxe minimale

RTVTBLSRC TBL(…) SRCFILE(…)

Paramètres

TBL Nom de la table obligatoire
SRCFILE Fichier source obligatoire
SRCMBR Membre source
CVTTOUCS Convertir en UCS-2
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez RTVTBLSRC 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 RTVTBLSRC sert à extraire le source d'une table *CVT ou *SRTSEQ. Ces instructions source sont stockées dans un membre de fichier source utilisable comme entrée lors de la création d'une table à l'aide de la commande CRTTBL. De plus, cette commande convertit le source d'une table *SRTSEQ au format nécessaire pour la création d'une table *UCSSRTSEQ.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
TBL	Nom de la table	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Nom de la table	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
SRCFILE	Fichier source	Nom d'objet qualifié	Obligatoire, positionnel 2
	Qualificatif 1: Fichier source	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
SRCMBR	Membre source	Nom, *TBL	Facultatif, positionnel 3
CVTTOUCS	Convertir en UCS-2	YES, NO	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, *BLANK	Facultatif

Nom de la table (TBL)

Indique le nom qualifié de la table dont le source est extrait.

Fichier source (SRCFILE)

Indique le nom qualifié du fichier base de données source préalablement créé et dans lequel le source de la table est écrit.

Le nom du fichier source peut être qualifié de l'une des valeurs de bibliothèques suivantes :

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques du travail jusqu'à ce que la première occurrence soit trouvée.
*CURLIB: La recherche porte sur la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.
nom-bibliothèque: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Membre source (SRCMBR)

Indique le nom du membre du fichier base de données source dans lequel le source de la table est écrit. S'il n'est pas indiqué, le nom de la table est défini par défaut. Si le membre existait avant l'exécution de la commande, il est mis à blanc avant l'écriture des instructions source. Dans le cas contraire, il est créé.

Les valeurs possibles sont les suivantes :

*TBL: Le nom de la table est utilisé comme nom du membre.
nom-membre-source: Indiquez le nom du membre de fichier source qui doit contenir le source de la table extrait.

Convertir en UCS-2 (CVTTOUCS)

Indique si le source de la table *SRTSEQ doit être converti du format de table *SRTSEQ au format *UCSSRTSEQ lors de son placement dans le fichier. Activez cette option pour créer une table *UCSSRTSEQ basée sur une table *SRTSEQ existante.

Les valeurs possibles sont les suivantes :

*NO: Les informations ne sont pas converties lorsqu'elles sont placées dans le fichier.
*YES: Les informations sont converties lorsqu'elles sont placées dans le fichier.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*BLANK: Aucun texte n'est indiqué.
'descriptif': Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Exemples

RTVTBLSRC   TBL(QSYS/TABLE1)  SRCFILE(TBLSRC)  SRCMBR(TABLEOUT)
            CVTTOUCS(*NO)

Cette commande permet de récupérer les instructions source depuis la table TABLE1 dans la bibliothèque QSYS. La source récupérée est placée dans le fichier TBLSRC et est nommée comme membre TABLEOUT mais pas convertie vers un format *UCSSRTSEQ.

Messages d'erreur

Unknown