Specifying region-specific options: timers

A timer controls the times and dates at which dependency data, affinity data, or both are collected in a CICS® region.

After the Collector is started, the timer automatically pauses and resumes data collection at specified times. You can override the actions of the timer: see Pausing the collection of data and Resuming the collection of data. However, the timer continues to operate and to pause and resume the collection of data at the specified times.

The timer does not pause or resume data collection exactly on the hour when data is being collected on multiple regions, to minimize contention for shared resources.

Do one of the following:
  • To specify CICS IA the Time and Date options for a particular CICS region, type action code 4 against the APPLID of the region on the Region Configuration Menu panel, CIU200, shown in Collector Region Configuration Menu panel, CIU200. Press Enter. Then type action code 2 on panel CIU290 and press Enter.
  • If more than one CICS region is listed on the Region Configuration Menu, to apply your choices to all the regions type action code 4 against ALL at the top of the list on panel CIU200 and press Enter. Type action code 2 on panel CIU290 and press Enter.
  • To set or change the default values for the Time and Date options, type action code 4 against DEFAULTS on the CIU200 panel and press Enter. Then type action code 2 on panel CIU290 and press Enter.
The Time and Date Options screen, CIU280, shown in Figure 1, is displayed.
  • If you specified ALL on the Region Configuration Menu, the initial values of the fields on the Time and Date 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 DEFAULTS 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 Time and Date 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 cannot specify a blank for any of the slots.

Figure 1. Collector Time and Dates Options screen, CIU280
 CIU280   CICS Interdependency Analyzer for z/OS - V5R1M0             2012/08/09
                  Time and Date Options for                           12:21:38PM
           CICS Sysid   : TLS4     CICS Applid   : IYCLZC04                     
                                                                               
 Modify the options and press Enter to update or F12 to Cancel.                
                                                                              
Hour slots: Y=Yes, N=No, A=Affinity, I=Interdependency, B=Both, or BLANK   
 Month, Day, and Week slots: Y=Yes, N=No or BLANK                             
                                                                              
 Hour of day: 0-1-2-3-4-5-6-7-8-9-10-11-12-13-14-15-16-17-18-19-20-21-22-23-24  1  
               _ _ _ _ _ _ _ _ _ _  _  _  _  _  _  _  _  _  _  _  _  _  _  _  
                                                                              
 Day of week: Mon  Tue  Wed  Thu  Fri  Sat  Sun   2                               
               _    _    _    _    _    _    _                                 
                                                                              
 Day of month: 1 2 3 4 5 6 7 8 9 10 1 2 3 4 5 6 7 8 9 20 1 2 3 4 5 6 7 8 9 30 1  3 
               _ _ _ _ _ _ _ _ _ _  _ _ _ _ _ _ _ _ _ _  _ _ _ _ _ _ _ _ _ _  _ 
                                                                               
                                                                               
 Month of year: Jan  Feb  Mar  Apr  May  Jun  Jul  Aug  Sep  Oct  Nov  Dec    4   
                 _    _    _    _    _    _    _    _    _    _    _    _       
                                                                                
 CICS Sysid:  TLS4   CICS Applid:  IYCLZC04   TermID:  TC23                     
                                                                                
 F1=          F2=           F3=Exit      F4=          F5=          F6=          
 F7=          F8=           F9=          F10=         F11=         F12=Cancel   

The Hour slots and Month, Day, and Week slots are used to specify whether or not the timer is to be active during this time period and what type of data to collect. When the control file is first created, the system default value for all of the slots is Y (Yes), but you might have modified it since.

 1  Hour of day
Specify the type of data to collect or specify a blank, to use the default value in the CICS IA control file. The types of data values are as follows:
  • A, collect Affinity data
  • B, collect both Affinity and Interdependency data
  • I, collect Interdependency data
  • N, do not collect data
  • Y, collect data as specified by the Data to Collect value on the General Options panel
 2  Day of week
Specify Y (Yes) or N (No), or specify a blank to use the default value in the CICS IA control file.
 3  Day of month
Specify Y (Yes) or N (No), or specify a blank to use the default value in the CICS IA control file.
 4  Month of year
Specify Y (Yes) or N (No), or specify a blank to use the default value in the CICS IA control file.
Note: If you are editing the DEFAULTS record, you cannot specify a blank for any of the slots.
Example:

You want the Collector to run every Monday between 1 and 2 a.m. for the next year collecting affinity data. Set 1-2 to A and all the other Hour of day slots to N. Set Mon to Y and all of the other Day of week slots to N. Set all the Day of month and Month of year slots to Y.