CPYFCNARA (Copy Functional Area)

Note: To use this command, have the 5722-PT1 (Performance Tools for iSeries) licensed program installed.

CPYFCNARA Command syntax diagram

 

Purpose

The Copy Functional Area (CPYFCNARA) command allows the user to copy a functional area over 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.

 

Required Parameters

FROMFCNARA

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

 

Optional Parameters

FROMLIB

Specifies the location of the functional area to be copied.

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.

TOFCNARA

Specifies the functional area to which the copy is sent.

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

TOLIB

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

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

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

REPLACE

Specifies, if a functional area exists, whether to replace it with the functional area specified on the TOFCNARA parameter.

*NO: The functional area is not replaced with the new functional area.

*YES: The functional area is replaced with the new functional area.

Examples for CPYFCNARA

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 for CPYFCNARA

*ESCAPE Messages

PFR9062

Value for TOFCNARA parameter must be specified.

PFR9065

Cannot copy functional area &2.

PFR9066

Cannot copy to functional area &2.