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:

• This command is shipped with no public authority (*EXCLUDE).
• You must either have save system (*SAVSYS) special authority or the following object authorities:
  • object existence (*OBJEXIST) authority for each object to be saved.
  • execute (*EXECUTE) authority to each library objects are saved from.
• If you do not have *SAVSYS special authority, only those objects that you have authority for are saved.
• You must have *EXECUTE authority to the library where the save file is located.

Parameters

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

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.

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.