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 Figure 1, is displayed.
Note:
  1. 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 .
  2. 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.

Start of change
Figure 1. Collector Affinities Options panel, CIU270
 CIU270   CICS Interdependency Analyzer for z/OS - V5R1M0             2015/05/06
                CICS Affinities Options for                           03:26:22PM
           CICS Sysid   : Z53B     CICS Applid   : IYDZZ53B                     
                                                                                
 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:  Z53B   CICS Applid:  IYDZZ53B   TermID:  TC68                     
                                                                                
 F1=          F2=           F3=Exit      F4=          F5=          F6=          
 F7=          F8=           F9=          F10=         F11=         F12=Cancel
End of change
 1  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.

Start of changeYou can choose the symbol T for TS QUEUE type, if you want the Collector to monitor only terminal associated tasks.End of change

 2  Inter-transaction
This group of CICS commands can cause inter-transaction affinities.
 3  Transaction-system
This group of CICS commands can cause inter-system affinities.
Start of change 4  Multiple sign-on with same IDEnd of change
Start of change

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.

End of change