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.

Parameters

Keyword	Description	Choices	Notes
FROMFCNARA	From functional area	Character value	Required, Positional 1
FROMLIB	From library	Name, QPFRDATA	Optional, Positional 2
TOFCNARA	To functional area	Character value, *FROMFCNARA	Optional, Positional 3
TOLIB	To library	Name, *FROMLIB	Optional, Positional 4
REPLACE	Replace	*NO, *YES	Optional

Top

From functional area (FROMFCNARA)

Specifies the name of the functional area from which to copy. Enclose the name in apostrophes if it contains any spaces between characters.

This is a required parameter.

From library (FROMLIB)

Specifies the location of the functional area to be copied.

The possible library values are:

QPFRDATA

The IBM-supplied performance data library, QPFRDATA, is the location of the functional area.

library-name

Specify the name of the library where the functional area is located.

To functional area (TOFCNARA)

Specifies the name of the functional area to which the copy is sent.

The possible library values are:

FROMFCNARA

The name specified on the FROMFCNARA parameter is used.

functional-area-name

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.

To library (TOLIB)

Specifies the library to which the copy of the functional area is sent.

The possible library values are:

*FROMLIB

The functional area is copied to the library specified on the FROMLIB parameter.

library-name

Specify the name of the library to which functional area is copied.

Replace (REPLACE)

Specifies whether to replace the functional area in the To functional area prompt (TOFCNARA parameter) if the functional area already exists.

*NO

The existing functional area is not replaced with the new functional area.

*YES

The existing functional area is replaced with the new functional area.

Examples

Example 1: Copying in the Same Library

CPYFCNARA   FROMFCNARA(PERSONNEL)  TOFCNARA(MIKE)

This command copies the functional area PERSONNEL to the functional area MIKE. Both functional areas are in the QPFRDATA library.

Example 2: Copying to a Different Library

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

This command copies the functional area 'Performance Tools' to the functional area MIKE in library USRLIB.

Error messages

*ESCAPE Messages

PFR9062

Value for TOFCNARA parameter must be specified.

PFR9065

Cannot copy functional area &2.

PFR9066

Cannot copy to functional area &2.