Cross-System Work report

The Cross-System Work report accepts performance class data from a single or multiple CICS® systems and correlates the data by network unit-of-work.

The report default is to print only the CMF performance class records that are contained in a unique network unit-of-work that includes multiple performance records. Note that the Cross-System Work report will also include multiple performance class records from a single system.

To request the report, enter line action S against the Cross-System Work Performance Report on the Report Set panel. If reports of this type have been previously specified, the list of Cross-System Work Reports is displayed. Otherwise, the Cross-System Work Report panel is displayed for you to define your first report of this type.
Figure 1. Cross-System Work Reports
   File  Filter  Edit  Systems  Options  Help
 ------------------------------------------------------------------------------
                      SAMPLE - Cross-System Work Reports           Row 1 from 2
 Command ===> ________________________________________________ Scroll ===> ____
 
                                                           Criteria
         ---- System Selection -----                      Record  UOW
 /  Exc  APPLID +  Image +  Group +   Output     Form +   ------ ------
 _       ________  ________ MROPROD_  CROS0001   ________  YES    NO
 _       ________  ________ MROTEST_  CROS0002   ________  NO     NO
 ********************************* End of list *********************************
 

This panel displays the list of Cross-System Work 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 and line actions are the same as those for the Performance List Reports panel. See Performance List report.

To display the Cross-System Work Report panel, enter line action S against the Cross-System Work Performance Report on the Report Set panel, then if the list of previously specified reports is displayed, enter line action S against a particular report in the list.
Figure 2. Cross-System Work Report
   File  Systems  Options  Help
 ------------------------------------------------------------------------------
                       SAMPLE - Cross-System Work Report
 Command ===> _________________________________________________________________
 
 System Selection:                       Report Output:
  APPLID . . ________  +                  DDname . . . . . . . . . CROS0001
  Image  . . ________  +                  Print Lines per Page . . ___ (1-255)
  Group  . . MROPROD_  +
 
 Processing Options:                     Task Ordering Options:     
  1  1. UOWs with more than one record    1  1. Descending Stop time
     2. UOWs with a single record            2. Ascending Start time
     3. All UOWs                                                    
 
 Report Format:
  Form . . . ________  +
  Title  . . ________________________________________________________________
             ________________________________________________________________
 
 Selection Criteria:
  _  Performance (Record pre-processing)  *       
  _  Performance (Unit-of-work post-processing)
 
  F1=Help      F3=Exit      F4=Prompt    F7=Backward  F8=Forward  F10=Actions
 F12=Cancel

Use this panel to specify report options, report format, and record selection criteria for the Cross-System Work report. The mandatory options are the Report Output DDname and the network unit-of-work (UOW) Processing Option. You can let the other options default.

The report options are the same as those for the Performance List Report (see Performance List report), except there is an additional processing option and a LIST or LISTX Report Form can be specified:
Processing Options
Select option 1 - UOWs with more than one record to report only the transaction performance records whose network unit-of-work spans multiple CMF records. This is the default. This selection generates the PRINTMULTIPLE operand.

Select option 2 - UOWs with a single record to report only the transaction performance records consisting of network units-of-work that include only a single CMF record. This selection generates the PRINTSINGLE,NOPRINTMULTIPLE operand.

Select option 3 - All UOWs to report all the transaction performance records. This selection generates the PRINTSINGLE,PRINTMULTIPLE operand.

Task Ordering Options
Controls the sorting order of tasks within UOW in the List report. You can choose to order tasks by descending stop time (the default order) or ascending start time.

This option generates the operand TASKORDER(START|STOP).

Report Form
The name of a Report Form to be used to tailor the format and content of the report. It can be either a LIST or LISTX Form. You can type the name directly, or to select one from a list of compatible Report Forms, use Prompt (F4).

CICS PA JCL generation translates the Report Form specification into the FIELDS operand of the LISTX command. This produces a Cross-System Work Extended report like that shown in Figure 5.

Performance Selection Criteria
You can specify Selection Criteria to filter the CMF records on time period and field values to restrict reporting to the data that is of interest to you. For the Cross-System Work report, there are two levels of filtering available:
  • Record pre-processing. CICS PA JCL generation translates Selection Criteria to the SELECT(PERFORMANCE operand.

    If you specify a Report Form that also has Selection Criteria specified, CICS PA JCL generation translates the Form's Selection Criteria to the SELECT2(PERFORMANCE operand. If both the report and the Form specify Selection Criteria, then a record must pass selection by both specifications to be included in the report.

  • Unit-of-work post-processing. Allows you to limit the report to specific units-of-work. This generates the SELUOW operand to provide filtering across tasks in multi-task UOWs. If one task in a UOW matches the SELUOW selection criteria, then the entire UOW is selected. For more information, see CROSSsystem - Cross-System Work report and extract.

CICS PA provides a default Report Output DDname in the format CROSnnnn where nnnn is 0001-9999.


Information Information

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//pxsyswk.htm