Restore Performance Collection (RSTPFRCOL)
The Restore Performance Collection (RSTPFRCOL) command restores to the system a performance collection or a group of performance collections in a single library that were saved in a save file with the Save Performance Collection (SAVPFRCOL) command.
Restrictions:
- This command is shipped with no public authority (*EXCLUDE).
- You must have add (*ADD) and execute (*EXECUTE) authorities for the specified library and save file library.
| Keyword |
Description |
Choices |
Notes |
| COL |
Collection |
Single values: *ALL Other values (up to 300 repetitions): Generic name, name |
Required, Positional 1 |
| SAVLIB |
Saved library |
Name, QPFRDATA |
Optional |
| COLTYPE |
Collection type |
Single values: *ALL Other values (up to 10 repetitions): Character value, *CSFILE, *CSMGTCOL, *DWFILE, *JWFILE, *PEXFILE, *PEXMGTCOL |
Optional |
| SAVF |
Save file |
Qualified object name |
Optional |
| Qualifier 1: Save file |
Name |
| Qualifier 2: Library |
Name, *LIBL, *CURLIB |
| RSTLIB |
Restore to library |
Name, *SAVLIB |
Optional |
Collection (COL)
Specifies the names of one or more performance collections to restore.
If the save file does not contain all of the performance collections you specify, diagnostic messages will be issued for the performance collections not found. The completion message will contain a count of performance collections restored and performance collections not restored.
If the Collection type (COLTYPE) parameter is not specified when the command is run, all the collection types listed in the description of that parameter are restored, if they are in the specified library on the save file, and if they have the specified names.
This is a required parameter.
Single values
-
- *ALL
- All the performance collections saved from the specified library are restored, depending on the values specified for the Collection type (COLTYPE) and Option (OPTION) parameters.
Other values (up to 300 repetitions)
-
- generic-name
- Specify one or more generic names of groups of performance collections in the specified library to restore. A generic name is a character string that contains one or more characters followed by an asterisk (*). If an asterisk is not specified with the name, the system assumes that the name is a complete performance collection name.
- name
- Specify one or more names of specific performance collections to restore. Both generic names and specific names can be specified in the same command.
Saved library (SAVLIB)
Specifies the library that contained the saved performance collections. If *SAVLIB is specified or defaulted for the Restore to library (RSTLIB) parameter, this is also the name of the library to which the performance collections are restored.
-
- QPFRDATA
- The saved performance collections were located in the IBM-supplied performance library, QPFRDATA.
- name
- Specify the name of the library to restore. The name of the library being restored must be the same as the name that was used when the library was saved.
Collection type (COLTYPE)
Specifies the type of collections to be restored.
Single values
-
- *ALL
- All types of performance collections with the same name as the one located in the Collection (COL) parameter are to be restored. 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 Collection (COL) parameter are to be restored.
- *CSMGTCOL
- Only the Collection Services object-based collections specified in the Collection (COL) parameter are to be restored.
- *DWFILE
- Only the Disk Watcher file-based collections specified in the Collection (COL) parameter are to be restored.
- *JWFILE
- Only the Job Watcher file-based collections specified in the Collection (COL) parameter are to be restored.
- *PEXFILE
- Only the Performance Explorer file-based collections specified in the Collection (COL) parameter are to be restored.
- *PEXMGTCOL
- Only the Performance Explorer object-based collections specified in the Collection (COL) parameter are to be restored.
- type
- Specify the type of collections to be restored.
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.
Save file (SAVF)
Specifies the save file used to restore the performance collections. This is a required parameter.
Qualifier 1: Save file
-
- name
- Specify the name of save file to be used.
Qualifier 2: Library
-
- *LIBL
- All libraries in the library list for the current thread are searched until the first match is found.
- *CURLIB
- The current library for the thread is used to locate the save file. If no current library entry exists in the library list, the QGPL library is used.
- name
- Specify the name of the library where the save file is located.
Restore to library (RSTLIB)
Specifies whether the performance collections are restored to a different library or to the same library where they were saved.
-
- *SAVLIB
- The performance collections are restored to the same library from which they were saved.
- name
- Specify the name of the library to which the saved performance collections are restored.
Example 1: Restoring all types of Performance Collections
RSTPFRCOL COL(PFRCOL) COLTYPE(*ALL)
SAVF(QGPL/MYSAVF)
This command restores to the IBM-supplied performance data library, QPFRDATA, all the performance collections with name PFRCOL. The save file MYSAVF in library QGPL is used to restore to the system the performance collection.
*ESCAPE Messages
- CPF3706
- &2 &1 not restored to library &3.
- CPF3707
- Save file &1 in &2 contains no data.
- CPF3730
- Not authorized to &2 &1 in library &3.
- CPF3731
- Cannot use &2 &1 in library &3.
- CPF3733
- &2 &1 in &3 previously damaged.
- CPF3739
- Database file &1 member in &3 damaged.
- CPF3743
- File cannot be restored, displayed, or listed.
- CPF3748
- Object information for library &1 damaged.
- CPF3770
- No objects saved or restored for library &1.
- CPF3773
- &1 objects restored. &2 not restored to &4.
- CPF3780
- Specified file for library &1 not found.
- CPF3781
- Library &1 not found.
- CPF3782
- File &1 in &2 not a save file.
- CPF3794
- Save or restore operation ended unsuccessfully.
- CPF3796
- Storage limit exceeded for user profile &4.
- CPF37B8
- Not authorized to restore private authorities.
- CPF3805
- Objects from save file &1 in &2 not restored.
- CPF3812
- Save file &1 in &2 in use.
- CPF384F
- &2 &1 not restored to library &3.