ACCOUNTING command with SAVE subcommand
This section describes the ACCOUNTING command with the SAVE subcommand.
Usage
- Convert the save files to sequential data sets by using the save-file utility and load it to DB2® for subsequent use.
- Restore and combine it with newly reduced data to produce long-term reports.
- Restore it and use it in later reporting.
- Load it to DB2 for subsequent
use.Note: In contrast to the other usage, the conversion by the save-file utility is accomplished directly. VSAM data is not being produced, thus it also not possible to restore it.
You can also use the converted SAVE data sets to generate CSV (comma-separated value) input-data. This CSV data can then be transferred to workstations and imported into spreadsheets to improve DB2 performance analysis using graphical representations or pivot tables. For more information refer to Reporting User's Guide.
Usage notes
- VSAM data sets cannot be concatenated.
- For information on migration refer to Report Reference.
- You can only process VSAM data sets in the same version of OMEGAMON® for Db2 PE as they have been created. For
example, if you create a SAVE data set in version 530, it can only be RESTORED in version 530.
To use a SAVE data set in a higher version, you must migrate the SAVE data set using a migration utility.
- Before you restore or convert SAVE data sets from V5.2.0 or V5.3.0, you must first migrate this data to OMEGAMON for Db2 PE V5.4.0 format.
- Restored reports only show fields that are supported by the current version of OMEGAMON for Db2 PE.
Syntax of the SAVE subcommand
Subcommand options
The syntax diagram shows the options that are available with this subcommand. See Subcommand options for comprehensive descriptions of these options. The following list gives additional or specific descriptions of selected options, where appropriate.
- CONVERT
- Specifies that converted reduced data is written directly to a
sequential data set.
It is recommended to specify this option if you want to create high amount of loadable reduced data in a sequential data set. It avoids a temporary VSAM data set to be used as a SAVE data set. This options causes OMEGAMON for DB2 PE to write converted reduced data directly to a sequential data set in a single step. The resulting output is loadable to the PDB tables. The user may experience performance improvements compared to the default path with a separate SAVE step and the subsequent convert of saved data by the save-file utility.
Note: Not every big trace input results in big reduced data and small trace input in small reduced data. This option becomes effective when the reduction results in high amount of reduced data. For example, it depends on the amount of different criteria that results due to your filtering. It is possible that you experience more performance improvement with a small input trace that results in many different criteria than with a large trace input with only a few different criteria.This option can generally be used as it is neutral to the performance when processing only a few reduced records, but becomes effective when processing a high amount of reduced data. However, do not use this option if you want to RESTORE and REPORT saved data.
- DATATYPE
- Specifies which data types are to be written to the
VSAM or sequential data set with each record. By default, if DATATYPE
is not specified, or if DATATYPE() is specified (without keywords),
all data types are written to the reduced data set.
This subcommand option lets you improve the system performance while the VSAM or sequential data set is generated by explicitly specifying only the required data types. If performance is not critical, you can safely ignore this subcommand option. Use one or more of the following keywords to specify the required data types.
Note: Note that a later restore of partially saved data does not reconstruct the unsaved data types.- GENERAL
- General performance data. Always required for a save data set. Note that the GENERAL keyword needs to be specified explicitly.
- BP
- Buffer pool performance data
- GBP
- Group buffer pool performance data
- DDF
- Distributed Data Facility (DDF) data
- RLF
- Resource Limit Facility (RLF) data
- PACKAGE
- Package execution data
- ACCEL
- Accelerator data
- DDNAME
- Specifies the ddname where the save data is written. The default
ddname is ACSAVDD.
Without CONVERT option:
The VSAM data set defined by the default ddname must already exist when you run OMEGAMON for DB2 PE. Either specify an existing data set from a previous OMEGAMON for DB2 PE run (when restoring data), or specify a new data set allocated by using the IDCAMS DEFINE CLUSTER function.Note: If ddname is assigned to a non-VSAM file, you receive an error message and the job terminates.With CONVERT option:
The ddname needs to be assigned to a physical sequential data set. This data set can be used for a subsequent load to Accounting SAVE tables.Note: If ddname is assigned to a nonsequential data set, you receive an error message and the job terminates.
Example using SAVE
- Save aggregated Accounting data to the VSAM save data set with ddname ACSAVDD1.
⋮
ACCOUNTING
SAVE
DDNAME(ACSAVDD1)
⋮- Convert reduced Accounting data and write it to the sequential data set with ddname ACSAVDD2.
⋮
ACCOUNTING
SAVE
CONVERT
DDNAME(ACSAVDD2)
⋮