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
Dump HLQ . . . . . . . . . . : DUMPHLQ1 (1 to 8 characters)
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
- 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.
13 Dump HLQ 
This field is used to define the high-level qualifier for CICS
IA dump data set that will be produced. 
- 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.