Specifying region-specific options: general

The Region Configuration Menu panel is used for specifying general region-specific options.

You can use the Region Configuration Menu in these ways:
The General Options panel, CIU260, 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 General 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 General 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.
Start of change
Figure 1. Collector General Options panel, CIU260

 CIU260        CICS Interdependency Analyzer for z/OS - V5R1M0        2012/07/30
                           General Options for                        11:44:27AM
           CICS Sysid   : DFTS     CICS Applid   : DEFAULTS                     
                                                                                
 Modify the options and press Enter to update, or PF12 to Cancel.               
                                                                                
 Control options                 
   Data to Collect  . . . . . . : I  (A=Affinity, I=Interdependency, B=Both) 1 
   Perform periodic saves . . . : Y    (Y=Yes, N=No)                     2 
   Trigger for CINB start . . . : 5    (2 to 9999 thousand records)      3 
   Restore data on start  . . . : Y    (Y=Yes, N=No)                     4 
   Multiple signon with same id : N    (Y=Yes, N=No)                     5 
   Maintain usage counts  . . . : Y    (Y=Yes, N=No)                     6 
   Size of dataspace  . . . . . : 16   (10 to 2000 MB)               7 
   Transid prefix (optional). . : ____ (1 to 4 characters)               8 
   Program exclude list . . . . : CIUXPROG   (1 to 8 characters)         9 
   Transaction exclude list . . : CIUXTRAN (1 to 8 characters)           10 
   Resource prefix list . . . . : CIUPFXTB (1 to 8 characters)  11 
   TRUEs Include list . . . . . : CIUXITTB (1 to 8 characters)  12  
   Start of change Dump HLQ . . . . . . . . . . : DUMPHLQ1 (1 to 8 characters) End of change  13 
   Dynamic call . . . . . . . . :   (Y=Yes, N=No)           14 
   CICS Sysid:  Z32B   CICS Applid:  IYCYZC44   TermID:  TC56                     
                                                                                
 F1=Help   14   F2=         F3=Exit      F4=        F5=          F6=        
 F7=          F8=           F9=          F10=         F11=         F12=Cancel   
End of change
 1  Data to Collect
This field is used to specify which type of data you want to collect: affinity data, interdependency data, or both. Use A for affinity, I for interdependency, or B for both affinity and interdependency data. Alternatively, you can use the default value in the CICS IA control file by leaving the field blank. When the control file is first created, the system default value is I for interdependency, but you might have modified it since.
  • You can choose to collect interdependency data on one region and affinity data on another.
  • You can change the type of data (interdependency or affinity) to be collected on a region while the Collector is running on that region, but changes do not take effect until the Collector is restarted.
The options specified for the Time and Date Options fields will override the value specified for the Data to Collect field when they are set to a value other than Y.
 2  Perform periodic saves
This field is used to specify whether you want the collected interdependency data, affinity data, or both to be saved to the VSAM data files, if one of these conditions applies:
  • More than 300 seconds have passed since the last save.
  • More than the number of table elements specified by the Trigger for CINB start option have changed since the last save.
  • You pause the Collector. (The autosave transaction, CINB, writes the collected data to the data VSAM data files automatically when you stop the Collector.)

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

 3  Trigger for CINB start
Enter the number of records to be updated to trigger a CINB save, in thousands. You can enter a value from 1 - 9999. A value of 1 indicates that no saves will be triggered. The default is 5.
 4  Restore data on start
This field is used to specify whether you want data to be restored from the VSAM data files when the Collector is started, which enables newly collected data to be added to the data collected from previous runs of the Collector. If you are gathering data, use one of the following ways:
  • For one set of transaction identifiers at a time
  • For one set of commands at a time
  • For either interdependency data, affinity data, or both
  • If the Collector is being run, at varying times
Setting the option is also of particular value if the Collector stops unexpectedly, because you do not have to start collecting data all over again; you can start from the last time data was saved.

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 Y (Yes), but you might have modified it since.

 5  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 very 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 that 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.

 6  Maintain usage counts

This field is used to specify whether the Collector will record the number of times an interdependency or affinity is detected. The usage count tells you how often resources are used by different applications.

If usage data is not required, switch it off. When usage counts are not maintained, the Collector does not have to update an interdependency or affinity record each time it detects an interdependency or affinity that it has already seen. Hence, when the Collector has been running for some time, and it is detecting fewer and fewer new interdependencies or affinities, fewer and fewer records will be saved to VSAM. Thus, you have a useful test for the completeness of the set of detected interdependencies or affinities.

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 Y (Yes), but you might have modified it since.

 7  Size of data space

The size, in megabytes, that you specify for the data space to store the collected data. The size of the data space is fixed for a run of the Collector.

For information about calculating the size of the data space, refer to CICS IA space considerations.

If the data space becomes full while the Collector is running, the Collector stops with abend code IUXB. If the Collector was saving data at the time, a delay might occur from the time the data space becomes full until the time the Collector stops.

The default value is 16.

 8  Transid prefix
The 1- to 4-character prefix of the CICS transactions for which you want to gather interdependency or affinity data. If you do not specify any characters, data is collected for all transactions. If you specify a valid prefix (for example, ABC), data is collected only for those transactions with identifiers starting with the prefix. If you specify a blank, the default transid prefix in the CICS IA control file is used.
 9  Program exclude list
The 1- to 8-character name of a table containing a list of 1- to 8-character program prefixes. Data is not collected for any program with a name beginning with any of the prefixes. If you specify a blank, the default table name in the CICS IA control file is used. The system default name is CIUXPROG, which is the name of an exclude list supplied with I. For information about how to create your own program exclude lists, see Creating your own program exclude, transaction exclude, and resource prefix lists.
 10  Transaction exclude list
The 1- to 8-character name of a table containing a list of 1- to 4-character transaction prefixes. Data is not collected for any transaction with the name beginning with any of the prefixes. If you specify a blank, the default table name in the CICS IA control file is used. The system default name is CIUXTRAN, which is the name of an exclude list supplied with CICS IA. For information about how to create your own transaction exclude lists, see Creating your own program exclude, transaction exclude, and resource prefix lists.
 11  Resource prefix list
The 1- to 8-character name of a table containing a list of 1- to 32-character resource prefixes. The resource prefix is used to scan a resource name. If a match is found, the remainder of the resource name is replaced by "+"s. For example, if your application program uses a TSQueue or ENQ/DEQ resource name, which consists of a 3-character prefix "DFH" and a 5-character numerical value, and if you do not have an entry in the resource prefix list for "DFH", CICS IA records an entry for the EXEC CICS command with all the possible TSQueue resource names: DFH00001, DFH00002, DFH00003... DFHnnnnn. This redundancy might lead to many thousand entries for the same EXEC CICS command. If the "DFH" prefix is added to the list, CICS IA reports only one entry for the EXEC CICS command with a resource name of DFH+++++. The system default name CIUPFXTB is the name of a resource prefix list supplied with CICS IA. For information about how to create your own resource prefix lists, see Creating your own program exclude, transaction exclude, and resource prefix lists. See also ENQ/DEQ and TS commands to learn about these resources.
 12  TRUEs include list
The 1- to 8-character name of a table containing a list of TRUE names and corresponding to these TRUEs product names. Data is collected for any pair of a TRUE and product name from this list. If you specify a blank, the default table name in the CICS IA control file is used. The system default name is CIUXITTB, which is the name of an include list supplied with CICS IA.
Start of change  13  Dump HLQ End of change
Start of change This field is used to define the high-level qualifier for CICS IA dump data set that will be produced. End of change
 14  Dynamic call
This field is used to specify whether you want the dynamic calls to be detected. Specify Y (Yes) or N (No). The default value is Y. Specifying Y (Yes) might result in an increase in the performance cost while collecting data. If you are aware that your environment or your application does not perform dynamic program calls, specify N (No).
 14  Help
Pressing F1 for help does not save any changes made; you must press the Enter key to save changes.

Concept Concept

Feedback


Timestamp icon Last updated: Friday, 7 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///ciuug45.html