DIAGNOSTICS_STATISTICS section of the DFSDFxxx member

Parameters

IASNPROC=membername

Specifies a 1- to 8-character name of the IMS abend search and notification procedure. The IMS abend search and notification function is enabled only if the IASNPROC parameter is specified and defines a member name; otherwise, it is disabled.

MSG0826=

Specifies which forms of the DFS826I message are issued or suppressed.

ISSUE

All forms of the message can be issued. ISSUE is the default.

SUPPBLDL

Suppresses the following forms of the message:

• DFS826I BLDL FAILED FOR FOLLOWING DBDs
• DFS826I xxx DBD ERRORS SENT TO JOB LOG

The following message is issued to indicate how many failure messages were suppressed: DFS826I xxx DBD ERRORS SUPPRESSED.

MSG0830=

Specifies which forms of the DFS830I message are issued or suppressed.

ISSUE

All forms of the message can be issued. ISSUE is the default.

SUPPBLDL

Suppresses the following forms of the message:

• DFS830I BLDL FAILED FOR FOLLOWING PSBs
• DFS830I xxx PSB ERRORS SENT TO JOB LOG

The following message is issued to indicate how many failure messages were suppressed: DFS830I xxx PSB ERRORS SUPPRESSED.

MSG2291=

Specifies whether the DFS2291I message is issued or suppressed.

SUPPRESS

Suppresses the message DFS2291I from being issued by IMS. SUPPRESS is the default.

SHORT

IMS can issue one single segment message DFS2291I with information about the blocker only.

ISSUE

IMS can issue the message DFS2291I.

MSG2500=

Specifies whether the dynamic allocation and deallocation message DFS2500I is issued or suppressed when an UPDATE DB command is issued for HALDBs.

SUPPRESS

Suppresses dynamic allocation and deallocation message DFS2500I from being issued by IMS for HALDB partitions. SUPPRESS is the default.

ISSUE

IMS can issue the dynamic allocation and deallocation message DFS2500I for HALDB partitions.

TRANSTAT=

Specifies whether transaction level statistics are logged. If Y is specified, transaction level statistics are written to the log in an X'56FA' log record.

The value specified for this parameter is taken into consideration when IMS is cold started and transaction and program definitions are created from definitions contained in the MODBLKS data set or when creating new programs and transactions by using the CREATE PGM and CREATE TRAN commands and the TRANSTAT value for the new resource is obtained from the system default descriptor.

The TRANSTAT= parameter is ignored when transaction and program definitions are created from definitions imported from an RDDS or the IMSRSC repository.

N

Transaction-level statistics are not logged for all transactions and all programs. Transaction-level statistics can be logged for individual transactions or programs by defining the APPLCTN macro or TRANSACT macro with TRANSTAT=Y, or issuing an UPDATE PGM command or UPDATE TRAN command. N is the default.

Y

Transaction-level statistics are logged for all transactions and all programs, regardless of the transaction statistics value defined with the APPLCTN macro or TRANSACT macro. An UPDATE PGM command or UPDATE TRAN command can be issued to reset the TRANSTAT value to N for a particular transaction or program.

If dynamic resource definition (DRD) is enabled and resource definitions are imported from an RDDS or the IMSRSC repository during cold start, the UPDATE TRAN NAME(*) SET(TRANSTAT(Y)) and UPDATE PGM NAME(*) SET(TRANSTAT(Y)) commands can be used to turn on transaction level statistics for all programs and transactions once IMS is up. To ensure that the updated TRANSTAT values persist across a cold start, all resource and descriptor definitions should be exported to a system RDDS or the repository.

TRCLEV

Activates a type-2 trace table at IMS initialization. If a particular trace table is not specified with a TRCLEV parameter, the default values for that trace table are used.

NAME

Specifies the 1-4 character type-2 trace table name. Each trace table is specified with a 1-4 character name that refers to the type of events that are traced into that table. Valid trace table names are as follows:

DDL

The DDL trace table traces DDL events within IMS. The default trace level is NONE. The default number of pages is 8. The DDL trace table resides in extended common storage (ECSA).

ERR

The error trace table traces error events within IMS. The default trace level is HIGH. The default number of pages is 8. The ERR trace table resides in ECSA.

TRCE

The trace services trace table traces IMS trace services events. The default trace level is NONE. The default number of pages is 8. The TRCE trace table resides in ECSA.

USRX

The USRX trace table traces IMS User Exit services. The default trace level is NONE. The default number of pages is 6. The USRX trace table resides in ECSA.

All type-2 trace tables can be activated for the following environments:

• Batch
• DB/DC
• DBCTL
• DCCTL
• FDBR
• XRF alternate

If you attempt to activate a trace in an environment that does not support that trace type, IMS ignores the request.

LEVEL

Specifies the volume of tracing for this trace table. Each trace entry has an associated level. Each trace table has a level setting that is controlled by what is specified in the LEVEL parameter or the UPDATE TRACE command for the table.

A trace entry is written only if the trace entry level is less than or equal to the current level of the trace table. For example, if the trace entry is MEDIUM, the entry is only written if the trace table level is MEDIUM or HIGH. Thus, the specified level controls the volume (number) of trace entries that are written to a given table.

A level setting of LOW will result in fewer entries written to the trace table. This results in a smaller performance impact, but provides less detailed diagnostic information.

A level setting of HIGH will result in more entries being written to the trace table. This can result in a higher impact on CPU usage but will provide a higher level of diagnostic information.

Valid levels are as follows:

NONE

No trace entries are written

ERROR

Only trace entries for error conditions are written.

LOW

Low volume tracing.

MEDIUM

Medium volume tracing.

HIGH

High volume tracing.

The default trace level for type-2 trace tables is NONE, except for ERR trace tables, which is always set to a level of HIGH.

PAGES

An optional parameter that can be used to specify the number of 4 KB pages that are allocated for the trace table type. Specify a value in the range 1 - 32767 pages for this parameter. If you do not use this parameter, the default number of pages for the trace table type is allocated.

Specifying a larger number of pages allows more trace entries to be stored before the table wraps, if it is not being written out, or reduces the chances of entries being skipped, if the table is being written externally. However, the more pages that are requested, the more storage is used. If the table is allocated in ECSA, this setting can have an impact on ECSA usage. For a table that is allocated in ECSA, ensure that you have sufficient ECSA storage available on your system before you specify a large number for the PAGES parameter. This prevents serious system problems if you run out of ECSA.