Specifying which affinity-related CICS® commands are to be monitored

Use the Resource Options panel, CIU290, and the CICS Affinities Options panel, CIU270, to specify which affinity related commands are to be monitored.

To specify which affinity-related CICS® commands are to be monitored on a particular CICS® region, type action code 8 at the top of the Resource Options panel, CIU290, shown in Collector Resource Options panel, CIU290, and press Enter.

The CICS Affinities Options panel, CIU270, shown in Collector Affinities Options panel, CIU270, is displayed.

Note:

If you specified ALL on the Region Configuration Menu, the initial values of the fields on the CICS Affinities Options panel are set to those of the first real CICS® region listed on the Region Configuration Menu; that is, the values are taken from the first region listed after the special ALL and DEFAULT applids. Both the CICS® APPLID and the SYSID are shown as ALL .
If you specified DEFAULTS on the Region Configuration Menu, the initial values of the fields on the CICS Affinities Options panel are the defaults, taken from the CICS® IA control file, CIUCNTL. The CICS® APPLID is shown as DEFAULTS and the SYSID as DFTS™. Any changes that you make are saved in the control file and become the new default values.
If you are editing the DEFAULTS record, you must specify Y or N in each field. You cannot specify a blank.

Figure 1. Collector Affinities Options panel, CIU270

 CIU270   CICS Interdependency Analyzer for z/OS - V6R3M0             2025:12:17
                CICS Affinities Options for                           12:26:50AM
           CICS Sysid   : 1621     CICS Applid   : C62C1C01                     
                                                                                
 Modify the options and press Enter to update, or PF12 to Cancel.               
                                                                                
 Detect affinity types: Y=Yes, N=No or blank=default                        ❶
                        T=Terminal associated task (TS QUEUE type only)
 Inter-Transaction                                                          ❷
  ENQ, DEQ . . . Y  TS QUEUE . . . . Y  ADDRESS CWA. . Y RETRIEVE WAIT. Y                    
  LOAD . . . . . Y  GETMAIN SHARED . Y  CANCEL . . . . Y           
                                                                                  
 Transaction-System                                                         ❸
  INQUIRE, SET . Y  ENABLE, DISABLE Y  EXTRACT. . . . Y COLLECT STATS. Y                    
  PERFORM  . . . Y  RESYNC  . . . . Y  WAIT . . . . . Y DISCARD  . . . Y                    
  CREATE . . . . Y  CSD   . . . . . Y                   
 
 Multiple signon with same ID : Y    (Y=Yes, N=No)                          ❹
                                                                                
 CICS Sysid:  1621   CICS Applid:  C62C1C01   TermID:  1037                     
 CIU2152I CINT C62C1C01 CICS Affinity options are updated
 F1=          F2=           F3=Exit      F4=          F5=          F6=          
 F7=          F8=           F9=          F10=         F11=         F12=Cancel

❶ Detect affinity types

This option is used to specify whether or not the Collector is to monitor each of the types of affinity-related command listed. For each type of command that you want the Collector to monitor, type Y. For each type of command that you do not want the Collector to monitor, type N, or use the default value in the CICS® IA control file, specify a blank. When the control file is first created, the system default value is Y Yes, but you might have modified it since. If you are editing the DEFAULTS record, you must specify Y or N in each field. You cannot specify a blank.

You can choose the symbol T for TS QUEUE type, if you want the Collector to monitor only terminal associated tasks.

❷ Inter-transaction

This group of CICS® commands can cause inter-transaction affinities.

❸Transaction-system

This group of CICS® commands can cause inter-system affinities.

❹ Multiple sign-on with same ID

If your conventions allow more than one user to be signed on to CICS® with the same user ID at the same time, set the Multiple sign-on with same ID field to Y. If you do not, the Collector might incorrectly deduce some affinity lifetimes and create erroneous affinity transaction groups. You also set the field to Y for conventions where more than one user is simultaneously not signed on; that is, they all take the default user ID CICSUSER.

Also, if you are running the Collector in an AOR, the user IDs examined depend on whether the user ID is propagated from the TOR or derived from the SESSION and CONNECTION resource definitions. In the latter case, set the multiple sign-on option to Y if your conventions allow the same AOR user IDs to be signed on to CICS® at the same time.

It is important that this option is set correctly. If you are about to start a new run of the Collector, and intend to restore data from the affinity data VSAM files, ensure that this option is the same as the option used in the previous run of the Collector, for which affinity data is to be restored.

You can specify Y or N or to use the default value in the CICS® IA control file, specify a blank. When the control file is first created, the system default value is N (No), but you might have modified it since.