Save Performance Collection (SAVPFRCOL)

The Save Performance Collection (SAVPFRCOL) command saves a copy of a single performance collection or a group of performance collections located in the same library.

Restrictions:

Parameters

Keyword Description Choices Notes
COL Collection Single values: *SELECT, *ALL
Other values (up to 300 repetitions): Generic name, name
Optional, Positional 1
LIB 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
TGTRLS Target release Character value, *CURRENT, *PRV Optional
DTACPR Data compression *NO, *YES, *LOW, *MEDIUM, *HIGH Optional

Collection (COL)

Specifies the names of one or more performance collections or the generic name of each group of performance collections to be saved. All the performance collections must be in the library specified for the Library (LIB) parameter. If *ALL is specified or defaulted for the Collection type (COLTYPE) parameter, all the collection types listed in the description of that parameter are saved, provided they are in the specified library and have the specified names.

Single values

*SELECT
Lists all performance collections available in the specified library so you can select them to save.

Note: This value is valid only in an interactive environment.

*ALL
All the performance collections in the specified library are saved, depending on the values specified for the Collection type (COLTYPE) parameter.

Other values (up to 300 repetitions)

generic-name
Specify one or more generic names of groups of performance collections in the specified library to be saved. 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 be saved. Both generic names and specific names can be specified in the same command.

Library (LIB)

Specifies which library contains the performance collections to be saved.

QPFRDATA
The performance collections to be saved are located in the IBM-supplied performance library, QPFRDATA.
name
Specify the name of the library where the performance collections are located.

Collection type (COLTYPE)

Specifies the type of collection to be saved.

Single values

*ALL
All types of performance collections that are specified by name and are in the specified library are saved. This includes file-based collections and object-based collections. If *ALL is also specified for the Collection (COL) parameter, all the performance collections in the library that are of the types that can be saved are saved.

Other values (up to 10 repetitions)

*CSFILE
Only the Collection Services file-based collections specified in the Collection (COL) parameter are to be saved.
*CSMGTCOL
Only the Collection Services object-based collections specified in the Collection (COL) parameter are to be saved.
*DWFILE
Only the Disk Watcher file-based collections specified in the Collection (COL) parameter are to be saved.
*JWFILE
Only the Job Watcher file-based collections specified in the Collection (COL) parameter are to be saved.
*PEXFILE
Only the Performance Explorer file-based collections specified in the Collection (COL) parameter are to be saved.
*PEXMGTCOL
Only the Performance Explorer object-based collections specified in the Collection (COL) parameter are to be saved.
*BCHFILE
Start of change
Only the Batch Model file-based collections specified in the Collection (COL) parameter are to be saved.
*HSTFILE
Only the Historical file-based collections specified in the Collection (COL) parameter are to be saved.End of change
type
Specify the type of collections to be saved.

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 that is used to contain the saved data. 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.

Target release (TGTRLS)

Specifies the release of the operating system on which you intend to restore and use the performance collections.

When specifying the target-release value, the format VxRxMx is used to specify the release, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V5R3M0 is version 5, release 3, modification 0.

Valid values depend on the current version, release, and modification level of the operating system, and they change with each new release. You can press F4 while prompting this command parameter to see a list of valid target release values.

*CURRENT
The performance collections are to be restored to, and used on, the release of the operating system currently running on your system. The performance collections can also be restored to a system with any subsequent release of the operating system installed.
*PRV
The performance collections are to be restored to the previous release with modification level 0 of the operating system. The performance collections can also be restored to a system with any subsequent release of the operating system installed.
character-value
Specify the release in the format VxRxMx. The object can be restored to a system with the specified release or with any subsequent release of the operating system installed.

Data compression (DTACPR)

Specifies whether data compression is used. If the save is running while other jobs on the system are active and software compression is used, the overall system performance may be affected.

*NO
No data compression is performed.
*YES
Software compression is performed. Low software compression is used.
*LOW
Software data compression is performed with the SNA algorithm. Low compression is usually faster and the compressed data is usually larger than if medium or high compression is used.
*MEDIUM
Software data compression is performed with the TERSE algorithm. Medium compression is usually slower than low compression but faster than high compression. The compressed data is usually smaller than if low compression is used and larger than if high compression is used.
*HIGH
Software data compression is performed with the LZ1 algorithm. High compression is usually slower and the compressed data is usually smaller than if low or medium compression is used.

Examples

Example 1: Saving Performance Collections

SAVPFRCOL  COL(TEST1 TEST2)

This command save performance collections TEST1 and TEST2 from the IBM-supplied performance library QPFRDATA. This command runs interactively while the user waits.

Error messages

*ESCAPE Messages

CPFC763
Performance collection &2 of type &3 in library &1 does not exist.
CPF3730
Not authorized to &2 &1 in library &3.
CPF3731
Cannot use &2 &1 in library &3.
CPF3733
&2 &1 in &3 previously damaged.
CPF3735
Storage limit exceeded for user profile &1.
CPF3781
Library &1 not found.
CPF3812
Save file &1 in &2 in use.
CPF9820
Not authorized to use library &1.