CPYFCNARA

Copier zone fonctionnelle

Copy Functional Area

En bref

La commande Copier une zone fonctionnelle (CPYFCNARA) permet à l'utilisateur de copier une zone fonctionnelle vers une nouvelle zone fonctionnelle. The Copy Functional Area (CPYFCNARA) command allows the user to copy a functional area to a new functional area.

CPYFCNARA se lit CPY (Copier) + FCNARA. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CPYFCNARA FROMFCNARA(…)

Paramètres

FROMFCNARA Zone fonctionnelle d'origine From functional area obligatoire
FROMLIB Bibliothèque d'origine From library
TOFCNARA Zone fonctionnelle cible To functional area
TOLIB Bibliothèque cible To library
REPLACE Remplacer Replace

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

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

La commande Copier une zone fonctionnelle (CPYFCNARA) permet à l'utilisateur de copier une zone fonctionnelle vers une nouvelle zone fonctionnelle. Les zones fonctionnelles sont utilisées pour les rapports et graphiques des outils de performances. Une zone fonctionnelle est une liste prédéfinie de noms de travaux et de noms d'utilisateurs inclus dans un rapport ou un graphique. The Copy Functional Area (CPYFCNARA) command allows the user to copy a functional area to a new functional area. Functional areas are used for performance tools reports and graphics. A functional area is a pre-defined list of job names and user names that are included in a report or graph.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FROMFCNARA	Zone fonctionnelle d'origineFrom functional area	Valeur caractère	Obligatoire, positionnel 1
FROMLIB	Bibliothèque d'origineFrom library	Nom, QPFRDATA	Facultatif, positionnel 2
TOFCNARA	Zone fonctionnelle cibleTo functional area	Valeur caractère, *FROMFCNARA	Facultatif, positionnel 3
TOLIB	Bibliothèque cibleTo library	Nom, *FROMLIB	Facultatif, positionnel 4
REPLACE	RemplacerReplace	NO, YES	Facultatif

Zone fonctionnelle d'origine (FROMFCNARA)From functional area (FROMFCNARA)

Indique le nom de la zone fonctionnelle à copier. Placez le nom entre apostrophes s'il contient des espaces entre les caractères. Specifies the name of the functional area from which to copy. Enclose the name in apostrophes if it contains any spaces between characters.

Ce paramètre est obligatoire. This is a required parameter.

Bibliothèque d'origine (FROMLIB)From library (FROMLIB)

Indique l'emplacement de la zone fonctionnelle à copier. Specifies the location of the functional area to be copied.

Les valeurs de bibliothèque possibles sont les suivantes : The possible library values are:

QPFRDATA: La bibliothèque de données de performances fournie par IBM, QPFRDATA, est l'emplacement de la zone fonctionnelle. The IBM-supplied performance data library, QPFRDATA, is the location of the functional area.
nom-bibliothèque: Indiquez le nom de la bibliothèque où se trouve la zone fonctionnelle. Specify the name of the library where the functional area is located.

Zone fonctionnelle cible (TOFCNARA)To functional area (TOFCNARA)

Indique le nom de la zone fonctionnelle vers laquelle la copie est envoyée. Specifies the name of the functional area to which the copy is sent.

Les valeurs de bibliothèque possibles sont les suivantes : The possible library values are:

FROMFCNARA: Le nom indiqué dans le paramètre FROMFCNARA est utilisé. The name specified on the FROMFCNARA parameter is used.
functional-area-name: Indiquez le nom de la zone fonctionnelle vers laquelle la copie est envoyée. Placez le nom entre apostrophes s'il contient des espaces entre les caractères. Specify the name of the functional area to which the copy is sent. Enclose the name in apostrophes if it contains any spaces between characters.

Bibliothèque cible (TOLIB)To library (TOLIB)

Indique la bibliothèque vers laquelle la copie de la zone fonctionnelle est envoyée. Specifies the library to which the copy of the functional area is sent.

Les valeurs de bibliothèque possibles sont les suivantes : The possible library values are:

*FROMLIB: La zone fonctionnelle est copiée dans la bibliothèque indiquée dans le paramètre FROMLIB. The functional area is copied to the library specified on the FROMLIB parameter.
nom-bibliothèque: Indiquez le nom de la bibliothèque dans laquelle la zone fonctionnelle est copiée. Specify the name of the library to which functional area is copied.

Remplacer (REPLACE)Replace (REPLACE)

Indique s'il faut remplacer la zone fonctionnelle de l'invite Zone fonctionnelle cible (paramètre TOFCNARA) si elle existe déjà. Specifies whether to replace the functional area in the To functional area prompt (TOFCNARA parameter) if the functional area already exists.

*NO: La zone fonctionnelle existante n'est pas remplacée par la nouvelle zone fonctionnelle. The existing functional area is not replaced with the new functional area.
*YES: La zone fonctionnelle existante est remplacée par la nouvelle zone fonctionnelle. The existing functional area is replaced with the new functional area.

Exemples

Exemple 1 : Copie dans la même bibliothèque Example 1: Copying in the Same Library

CPYFCNARA   FROMFCNARA(PERSONNEL)  TOFCNARA(MIKE)

Cette commande copie la zone fonctionnelle PERSONNEL vers la zone fonctionnelle MIKE. Les deux zones fonctionnelles se trouvent dans la bibliothèque QPFRDATA. This command copies the functional area PERSONNEL to the functional area MIKE. Both functional areas are in the QPFRDATA library.

Exemple 2 : Copie vers une autre bibliothèque Example 2: Copying to a Different Library

CPYFCNARA   FROMFCNARA('Performance Tools')
            TOFCNARA(MIKE)  TOLIB(USRLIB)

Cette commande copie la zone fonctionnelle 'Performance Tools' vers la zone fonctionnelle MIKE de la bibliothèque USRLIB. This command copies the functional area 'Performance Tools' to the functional area MIKE in library USRLIB.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

PFR9062: Une valeur doit être indiquée pour le paramètre TOFCNARA. Value for TOFCNARA parameter must be specified.
PFR9065: Impossible de copier la zone fonctionnelle &2. Cannot copy functional area &2.
PFR9066: Impossible de copier vers la zone fonctionnelle &2. Cannot copy to functional area &2.