Create Functional Area (CRTFCNARA)

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.

Parameters

Keyword	Description	Choices	Notes
FCNARA	Functional area	Character value	Required, Positional 1
LIB	Library	Name, QPFRDATA	Optional, Positional 2
TEXT	Text 'description'	Character value, *BLANK	Optional
JOB	Job name	Single values: NONE Other values (up to 250 repetitions): Qualified object name*	Optional
	Qualifier 1: Job name	Generic name, name
	Qualifier 2: User	Generic name, name

Top

Functional area (FCNARA)

Specifies the name of the functional area to be created or changed. Enclose the name in apostrophes if it contains any spaces between characters.

This is a required parameter.

Library (LIB)

Specifies the library where the functional area is located.

QPFRDATA: The IBM-supplied performance data library, QPFRDATA, is where the functional area is located.
library-name: Specify the name of the library where the functional area is located.

Job name (JOB)

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 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: An empty functional area is created.
job-name: Specify the name of the job to include in the functional area. This can be either a specific or generic name.
user-name: Specify the name of the user to include in the functional area. This can be either a specific or generic name.

Examples

Example 1: Creating a Functional Area in the Default Library

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

This command creates the functional area PERSONNEL with three entries:

The user MIKE
The user ROSS
Any job beginning with QPFR

The functional area is created in the QPFRDATA library.

Example 2: Creating a Functional Area in a Specified Library

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

This command creates the functional area 'Performance Tools' with three entries:

The user TODD
The user MARTY
Any QPFRMON job submitted by DEB

The functional area is created in the RPFT library.