CRTFCNARA

Créer zone fonctionnelle

Create Functional Area

En bref

La commande Créer domaine fonctionnel (CRTFCNARA) permet de créer des domaines fonctionnels sur votre système. The Create Functional Area (CRTFCNARA) command allows you to create functional areas on your system.

CRTFCNARA se lit CRT (Créer) + FCNARA. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CRTFCNARA 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 CRTFCNARA 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 Créer domaine fonctionnel (CRTFCNARA) permet de créer des domaines fonctionnels sur votre système. Les domaines fonctionnels sont utilisés par les outils de performances pour les rapports et les graphiques. Un domaine fonctionnel est une liste prédéfinie de noms de travaux et/ou de noms d'utilisateurs à inclure dans un rapport ou un graphique. The Create Functional Area (CRTFCNARA) command allows you to create 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, positionnel 1
LIB	BibliothèqueLibrary	Nom, QPFRDATA	Facultatif, positionnel 2
TEXT	Texte 'description'Text 'description'	Valeur caractère, *BLANK	Facultatif
JOB	Nom du travailJob name	Valeurs uniques: 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.

*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 un domaine fonctionnel. Un identificateur de travail est soit la valeur spéciale *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 *NONE or a qualified name with up to two elements, for example:

*NONE
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.

*NONE: Un domaine fonctionnel vide est créé. An empty functional area is created.
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 le domaine fonctionnel. Il peut s'agir d'un nom spécifique ou générique. Specify the name of the user to include in the functional area. This can be either a specific or generic name.

Exemples

Exemple 1 : Création d'un domaine fonctionnel dans la bibliothèque par défaut Example 1: Creating a Functional Area in the Default Library

CRTFCNARA   FCNARA(PERSONNEL)  JOB(MIKE/*N  ROSS/*N  QPFR*)

Cette commande crée le domaine fonctionnel PERSONNEL avec trois entrées : This command creates the functional area PERSONNEL with three entries:

L'utilisateur MIKE The user MIKE
L'utilisateur ROSS The user ROSS
Tout travail dont le nom commence par QPFR Any job beginning with QPFR

Le domaine fonctionnel est créé dans la bibliothèque QPFRDATA. The functional area is created in the QPFRDATA library.

Exemple 2 : Création d'un domaine fonctionnel dans une bibliothèque indiquée Example 2: Creating a Functional Area in a Specified Library

CRTFCNARA   FCNARA('Performance Tools')  LIB(RPFT)
            JOB(TODD/*N  MARTY/*N  DEB/QPFRMON)

Cette commande crée le domaine fonctionnel 'Performance Tools' avec trois entrées : This command creates the functional area 'Performance Tools' with three entries:

L'utilisateur TODD The user TODD
L'utilisateur MARTY The user MARTY
Tout travail QPFRMON soumis par DEB Any QPFRMON job submitted by DEB

Le domaine fonctionnel est créé dans la bibliothèque RPFT. The functional area is created in the RPFT library.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

PFR9063: Impossible de créer le domaine fonctionnel &2. Cannot create functional area &2.