Like the LIST Report Form, LISTX defines the fields to be included, the order of the columns, and a title for the report. LISTX can also define a sort sequence for up to three fields and, for one of the sort fields, a limit on the number of records to be processed.
The Report Form panel has two views as there are too many columns of information to display in a single screen view. Scroll Right (F11) to toggle between the views.
File Edit Confirm Upgrade Options Help
------------------------------------------------------------------------------
EDIT LISTX Report Form - XMPLISTX More: >
Command ===> ________________________________________________ Scroll ===> PAGE
Description . . . . List Extended Report Form_______ Version (VRM): 680
Selection Criteria:
_ Performance * Page width . . 132_
Field
/ Name + S Type Limit Description
__ TRAN____ A _______ ________ Transaction identifier
__ STYPE___ * _______ ________ Transaction start type
__ USERID__ * _______ ________ User ID
__ RSYSID__ * _______ ________ Remote System ID
__ PROGRAM_ * _______ ________ Program name
__ TASKNO__ * _______ ________ Transaction identification number
__ STOP____ * TIMET__ ________ Task stop time
__ RESPONSE * _______ ________ Transaction response time
__ DISPATCH * TIME___ ________ Dispatch time
__ CPU_____ * TIME___ ________ CPU time
__ SUSPEND_ * TIME___ ________ Suspend time
__ DISPWAIT * TIME___ ________ Redispatch wait time
__ FCWAIT__ * TIME___ ________ File I/O wait time
__ FCAMCT__ * _______ ________ File access-method requests
__ IRWAIT__ * TIME___ ________ MRO link wait time
__ EOR_____ _ _______ ________ ----------- End of Report ---------
__ EOX_____ _ _______ ________ ----------- End of Extract --------
F1=Help F3=Exit F4=Prompt F5=Rfind F7=Backward F8=Forward
F10=Actions F11=Right F12=Cancel
File Edit Confirm Upgrade Options Help
------------------------------------------------------------------------------
EDIT LISTX Report Form - XMPLISTX More: >
Command ===> ________________________________________________ Scroll ===> PAGE
Description . . . . List Extended Report Form_______
Title . . First half title__________________________________________________
Second half title_________________________________________________
Field
/ Name + S Type Limit Length Dictionary Definition
__ TRAN____ A _______ ________ 4 TRAN DFHTASK C001
__ STYPE___ * _______ ________ 2 TTYPE DFHTASK C004
__ USERID__ * _______ ________ 8 USERID DFHCICS C089
__ RSYSID__ * _______ ________ 4 RSYSID DFHCICS C130
__ PROGRAM_ * _______ ________ 8 PGMNAME DFHPROG C071
__ TASKNO__ * _______ ________ 8 TRANNUM DFHTASK P031
__ STOP____ * TIMET__ ________ 12 STOP DFHCICS T006
__ RESPONSE * _______ ________ 8 RESP CICSPA D901
__ DISPATCH * TIME___ ________ 8 USRDISPT DFHTASK S007
__ CPU_____ * TIME___ ________ 8 USRCPUT DFHTASK S008
__ SUSPEND_ * TIME___ ________ 8 SUSPTIME DFHTASK S014
__ DISPWAIT * TIME___ ________ 8 DISPWTT DFHTASK S102
__ FCWAIT__ * TIME___ ________ 8 FCIOWTT DFHFILE S063
__ FCAMCT__ * _______ ________ 8 FCAMCT DFHFILE A070
__ IRWAIT__ * TIME___ ________ 8 IRIOWTT DFHTERM S100
__ EOR_____ _ _______ ________
__ EOX_____ _ _______ ________
F1=Help F3=Exit F4=Prompt F5=Rfind F7=Backward F8=Forward
F10=Actions F11=Right F12=Cancel
When a report specifies a Report Form and both have Selection Criteria specified, records must match both criteria to be included in the report.
When you increase the page width, you can include more fields in the report. Move EOR down the list or move fields above EOR to include the fields of interest. CICS PA automatically adjusts the EOR marker when the fields overflow the page width.
When you view the report output (using SDSF), scroll right to see the additional fields. Note that when you print the report, data that exceeds the maximum printer page width is truncated.
If the report uses a Report Form, and a title is specified on both, the title on the report takes precedence.
This option generates the TITLE1('left-half') and TITLE2('right-half') operands.
The title is ignored for extracts.
Type an Application Group name in the Field Name column and APG in the Type column, and then press Enter. Otherwise, if you press Enter without APG in the Type column, the panel attempts to interpret the Application Group name as a CMF data field.
When you add an Application Group to a Report Form, CICS PA adjusts the EOR marker to allow for the maximum width of an Application name (32 characters). However, when producing a report, CICS PA adjusts the Application Group column width to fit the longest Application name in the report.
Application Groups are stored in a repository. Report Forms are independent of repositories, so the panel does not validate the Application Group name.
EOR is managed by CICS PA. It signals the end of the report line. The fields listed above EOR fit on the report line and 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 the Form is changed to ensure that the maximum page width of 132 is not exceeded. In positioning EOR, CICS PA allows for one blank separator between each field.
To produce a report line shorter than 132, either move EOR towards the top of the Form, delete unwanted fields, or move them below EOR.
EOX signals the end of the extract record. There are no restrictions on record length so EOX can be positioned anywhere in the list. EOX is initially positioned just below EOR. Fields above EOX are included in the extract, those below EOX are ignored. If EOX is not specified, EOR is used.
Candidate sort fields are indicated by an asterisk *. To change a candidate sort field to an active sort field, move it above EOR and overtype the asterisk with an A or D. To remove a sort field, either move it below EOR, delete it, or overtype the sort sequence with a blank or asterisk.
For one sort field only, you can specify a limit on the number of records to process at that level in the sort order.
or
File Edit Confirm Upgrade Options Help
------------------------------------------------------------------------------
EDIT LISTX Report Form - SAMPLX Row 1 to 6 of 6
Command ===> ________________________________________________ Scroll ===> PAGE
Description . . . . List Extended Report Form_______ Version (VRM): 680
Selection Criteria:
_ Performance * Page width . . 120_
Field
/ Name + S Type Limit Description
__ TRAN____ A _______ ________ Transaction identifier
__ RESPONSE D _______ 10______ Transaction response time
__ CPU_____ * TIME___ ________ CPU time
__ PROGRAM_ * _______ ________ Program name
__ EOR_____ _ _______ ________ ----------- End of Report ---------
__ APPLID__ * _______ ________ CICS Generic APPLID
Line Actions: For the list of valid line actions for the LISTX Report Form panel, see LIST Report Form.
Primary Commands: For the list of valid primary commands for the LISTX Report Form panel, see LIST Report Form.