Move Performance Collection (MOVPFRCOL)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Move Performance Collection (MOVPFRCOL) command moves a performance collection from one library to another.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| FROMCOL | From collection | Name, *SELECT | Optional, Positional 1 |
| FROMLIB | From library | Name, QPFRDATA | Optional, Positional 2 |
| TOCOL | To collection | Name, *FROMCOL | Optional |
| TOLIB | To library | Name, *FROMLIB | Optional |
| COLTYPE | Collection type |  Single values: *ALLOther values (up to 10 repetitions): Character value, *CSFILE, *CSMGTCOL, *DWFILE, *JWFILE, *PEXFILE, *PEXMGTCOL, *BCHFILE, *HSTFILE  |
Optional |
| Top |
From collection (FROMCOL)
Specifies the performance collection to be moved.
- *SELECT
- Lists all collections available in the specified library that match the indicated collection type in the Collection type (COLTYPE) parameter so the user can select performance collections to move.
Note: This value is valid only when the job that moves the performance collection is submitted interactively.
- name
- Specify the performance collection to be moved.
| Top |
From library (FROMLIB)
Specifies the library where the performance collections are located.
- QPFRDATA
- The IBM-supplied performance data library, QPFRDATA, is where the performance collections are located.
- name
- Specify the name of the library where the performance collections are located.
| Top |
To collection (TOCOL)
Specifies the name of the performance collection to which the performance data is moved.
- *FROMCOL
- The new performance collection has the same name as the one located in the From collection (FROMCOL) parameter. If this is specified, the new performance collection and original performance collection must reside in different libraries.
- name
- Specify the name of the performance collection to which the performance data is moved.
| Top |
To library (TOLIB)
Specifies the library in which the new performance collection is kept.
- *FROMLIB
- The performance collection is renamed using the value in the To collection (TOCOL) parameter and kept in the same library. This value is valid only when the values in the From collection (FROMCOL) parameter and To collection (TOCOL) parameter are different.
- name
- Specify the name of the library in which the new performance collection is kept.
| Top |
Collection type (COLTYPE)
Specifies the type of collection to be moved.
Single values
- *ALL
- All types of performance collections with the same name as the one located in the From collection (FROMCOL) parameter are to be moved. This includes file-based collections and object-based collections.
Other values (up to 10 repetitions)
- *CSFILE
- Only the Collection Services file-based collections specified in the From collection (FROMCOL) parameter are to be moved.
- *CSMGTCOL
- Only the Collection Services object-based collections specified in the From collection (FROMCOL) parameter are to be moved.
- *DWFILE
- Only the Disk Watcher file-based collections specified in the From collection (FROMCOL) parameter are to be moved.
- *JWFILE
- Only the Job Watcher file-based collections specified in the From collection (FROMCOL) parameter are to be moved.
- *PEXFILE
- Only the Performance Explorer file-based collections specified in the From collection (FROMCOL) parameter are to be moved.
- *PEXMGTCOL
- Only the Performance Explorer object-based collections specified in the From collection (FROMCOL) parameter are to be moved.
- *BCHFILE
- Only the Batch Model file-based collections specified in the From collection (FROMCOL) parameter are to be moved.
- *HSTFILE
- Only the Historical file-based collections specified in the From collection (FROMCOL) parameter are to be moved.
- type
- Specify the type of collections to be moved.
Valid values depend on the performance collections supported by the system. You can press F4 while prompting this command parameter to see a list of valid collection type values.
| Top |
Examples
Example 1: Showing List of Performance Collections
MOVPFRCOL
This command shows a display for selecting from all of the performance collections in the QPFRDATA library. From this list, the user can select performance collections to move.
Example 2: Moving Data
MOVPFRCOL FROMCOL(COL1) TOLIB(NEWLIB)
This command moves performance collection COL1 in library QPFRDATA to library NEWLIB. The new copy in library NEWLIB keeps the name COL1.
| Top |
Error messages
*ESCAPE Messages
- CPFC731
- Cannot copy/move performance collection &2.
- CPFC736
- No performance collections copied/moved from library &1.
| Top |