The Region Configuration Menu panel is used for specifying general region-specific options.
CIU260 CICS Interdependency Analyzer for z/OS -V3R2M0
2011/02/03 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 Inquire for DB2 resources. . : Y (Y=Yes, N=No) 4 Restore data on start . . . : Y (Y=Yes, N=No) 5 Multiple signon with same id : N (Y=Yes, N=No) 6 Maintain usage counts . . . : Y (Y=Yes, N=No) 7 Size of dataspace . . . . . : 16 (10 to 2000 MB) 8 Transid prefix (optional). . : ____ (1 to 4 characters) 9 Program exclude list . . . . : CIUXPROG (1 to 8 characters) 10 Transaction exclude list . . : CIUXTRAN (1 to 8 characters) 11 Resource prefix list . . . . : CIUPFXTB (1 to 8 characters) 12
TRUEs Include list . . . . . : CIUXITTB (1 to 8 characters)
13
Dynamic call . . . . . . . . : (Y=Yes, N=No)
14 CICS Sysid: Z32B CICS Applid: IYCYZC44 TermID: TC56 F1=Help 15 F2= F3=Exit F4= F5= F6= F7= F8= F9= F10= F11= F12=Cancel
Notes:
1 Data to Collect
2 Perform periodic saves
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 Inquire for DB2® resources
Enter a value of Y for YES and N for NO. If set to YES, the SYSIBM.SYSPACKSTMT and SYSIBM.SYSSTMT tables are queried to obtain further information. The default is Y.
5 Restore data on start
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.
6 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.
7 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.
8 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.
9 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.
10 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.
11 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.
12 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.
13 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. For
information about how to create your own TRUE include list, see Creating your own TRUE include list.
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).
15 Help
Pressing F1 for help does not save any changes made; you must press the Enter key to save changes.