Copy Functional Area (CPYFCNARA)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |