OMEGAMON - OMEGAMON reports
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 LINECNT 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.
- 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