Restore Performance Collection (RSTPFRCOL)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

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:

Top

Parameters

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
Top

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

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

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.

Top

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

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

Examples

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.

Top

Error messages

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