CROSSsystem examples

Example 1: Default report and extract
CICSPA CROSS

Example 2:

The report and extract data sets generated in this example contain all performance records, both from network units of work consisting of multiple CMF records and from units of work consisting of a single CMF record. The specified CHARACTER-type and CLOCK-type user fields are added to the output record.

The extract is written to DDname CPAOXSYS. The report is written to CROS0001, if this is the first Cross-System Work report, and the Recap is written to CROX0001.
CICSPA CROSS(PRINTM,PRINTS,WRITEM,WRITES,
             CHARACTER(OWNER(USER),LENGTH(8),HEADER(MINE)),
             CLOCK(OWNER(USER),NUMBER(2),HEADER(CLOCK2)))

Example 3:

To print records from a network unit-of-work containing single and multiple records, use the following command:
CICSPA CROSS(PRINTM,PRINTS,NOWRITE,OUTPUT(CROS0001))
This produces a report containing information like that shown in Figure 1.
Figure 1. Cross-System Work report (UOWs with single and multiple records)
 V3R2M0                                              CICS Performance Analyzer
                                                         Cross-System Work
 
CROS0001 Printed at 12:03:45  3/15/2011 Data from 11:10:29  2/04/2005 to 11:33:51  2/04/2005                            Page       7
 
                                        Request           Fcty  Conn                  UOW                  R              Response A
Tran Userid   SC TranType Term  LUName   Type   Program  T/Name Name NETName          Seq  APPLID     Task T   Stop Time    Time   B
 
PAY1 BRENNER  TP U        S23C IGCS23C  AP:     DFH0PAY1 T/S23C      GBIBMIYA.IGCS23C   1  IYK2Z1V3    197 T 11:18:14.419    .0861
SALE BRENNER  U  U      R               AP:     DFH0SAL2             GBIBMIYA.IGCS23C   1  IYK2Z1V3    198 T 11:18:14.417    .0821
---- 
CSAC BRENNER  TO U        S23C IGCS23C  AP:     DFHACP   T/S23C      GBIBMIYA.IGCS23C   1  IYK2Z1V3    203 T 11:18:22.466    .0020
---- 
CBAM BRENNER  TO U        S23C IGCS23C  AP:     DFHECBAM T/S23C      GBIBMIYA.IGCS23C   1  IYK2Z1V3    204 T 11:18:36.466  11.0373
---- 
MENU BRENNER  TO U        S23C IGCS23C  AP:     DFH0SAL0 T/S23C      GBIBMIYA.IGCS23C   1  IYK2Z1V3    208 T 11:18:40.026    .0023
---- 
SALE BRENNER  U  U      R               AP:     DFH0SAL2             GBIBMIYA.IGCS23C   1  IYK2Z1V3    212 T 11:18:47.793    .6282
STOC BRENNER  U  U      R               AP:     DFH0STOC             GBIBMIYA.IGCS23C   1  IYK2Z1V3    214 T 11:18:47.792    .6072
RED1 BRENNER  U  U      R               AP:     DFH0RED1             GBIBMIYA.IGCS23C   1  IYK2Z1V3    213 T 11:18:47.789    .6162
SAL1 BRENNER  TP U        S23C IGCS23C  AP:     DFH0SAL1 T/S23C      GBIBMIYA.IGCS23C   1  IYK2Z1V3    211 T 11:18:47.270    .1222
---- 
SAL1 BRENNER  TP U        S23C IGCS23C  AP:     DFH0SAL1 T/S23C      GBIBMIYA.IGCS23C   1  IYK2Z1V3    218 T 11:18:49.567    .0022
---- 
CBAM BRENNER  TO U        S23C IGCS23C  AP:     DFHECBAM T/S23C      GBIBMIYA.IGCS23C   1  IYK2Z1V3    221 T 11:19:30.467  38.9944
---- 
MENU BRENNER  TO U        S23C IGCS23C  AP:     DFH0SAL0 T/S23C      GBIBMIYA.IGCS23C   1  IYK2Z1V3    233 T 11:19:33.364    .0023
---- 
SALE BRENNER  U  U      R               AP:     DFH0SAL2             GBIBMIYA.IGCS23C   1  IYK2Z1V3    240 T 11:19:41.002    .8246
----

Example 4:

This command produces a report like that shown in Figure 2 which only shows the transaction performance records that are contained in a network unit-of-work that includes only a single record.

CICSPA CROSS(PRINTS,NOPRINTM,NOWRITE)
Figure 2. Cross-System Work report (UOWs with a single record)
 V3R2M0                                              CICS Performance Analyzer
                                                         Cross-System Work
 
CROS0001 Printed at 12:03:45  3/15/2011 Data from 11:10:29  2/04/2005 TO 11:33:51  2/04/2005                            Page       8
 
                                        Request           Fcty  Conn                  UOW                  R              Response A
Tran Userid   SC TranType Term  LUName   Type   Program  T/Name Name NETName          Seq  APPLID     Task T   Stop Time    Time   B
 
CALL BRENNER  TO U        S23D IGCS23D  AP:     CALLJT1  T/S23D      GBIBMIYA.IGCS23D   1  IYK2Z1V1    196 T 11:22:57.345   2.1853
---- 
CALL BRENNER  TO U        S23D IGCS23D  AP:     CALLJT1  T/S23D      GBIBMIYA.IGCS23D   1  IYK2Z1V1    251 T 11:30:08.310   2.1249
---- 
CESF BRENNER  TO U        S23D IGCS23D  AP:     DFHSFP   T/S23D      GBIBMIYA.IGCS23D   1  IYK2Z1V1    268 T 11:32:03.467    .0040
---- 
CESN CBAKER   S  U        P012 IG2ZP012 AP:     DFHSNP   T/P012      GBIBMIYA.IG2ZP012  1  IYK2Z1V1     58 T 11:12:54.056    .0034
---- 
CESN CBAKER   TP U        P012 IG2ZP012 AP:     DFHSNP   T/P012      GBIBMIYA.IG2ZP012  1  IYK2Z1V1     60 T 11:13:19.394    .0166
---- 
CALL CBAKER   TO U        P012 IG2ZP012 AP:     CALLJT1  T/P012      GBIBMIYA.IG2ZP012  1  IYK2Z1V1    238 T 11:28:57.007   2.1389
---- 
CALL CBAKER   TO U        P012 IG2ZP012 AP:     CALLJT1  T/P012      GBIBMIYA.IG2ZP012  1  IYK2Z1V1    246 T 11:29:41.833   2.1265
---- 
CQRY CBAKER   S  U        P015 IG2ZP015 AP:     DFHQRY   T/P015      GBIBMIYA.IG2ZP015  1  IYK2Z1V3     50 T 11:12:53.875  18.3021
---- 
CESN CBAKER   S  U        P015 IG2ZP015 AP:     DFHSNP   T/P015      GBIBMIYA.IG2ZP015  1  IYK2Z1V3     53 T 11:12:55.370    .0021
---- 
CESN CBAKER   TP U        P015 IG2ZP015 AP:     DFHSNP   T/P015      GBIBMIYA.IG2ZP015  1  IYK2Z1V3     62 T 11:14:05.802    .0273
---- 
CEMT CBAKER   TO U        P015 IG2ZP015 AP:     DFHEMTP  T/P015      GBIBMIYA.IG2ZP015  1  IYK2Z1V3     64 T 11:16:46.019  144.153
---- 
AMNU CBAKER   TO U        P015 IG2ZP015 AP:     DFHSAMNU T/P015      GBIBMIYA.IG2ZP015  1  IYK2Z1V3    138 T 11:16:47.866    .0327
---- 
ABRW CBAKER   TO U        P015 IG2ZP015 AP:     DFHSABRW T/P015      GBIBMIYA.IG2ZP015  1  IYK2Z1V3    139 T 11:16:51.568    .6982
---- 
ABRW CBAKER   TP U        P015 IG2ZP015 AP:     DFHSABRW T/P015      GBIBMIYA.IG2ZP015  1  IYK2Z1V3    140 T 11:16:52.068    .0018
----

Example 5:

The following command creates the Cross-System Work extract while the Cross-System Work report is suppressed. The extract is created using all the performance records. The performance records contained in a network unit-of-work that includes only a single record, as well as multiple records, are written to the extract data set specified in the default DD statement CPAOXSYS.
CICSPA CROSS(NOPRINT,WRITEM,WRITES)

Example 6:

The following command is an example of how to include user fields from the input data set in the output extract data set.
CICSPA CROSS(
             COUNT(OWNER(USER),NUMBER(001),HEADER(MYCOUNT1)),
             CHARACTER(OWNER(USER),LENGTH(40)))

Example 7:

It can be very useful to analyze the performance data from the Cross-System Work extract. This data can provide an insight into the total resources used by a transaction and shows information such as the accumulated dispatch, CPU, and wait times as well as the five user fields added by CICS PA.

Figure 3 shows a Performance List report created from a Cross-System Work extract data set. To create a similar report, use the following command:
CICSPA LIST(FIELDS(TRAN,TASKNO,STOP(TIMES),RESPONSE,
                   DISPATCH,CPU,SUSPEND,DISPWAIT,
                   IRWAIT(COUNT),RMISUSP(COUNT),
                   COUNT(OWNER(CICSPA),NUMBER(1)),
                   COUNT(OWNER(CICSPA),NUMBER(2)),
                   COUNT(OWNER(CICSPA),NUMBER(3)),
                   COUNT(OWNER(CICSPA),NUMBER(4)),
                   COUNT(OWNER(CICSPA),NUMBER(5))))
Figure 3. Example of a Performance List report from a Cross-System Work extract data set
 V3R2M0                                                 CICS Performance Analyzer
                                                            Performance List
 
LIST0001 Printed at 12:03:45  3/15/2011    Data from 11:20:53  2/04/2004                         APPLID MULTIPLE      PAGE       1
 
 Tran   TaskNo Stop     Response Dispatch User CPU Suspend  DispWait IRWait   RMIsusp  TotRecs  ApplRecs TranRout FuncShip DplRecs
               Time       Time     Time     Time     Time     Time     Count    Count
 ABRW      157 11:20:53    .0079    .0058    .0042    .0062    .0000       13        0        2        1        0        1        0
 ABRW      160 11:20:54    .0074    .0051    .0038    .0063    .0000       13        0        2        1        0        1        0
 ABRW      161 11:20:55    .0060    .0040    .0037    .0059    .0000       13        0        2        1        0        1        0
 ABRW      162 11:20:56    .0069    .0047    .0036    .0063    .0000       13        0        2        1        0        1        0
 ABRW      163 11:20:59    .0028    .0027    .0015    .0001    .0000        0        0        1        1        0        0        0
 ABRW      164 11:21:05    .0146    .0044    .0036    .0146    .0000       11        0        2        1        0        1        0
 ABRW      165 11:21:07    .0014    .0012    .0010    .0002    .0000        0        0        1        1        0        0        0
 ABRW      166 11:21:11    .0062    .0045    .0034    .0050    .0000       11        0        2        1        0        1        0
 ABRW      167 11:21:13    .0053    .0037    .0034    .0053    .0000       13        0        2        1        0        1        0
 ABRW      168 11:21:15    .0073    .0051    .0038    .0065    .0000       13        0        2        1        0        1        0
 ABRW      169 11:21:17    .0124    .0084    .0048    .0112    .0001       13        0        2        1        0        1        0
 ABRW      170 11:21:19    .0085    .0054    .0040    .0083    .0000       13        0        2        1        0        1        0
 ABRW      171 11:21:22    .0069    .0047    .0037    .0061    .0000       13        0        2        1        0        1        0
 ABRW      172 11:21:23    .0065    .0048    .0037    .0053    .0000       13        0        2        1        0        1        0
 ABRW      173 11:21:25    .0067    .0046    .0041    .0066    .0000       13        0        2        1        0        1        0
 ABRW      175 11:21:27    .0097    .0078    .0043    .0062    .0000       13        0        2        1        0        1        0
 ABRW      176 11:21:29    .0085    .0060    .0041    .0071    .0001       13        0        2        1        0        1        0
 ABRW      177 11:21:30    .0071    .0052    .0040    .0059    .0000       13        0        2        1        0        1        0
 ABRW      179 11:21:33    .0061    .0043    .0034    .0046    .0000        7        0        2        1        0        1        0
 ABRW      180 11:21:35    .0022    .0021    .0012    .0001    .0000        0        0        1        1        0        0        0
 AUPD      181 11:21:42    .0041    .0033    .0024    .0016    .0000        1        0        2        1        0        1        0
 AUPD      182 11:21:45    .0024    .0023    .0013    .0001    .0000        0        0        1        1        0        0        0
 AADD      183 11:21:51    .0022    .0022    .0012    .0001    .0000        0        0        1        1        0        0        0
 AADD      184 11:21:58    .0023    .0022    .0013    .0001    .0000        0        0        1        1        0        0        0
 7INQ      185 11:22:06    .0034    .0026    .0019    .0008    .0000        0        0        1        1        0        0        0
 AINQ      186 11:22:08    .0012    .0011    .0010    .0001    .0000        0        0        1        1        0        0        0
 AINQ      187 11:22:14    .0040    .0035    .0026    .0014    .0000        1        0        2        1        0        1        0
 AMNU      188 11:22:17    .0027    .0026    .0012    .0001    .0000        0        0        1        1        0        0        0
 VINQ      189 11:22:25    .0025    .0024    .0015    .0001    .0000        0        0        1        1        0        0        0
 BINQ      190 11:22:26    .0027    .0027    .0015    .0001    .0000        0        0        1        1        0        0        0
 BING      191 11:22:28    .0024    .0023    .0016    .0001    .0000        0        0        1        1        0        0        0
 CEMT      193 11:22:38   2.7279    .0150    .0094   2.7129    .0000        0        0        4        4        0        0        0
 CEMT      194 11:22:59  19.8433    .0617    .0466  19.7816    .0002        0        0       12       12        0        0        0
 CECI      199 11:23:12   8.5587    .4264    .0720   8.1323    .0206        0        0       10       10        0        0        0
 CECI      200 11:23:21   6.7952    .0159    .0061   6.7792    .0001        0        0        6        6        0        0        0
 CECI      201 11:23:37  13.5524    .2257    .1508  13.3267    .0007        0        0       43       43        0        0        0
 CEDA      202 11:24:05  13.1845   2.0588   1.3244  11.1257    .0107        0        0       73       73        0        0        0
 CESF      271 11:32:58    .0039    .0037    .0029    .0002    .0001        0        0        1        1        0        0        0
 CQRY      122 11:15:48    .2205    .0040    .0015    .2165    .0000        0        0        1        1        0        0        0

Example 8:

Consider that when investigating a problem you know that a transaction had poor response time. You then want to investigate all the activity for units-of-work that involve this poor performing transaction. By specifying selection criteria using SELUOW, the Cross-System Work report can give you all transactions associated with the UOWs that the particular transaction was a part of.

In this example, SELECT is used to provide first-level pre-sort filtering of records. Then SELUOW provides second-level post-sort filtering of units-of-work.
CICSPA IN(SMFIN001),                           
       LINECOUNT(58),                          
       SELECT(PERFORMANCE(INCL(                
              TRAN(STOK,CSMI),                 
              START(FROM(09:30),TO(09:45))))), 
       CROSS(PRINTM,NOWRITEM,                  
             SELUOW(PERFORMANCE(INCL(          
             RESP(>0.5),                       
             TRAN(STOK)))))                    

SELECT will pre-filter the performance records (tasks). Only tasks with a transaction ID of STOK or CSMI that started between 9:30 and 9:45 are included. Note that this first SELECT does not impact reporting. Its purpose is to exclude records you know will never be required for reporting, ensuring that the record sort process is optimized.

SELUOW will post-filter the UOWs. Entire UOWs are reported only when one of the tasks in the UOW has a transaction ID of STOK and a response time greater than 0.5 seconds.