The OMEGAMONĀ® operand
requests the OMEGAMON reports.
The command format is:
CICSPA OMEGAMON[(
[OUTPUT(ddname|OMEG0001),]
[LINECNT(nnn),]
[DBMS(ADABAS,DATACOM,IDMS,SUPRA),]
[LIST,]
[SUMMARY(TRAN,DATABASE,AVG,MAX,MIN,TOT,DEV,PEAK(percentile)),]
[PRINT(TOTALS,DB),]
[TITLE1('...sub-heading left ...'),]
[TITLE2('...sub-heading right...')]
[SELECT(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),
...))])]
The options are:
- OUTPUT
- Controls the report output DDname. If not specified, CICS PA assigns
a DDname in the format OMEGnnnn where nnnn is the report sequence
number 0001-9999. See OUTPUT for
further information.
- LINECount
- Controls the number of lines per page. See LINECount for further information.
- DBMS
- The types of DBMS for which you want to produce reports.
- LIST
- Requests the OMEGAMON List
report.
- SUMMARY
- Requests the OMEGAMON Transaction
Summary report (TRAN), the Database Summary report (DATABASE),
and also the statistical functions that these reports use to summarize
transaction data:
- AVG
- Average
- MAX
- Maximum
- MIN
- Minimum
- TOT
- Total
- DEV
- Standard deviation
- PEAK
- Peak percentile. Specify a percentile value between 50 and 100
to report the value for that percentage of transactions. Computations
assume a normal distribution. For example, specify PEAK(95) to
report the value for 95% of transactions.
Each statistical function that you specify produces
additional rows in the reports, with the function name as the row
heading.
- PRINT
- Each OMEGAMON XE
for CICSĀ® (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.
- PRINT(TOTALS)
- Includes totals sections in a report, using information from totals
segments in the input records.
- PRINT(DB)
- Includes database sections in a report, using information from
detail segments in the input records.
The PRINT operand is relevant only to the
List report and the Transaction Summary report; it has no effect on
the Database Summary report.
- TITLE1, TITLE2
- Controls the report title (left and right half of subheading line).
See TITLE1 and TITLE2 for further information.
- SELECT(PERFORMANCE(INCLUDE|EXCLUDE
- Specifies what data to include or exclude from the report based
on data field values. See Using SELECT statements for
a detailed explanation and examples.
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.
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.
- TASKNO
- Transaction identification number
- TRAN
- CICS transaction ID
- UOWID
- Unit of work ID
All other fields are ignored.