The OMEGAMON reports process OMEGAMON® XE
for CICS® (SMF
112) records to produce a detailed view of how CICS transactions use
the following types of database management system (DBMS):
- Adabas
- CA-Datacom
- CA-IDMS
- Supra
For each type of DBMS, you can request up to three reports:
- A List report, showing database usage for each transaction.
- A Transaction Summary report, showing database usage summarized
by transaction ID.
- A Database Summary report, showing database usage summarized by
database.
The information in each report varies depending on the type
of DBMS, but typically includes elapsed times and counts for each
of the methods that transactions use to access a database, such as
read, write, add, update, and delete.
To request one or more of these reports, enter line action S against
the OMEGAMON Subsystem
Report on the Report Set panel. If reports of this type have been
previously specified, the list of OMEGAMON reports
is displayed. Otherwise, the OMEGAMON panel
is displayed for you to define your first report of this type.
Figure 1. OMEGAMON Reports File Filter Edit Systems Options Help
------------------------------------------------------------------------------
SAMPLE - OMEGAMON Reports Row 1 from 1
Command ===> ________________________________________________ Scroll ===> ____
---- System Selection ----- Selection
/ Exc APPLID + Image + Group + Output Criteria
_ ________ ________ ________ OMEG0001 NO
********************************* End of list *********************************
This panel displays the list of OMEGAMON reports
in this Report Set. You can select (edit), delete, or include/exclude
any report, insert new ones, or rearrange them (move/copy).
The options are the same as those for the Performance List Reports
panel, except there is no Report Form. See Performance List report.
The line actions are the same as on similar Reports list panels.
See Performance List report.
Enter line action S to select a report in the list.
Figure 2. OMEGAMON Report File Systems Options Help
------------------------------------------------------------------------------
SAMPLE - OMEGAMON Report
Command ===> _________________________________________________________________
CICS System Selection: Report Output:
APPLID . . ________ + DDname . . . . . . . . . OMEG0001
Image . . ________ + Print Lines per Page . . ___ (1-255)
Group . . ________ +
Reports Required: Summary Options:
/ List / Average _ Total
/ Summary _ Minimum / Maximum
/ By Transaction _ Deviation
/ By Database _ Peak . . 90 (50-100%)
Statistics to include: DBMS Selection:
/ Total DBMS activity / Adabas / Supra
/ Individual Database / CA-Datacom / CA-IDMS
Report Format:
Title . . ________________________________________________________________
________________________________________________________________
Selection Criteria:
_ Performance
F1=Help F3=Exit F4=Prompt F7=Backward F8=Forward F10=Actions
F12=Cancel
Use this panel to specify report options and record selection criteria
for the OMEGAMON reports.
The only mandatory option is the Report Output DDname. You can let
the other options default.
The options are:
- CICS System Selection
- Identifies the CICS APPLID(s) whose data you want to select
for processing.
You can specify any combination of APPLID, Image,
or Group, but these must be defined in your System Definitions. If
you do not specify System Selection here or in the Global Options,
then you are prompted at run time to specify the System Selection.
This will apply globally to all reports and extracts without their
own System Selection. This is recommended as it allows you to run
your Report Sets against any of your defined Systems. Press the Prompt key
(F4) to select from a list of defined Systems, Images, or Groups.
To modify your System Definitions, select Systems in the
action bar.
Specify one of the following:
- A CICS APPLID. An APPLID that matches a defined
System's name pattern is also allowed. For example, CICSP1 can be
specified if CICSP* is a defined system.
- An APPLID and an MVS™ Image. This identifies the MVS Image
where your CICS system runs.
- An MVS Image. All CICS systems
executing on this MVS Image is selected.
- An APPLID and Image combination plus a Group. This is useful for
uniquely identifying a CICS system when there are multiple CICS systems
with the same name defined.
- A Group alone. CICS PA
will select all CICS APPLIDs defined to the Group. For example,
for transaction grouping, or for systems that connect via IRC/MRO,
ISC/APPC, or IPIC.
CICS PA uses
the System Selection in JCL generation to build the APPLID(applid1,applid2,applid3,...) and INput(SMFIN001,SMFIN002,SMFIN003,...) operands,
and corresponding //SMFINnnn DD statements.
System
Selection can also be specified either:
- In Global Options. The report-level specification takes precedence
over the global.
- At run time. The run-time System Selection overrides the Global
Options and optionally the report-level specification.
- Report Output DDname
- The DDname for the report output which CICS PA uses
when generating the JCL to run the Report Set. The DDname is mandatory
and should be unique to separate the output of multiple reports.
CICS PA assigns
a default DDname OMEGnnnn where nnnn is a sequential number 0001-9999 to
ensure each report has a unique DDname.
This option generates
the OUTPUT(ddname) operand.
- Print Lines per Page
- The maximum number of lines, including headings, to print on each
page of the report. Valid values are from 1 to 255. The default is 60.
The
global value applies to all reports. If a value is specified on this
report panel, the report value takes precedence over the global for
this report only.
CICS PA JCL
generation translates this field to the LINECount(nnn) operand.
- Reports Required
- Enter / to select the reports you want produced:
- List
- Requests the OMEGAMON List
report. This option generates the LIST operand.
- Summary
- Requests the OMEGAMON Summary
report. This option generates the SUMMARY operand.
There
are two types of Summary report:
- By Transaction
- Requests the Transaction Summary report, which groups transaction
data into sections for each transaction ID. Within each section, the
report shows the transaction data for each database accessed by that
transaction ID, followed by total figures for that transaction ID
across all databases.
This option generates the SUMMARY(TRAN) operand.
- By Database
- Requests the Database Summary report, which groups transaction
data into sections for each database. Within each section, the report
shows the transaction data for each transaction ID that has accessed
that database, followed by total figures for that database for all
transaction IDs.
This option generates the SUMMARY(DATABASE) operand.
If you select neither List nor Summary, then the
generated command will contain neither the LIST operand
nor the SUMMARY operand, and so the command will
follow its default behavior, which is to produce both types of Summary
report.
- Summary Options
- The statistical functions that the Database Summary and Transaction
Summary reports use to summarize transaction data. The options are:
average, total, minimum, maximum, standard deviation, and peak percentile.
Each option that you select produces additional rows in the reports,
with the function name as the row heading.
- Statistics to include
- Each OMEGAMON (SMF
112) record contains database usage details for a single transaction.
A transaction might use one database, or it might use multiple databases
from different types of DBMS. For each type of DBMS used by the transaction,
the record contains a "totals" segment. For each database used
by the transaction, the record contains a "detail" segment. This
option specifies whether you want the report to include information
from totals segments, details segments, or both:
- Total DBMS activity
- Includes information from totals segments. This option generates
the PRINT(TOTALS) operand.
- Individual Database
- Includes information from detail segments. This option generates
the PRINT(DB) operand.
- DBMS Selection
- The types of DBMS for which you want to produce reports.
- Title
- Title of the report. Specify up to 128 characters of text to describe
the report. CICS PA concatenates
the two lines of 64 exactly as entered to make one line which prints
at the top of each page of the report below the heading. The default
is blank (no title).
This option generates the TITLE1('left-half') and TITLE2('right-half') operands.
- Performance Selection Criteria
- You
can specify Selection Criteria to filter the OMEGAMON (SMF 112) records on time period
and field values to restrict reporting to the data that is of interest
to you.
CICS PA checks only the following
Performance Selection Criteria fields when filtering OMEGAMON records:
- APPLID
- CICS APPLID
- FILENAME
- Database (or file) name
- NETUOWPX
- Originating System VTAM network name
- START
- Task start time (see Note below)
- TASKNO
- Transaction identification number
- TRAN
- CICS transaction ID
- UOWID
- Unit of work ID
All other fields are ignored.
Note: Report Interval-based
selection for OMEGAMON XE for CICS records is limited to the Attach
(START) time; the STOP and ACTIVE options are ignored.
Line Actions:
Valid line actions are:- ⁄
- Display the menu of line actions.
- S
- Select to display the subpanel where Selection Criteria can be
specified for this report. For details, see Specifying Selection Criteria.
- A
- Activate the Selection Criteria so they are generated for this
report when the Report Set is submitted. Selection Criteria can only
be activated if one or more Select Statements are specified and not
all are excluded. An asterisk * indicates they are active.
- D
- Deactivate the Selection Criteria. Any you have specified here
will not be used.