CHGFCNARA

Modifier zone fonctionnelle

Change Functional Area

En bref

La commande Modification de zone fonctionnelle (CHGFCNARA) permet de modifier les zones fonctionnelles de votre système. The Change Functional Area (CHGFCNARA) command allows you to change functional areas on your system.

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

Syntaxe minimale

CHGFCNARA FCNARA(…)

Paramètres

FCNARA Zone fonctionnelle Functional area obligatoire
LIB Bibliothèque Library
TEXT Texte 'description' Text 'description'
JOB Nom du travail Job name

Astuce : dans une session 5250, tapez CHGFCNARA 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 Modification de zone fonctionnelle (CHGFCNARA) permet de modifier les zones fonctionnelles de votre système. Les zones fonctionnelles sont utilisées par les outils de performance pour les rapports et les graphiques. Une zone fonctionnelle est une liste prédéfinie de noms de travaux et/ou de noms d'utilisateurs à inclure dans un rapport ou un graphique. The Change Functional Area (CHGFCNARA) command allows you to change functional areas on your system. Functional areas are used by performance tools for reports and graphics. A functional area is a pre-defined list of job names and/or user names that are to be included in a report or graph.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FCNARA	Zone fonctionnelleFunctional area	Valeur caractère	Obligatoire, clé, positionnel 1
LIB	BibliothèqueLibrary	Nom, QPFRDATA	Facultatif, clé, positionnel 2
TEXT	Texte 'description'Text 'description'	Valeur caractère, BLANK, SAME	Facultatif
JOB	Nom du travailJob name	Valeurs uniques: SAME, NONE Autres valeurs (jusqu'à 250 répétitions): Nom d'objet qualifié	Facultatif
	Qualificatif 1 : Nom du travailQualificatif 1: Job name	Nom générique, nom
	Qualificatif 2 : UtilisateurQualificatif 2: User	Nom générique, nom

Zone fonctionnelle (FCNARA)Functional area (FCNARA)

Indique le nom de la zone fonctionnelle à créer ou à modifier. Placez le nom entre apostrophes s'il contient des espaces entre les caractères. Specifies the name of the functional area to be created or changed. Enclose the name in apostrophes if it contains any spaces between characters.

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

Bibliothèque (LIB)Library (LIB)

Indique la bibliothèque où se trouve la zone fonctionnelle. Specifies the library where the functional area is located.

QPFRDATA: La zone fonctionnelle se trouve dans la bibliothèque de données de performance fournie par IBM, QPFRDATA. The IBM-supplied performance data library, QPFRDATA, is where the functional area is located.
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.

Texte 'description' (TEXT)Text 'description' (TEXT)

Indique un texte qui décrit brièvement la zone fonctionnelle. Specifies text that briefly describes the functional area.

*SAME: Le texte ne change pas. The text does not change.
*BLANK: Aucun texte n'est indiqué. No text is specified.
description: Indiquez un texte de 30 caractères maximum, placé entre apostrophes. Specify no more than 30 characters of text, enclosed in apostrophes.

Nom du travail (JOB)Job name (JOB)

Indique une liste de travaux à inclure dans une zone fonctionnelle. Un identificateur de travail est soit la valeur spéciale *SAME ou *NONE, soit un nom qualifié comportant jusqu'à deux éléments, par exemple : Specifies a list of jobs to include in a functional area. A job identifier is either the special value *SAME, *NONE, or a qualified name with up to two elements, for example:

*SAME
job-name
user-name/job-name

*N peut être utilisé à la place d'un élément qui suit les valeurs indiquées. Par exemple, USER1/*N indique le nom d'utilisateur USER1, quel que soit le nom du travail. Sans *N, USER1 aurait été interprété comme le nom du travail et non comme le nom d'utilisateur. *N may be used in place of an element that follows the values being specified. For example, USER1/*N specifies the user name USER1, regardless of the job name. Without specifying *N, USER1 would have been interpreted as the job name, not the user name.

*SAME: Les travaux ne changent pas. The jobs do not change.
*NONE: La zone fonctionnelle est vidée de tous ses travaux. The functional area is cleared of all jobs.
job-name: Indiquez le nom du travail à inclure dans la zone fonctionnelle. Il peut s'agir d'un nom spécifique ou générique. Specify the name of the job to include in the functional area. This can be either a specific or generic name.
user-name: Indiquez le nom de l'utilisateur à inclure dans la zone fonctionnelle. Il peut s'agir d'un nom spécifique ou générique. Specify the name of user to include in the functional area. This can be either a specific or generic name.

Exemples

Exemple 1 : Modification d'une zone fonctionnelle pour lui donner trois entrées Example 1: Changing Functional Area to Three Entries

CHGFCNARA   FCNARA(PERSONNEL)  JOB(DAN/*N  MARCY/*N  RANDY/QPG*)

Cette commande modifie la zone fonctionnelle PERSONNEL pour lui donner trois entrées : This command changes the functional area PERSONNEL to three entries:

L'utilisateur DAN. The user DAN.
L'utilisateur MARCY. The user MARCY.
Tout travail commençant par QPG soumis par RANDY. Any job beginning with QPG submitted by RANDY.

La zone fonctionnelle est modifiée dans la bibliothèque QPFRDATA. The functional area is changed in the QPFRDATA library.

Exemple 2 : Modification d'une zone fonctionnelle pour lui donner quatre entrées Example 2: Changing Functional Area to Four Entries

CHGFCNARA   FCNARA('Performance Tools')  LIB(RPFT)
            JOB(PRT*  TERESA/*N  KAREN/*N  JIM/QPFRXXX)

Cette commande modifie la zone fonctionnelle 'Performance Tools' pour lui donner quatre entrées : This command changes the functional area 'Performance Tools' to four entries:

Tout travail commençant par PRT. Any job beginning with PRT.
L'utilisateur TERESA. The user TERESA.
L'utilisateur KAREN. The user KAREN.
Tout travail QPFRXXX soumis par JIM. Any QPFRXXX job submitted by JIM.

La zone fonctionnelle est créée dans la bibliothèque RPFT. The functional area is created in library RPFT.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF0011: Erreur détectée par le programme de remplacement d'invite. Error detected by prompt override program.
PFR9064: Impossible de modifier la zone fonctionnelle &2. Cannot change functional area &2.