Change Functional Area (CHGFCNARA)

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.

Parameters

Keyword	Description	Choices	Notes
FCNARA	Functional area	Character value	Required, Key, Positional 1
LIB	Library	Name, QPFRDATA	Optional, Key, Positional 2
TEXT	Text 'description'	Character value, BLANK, SAME	Optional
JOB	Job name	Single values: SAME, 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.

Text 'description' (TEXT)

Specifies text that briefly describes the functional area.

*SAME: The text does not change.
*BLANK: No text is specified.
description: Specify no more than 30 characters of text, enclosed in apostrophes.

Job name (JOB)

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 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: The jobs do not change.
*NONE: The functional area is cleared of all jobs.
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 user to include in the functional area. This can be either a specific or generic name.

Examples

Example 1: Changing Functional Area to Three Entries

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

This command changes the functional area PERSONNEL to three entries:

The user DAN.
The user MARCY.
Any job beginning with QPG submitted by RANDY.

The functional area is changed in the QPFRDATA library.

Example 2: Changing Functional Area to Four Entries

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

This command changes the functional area 'Performance Tools' to four entries:

Any job beginning with PRT.
The user TERESA.
The user KAREN.
Any QPFRXXX job submitted by JIM.

The functional area is created in library RPFT.