
STATISTICS SUMMARY Report Form
The Statistics Summary Report Form panel defines the format and content of the Statistics Summary report.
When you create a new statistics summary form, a statistics report tree is displayed, in which the reports are grouped by category.
When you enter line action S against a report in the tree, the Statistics Summary Reports Form is displayed so you can select the fields you want to include in the form. Scroll Right (F11) to see the second view, in which Field Name is displayed instead of Field Heading.
File Edit Options Help
───────────────────────────────────────────────────────────────────────────────
EDIT EDIT Statistics Reports Form - STSUM Line 1 of 113
Command ===> Scroll ===> PAGE
Description Statistics Summary Report Form VRM TS: 700 TG: 910
** Report **
- Regions
Transaction Manager
Monitoring
- CICS Dispatcher
Dispatcher Overview
S Dispatcher TCB Modes
Dispatcher TCB Pools
MVS TCB Overview
MVS TCBs
- CICS Storage
Storage Overview
DSAs
Domain Subpools
Task Subpools
- CICS Dumps
Transaction Dump Overview
Transaction Dumps
System Dump Overview
System Dumps
Enqueue Pools
BUNDLE Resources
- Connectivity
VTAM
Terminal Autoinstall
Terminals
ISC/MRO Connections
LU62 Mode Names
ISC Security
TCP/IP Overview
TCPIPSERVICE Resources
IPCONN Resources
FEPI Connections
FEPI Pools
FEPI Targets
-DSLIST *CMD
File Edit Confirm Upgrade Options Help
------------------------------------------------------------------------------
EDIT Dispatcher TCB Modes - STSUM Row 1 of 24 More: >
Command ===> Scroll ===> PAGE
Description . . . Statistics Summary Report Form VRM TS: 700 TG: 910
Page width . : 130
Field Sort
/ Heading + K O Fn
APPLID K A
IMAGE K *
COLLECTION TIME K *
TCB MODE NAME K *
TCB POOL K *
TCB ATTACHES TOT
TCB ATTACH FAILURES TOT
PEAK TCBS ATTACHED MAX
PEAK MODE TCBS MAX
TCB ALLOCATES TOT
TCB DETACHES UNCLEAN TOT
TCB DETACHES STOLEN TOT
TCB DETACHES EXCESS TOT
TCB DETACHES OTHER TOT
TCB MISMATCHES TOT
PEAK DISPATCHABLE QUEUE TASKS MAX
AVE DISPATCHABLE QUEUE TASKS MAX
TOTAL MVS WAIT TIME TOT
TOTAL TCB DISPATCH TIME TOT
TOTAL TCB DS CPU TIME TOT
TOTAL TCB CPU TIME TOT
EOR -------------- END OF REPORT --------------
******************************* Bottom of data ********************************
File Edit Confirm Upgrade Options Help
------------------------------------------------------------------------------
EDIT Dispatcher TCB Modes - STSUM Row 1 of 24 More: >
Command ===> Scroll ===> PAGE
Description . . . Statistics Summary Report Form VRM TS: 700 TG: 910
Title . .
Field Sort
/ Name + K O Fn
APPLID K A
IMAGE K *
COLLECTTIME K *
DSGTCBNM K *
DSGTCBMP K *
DSGNTCBA TOT
DSGTCBAF TOT
DSGTCBPA MAX
DSGTCBPU MAX
DSGTCBAL TOT
DSGTCBDU TOT
DSGTCBDS TOT
DSGTCBDX TOT
DSGTCBDO TOT
DSGTCBMM TOT
DSGTMPDQ MAX
DSGTMADQ MAX
DSGTWT TOT
DSGTDT TOT
DSGTCT TOT
DSGACT TOT
EOR -------------- End of Report --------------
******************************* Bottom of data ********************************
The Statistics Summary form consists of the following fields:
- Description
- Up to 32 characters of text to describe the purpose of the report form. This description is shown to help you identify the forms in the list. It is initially set to Statistics Summary Report Form.
- TS
- This identifies the CICS® Transaction Server release that this report form is created for. There are differences in the reports and fields that are available in each CICS Transaction Server release.
- TG
- This identifies the CICS Transaction Gateway release that this report form is created for. There are differences in the reports and fields that are available in each CICS Transaction Gateway release.
- Page Width
- Page Width is the width of the report page for all form fields above the EOR marker. Page Width changes when you move fields above EOR or below EOR.
- Field Heading
- One of the following values:
- The CICS Transaction Server or CICS Transaction Gateway statistics field heading. Use line action S or prompt (F4) to select from a list of fields applicable to this form type and CICS version. You can manually enter the field heading of any valid statistics field.
- The special entry EOR.
EOR is managed by CICS PA. It signals the end of the report line. The fields listed above EOR are included in the report in the same order as they appear in the list. Those below EOR will not be reported and are ignored.
CICS PA automatically sets EOR when the report form is created and resets it if necessary when you move fields above or below EOR. In positioning EOR, CICS PA allows for one blank separator between each field.
- Field Name
- One of the following values:
- The CICS Transaction Server or CICS Transaction Gateway statistics field. Use line action S or prompt (F4) to select from a list of fields applicable to this form type and CICS version.
- The special entry EOR.
EOR signals the end of the report line.
- Sort K
- A K in the Sort K column identifies a key field. The data in the report is summarized by the value of each key field.
- Sort O
- If A (ascending)
or D (descending)
appears in the Sort O column, the report is
summarized and ordered by that field. A sort order of * (asterisk) identifies a candidate
sort field. Sort fields marked with *,
and those that are blank, are ignored for reporting purposes.
To activate a candidate sort field, move it to the top of the form and set the Sort O column to A or D. Key fields above EOR must appear first in the list of fields. Key fields below EOR are ignored. The combined total length of all key fields cannot exceed 255 bytes. The order of the key fields in the list defines the sort and summarization precedence, so that the first key field is the major sort field.
For a report to run successfully, each activated sort field must be a common key field for all the STIDs that have provided data for the report. The fields APPLID, IMAGE, and COLLECTTIME are common to all STIDs, and therefore they are available for any Statistics Summary report form. They are called global keys.
- APPLID
- The CICS Transaction Server generic APPLID or CICS Transaction Gateway APPLID. Some statistics data fields require APPLID for a report to run successfully. CICS PA prevents you from creating a report form that is missing APPLID if it is mandatory, and a report that is missing a mandatory APPLID field fails to run.
- IMAGE
- The SMF identifier of the MVS system where the CICS system runs.
- COLLECTTIME
- The collection time of the statistics interval.
Tip: You can create a report that combines TS and TG statistics if the fields in the report share a common key value such as IMAGE or COLLECTTIME. - Fn (Function)
- The summary function applied to each non-key field. You must specify
a summary function for each non-key field to run the report successfully.
The valid functions are:
- MAX
- Maximum value.
- MIN
- Minimum value.
- TOT
- Total.
FIN
Last value stored in the field. This is useful when you want to show a fixed or final value in a report to provide context, for example Current MAXTASK (XMGMXT) or Max TCB Pool Limit (DSGMXTCB).
Note: To provide context, if the form contains a field with a FIN function applied to it, the form must also include APPLID as a key field.
Line Actions
For the list of valid line actions for the STATISTICS SUMMARY Report Form panel, see Line Actions.Primary Commands
The following primary command is available only on the STATISTICS SUMMARY Report Form panel:- COPY
- This command
combines summary fields from multiple STIDs into a single report form. STIDs that share a common key
field are eligible for combination. This feature is known as cross-domain reporting.
After you type COPY and press Enter, you can select the STIDs whose fields you want to add into the report form that you are editing.
For a list of other valid primary commands for the STATISTICS SUMMARY Report Form panel, see Primary Commands.
