Maintain parameter data sets

This menu option navigates to the Data Set Maintenance menu, where you can maintain exception thresholds, correlation translations, time zone information, and MAINPACK definitions.

If this option is selected, the following menu is displayed:


                         Data Set Maintenance Menu                              
                                                                                
 Select one of the following.                                                   
                                                                                
    1. Maintain exception thresholds                                            
    2. Maintain correlation translations                                        
    3. Maintain time zone information                                           
    4. Maintain MAINPACK definitions                                            
                                                                                
 Exception data set                                                             
______________________________________________________________                  
                                                                                
 DPMPARMS data set                                                              
______________________________________________________________                  
                                                                                
 Command ===>                                                                   
  F1=Help      F2=Split     F3=Exit      F6=History   F9=Swap     F12=Cancel

On this menu, you can customize certain Db2 monitoring parameters by modifying parameters in an Exception Threshold data set and in defined members of the DPMPARMS data set. These data sets must be allocated before they can be edited.

Maintain exception thresholds

Use this option to edit exception thresholds in the Exception Threshold data set.

Exception reporting identifies Db2 threads and statistics intervals that have fields with values outside the thresholds specified in the Exception Threshold data set. Exception processing is available in batch Accounting and Statistics report sets and in the Online Monitor thread and statistics functions.

Maintain correlation translations

Use this option to edit correlation translation data in the CORRDATA member of the DPMPARMS data set.

The correlation ID is a 12-byte field within the Db2 correlation header of the instrumentation trace records that is used to identify the task being executed by Db2.

The correlation ID contains different information about the task depending on the type of connection. For this reason, OMEGAMON® XE for Db2 PE provides a correlation translation data set, which is used to divide the correlation ID into a correlation name and a correlation number as follows:

CORRNAME: Correlation name, which translates to the first eight bytes of the correlation ID.
CORRNMBR: Correlation number, which translates to the last four bytes of the correlation ID, padded out with 4 blanks.

Note: The correlation translation data set is only required for two-phase-commit environments such as CICS® and IMS.

Maintain time zone information

Use this option to edit the time zone information in the LOCDATA member of the DPMPARMS data set member.

The time zone information is used to adjust differences in the times of the data to be reported. Adjust the times if:

The CPU clock of your MVS system is not set to the local time, but you want to use the local time in your reports.
You want to generate reports or traces that show activity at more than one location and the CPU clock settings of the locations are different. This is often the case when the locations are in different time zones.

When you have entered the time zone information to the DPMPARMS data set member, you can use the TIMEZONE option of the GLOBAL command to adjust the times used in reporting.

Maintain MAINPACK definitions

Use this option to edit MAINPACK definitions in the MAINPACK member of the DPMPARMS data set member.

In the Accounting report set you can use the MAINPACK identifier to distinguish plans according to the packages they contain. You can define certain aspects of the MAINPACK identifier:

Whether the first or the last package executed within a plan is used as the MAINPACK.
Whether you want to use the package ID, the collection ID, or the location name of the package as the value of the identifier. In the case of a DBRM, the program name is always used.

You can specify different MAINPACK definitions for data from different environments and from different plans.

Exception data set

Use this field to specify the name of your Exception Threshold data set. The data set must be preallocated and cataloged before you can edit it.

To specify the data set, enter any fully qualified name by enclosing it in apostrophes. If you omit the apostrophes, your TSO prefix is appended to the data set name.

If you want to use a new Exception Threshold data set, it must be allocated using the following attributes:

DSORG: A data set organization of PS (sequential).
RECFM: A record format of VB or V.
LRECL: A record size of at least 255.
BLKSIZE: The block size must be at least 4 bytes more than LRECL.

DPMPARMS data set

Use this field to specify the name of your DPMPARMS data set. Any modifications you make to time zone specifications, correlation translation, or to the MAINPACK identifier definition are recorded in the individual members of the DPMPARMS data set.

The data set must be preallocated and cataloged before you can edit it.

To specify the data set, enter any fully qualified name by enclosing it in apostrophes. If you omit the apostrophes, your TSO prefix is appended to the data set name.

If you want to use a new DPMPARMS data set, it should be allocated using the following attributes:

DSORG: A data set organization of PO (partitioned).
RECFM: A record format of FB or F.
LRECL: A record size of 80.
BLKSIZE: A block size that can be any multiple of LRECL.