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:
    REPORT   EXEC PGM=CIUAFFR,PARM='WORSEN'
    .
    Worsen specifies that the Reporter is to worsen transaction affinity relations for affinities on which the Collector has not detected at least 10 occurrences.
  • 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:

    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.