Requesting a report from the Affinities Reporter
To run the Affinities Reporter against the Affinity database objects, edit and run the CIUAFFRD job. To run the Affinities Reporter against the VSAM affinity data files, edit and run the CIUAFFRP job. Before running either of the jobs, change the values of the parameters listed, as appropriate.
The changes you need to make to the job stream are similar to those described in Updating the Affinity database objects and are listed in the header of the JCL file:
- The JOB accounting parameters.
- The PARM parameter of the EXEC statement For example:Worsen specifies that the Reporter is to worsen transaction affinity relations for affinities on which the Collector has not detected at least 10 occurrences.
.REPORT EXEC PGM=CIUAFFR,PARM='WORSEN'
- The STEPLIB DD statement; specify the name of the CICS® IA load library where you have installed the Affinities Reporter program, CIUAFFR.
- The APPLID DD statement; specify the APPLID of the CICS TS region, for which you want to receive a report.
- The CMDGRPS DD statement, specify the affinity command types you
want to see in the report. Only those affinity types listed on this
DD statement are shown in the report. You can specify any of the following
affinity types, with each type on a separate line, starting in column
one:
CANCEL DISCARD GETMAIN RESYNC COLLECT ENABLE INQUIRE RETRIEVE CREATE ENQ LOAD TS CWA EXTRACT PERFORM WAIT If you do not specify any affinity types on the CMDGRPS DD statement or specify CMDGRPS DD DUMMY, all affinity types are selected for reporting.
The first part of the report lists the affinity types selected.
- The TRANGRPS DD statement; specify the name of the sequential data set where the basic affinity-transaction-group definitions are to be sent.
- The SYSPRINT DD statement; specify the destination for the report.