If the CICS® IA Collector is
not already running in a specific region, you can start collecting
dependency data, affinity data, or both on that region. Only one CICS IA Collector can
run on each CICS region.
To start collecting data on a specified CICS region, use one of the methods shown in Methods to start data collection by the Collector.
The Collector records
transaction dependencies or affinities until you pause or stop data
collection.
Table 1. Methods
to start data collection by the CollectorWhere used |
Command or function key |
CINT transaction Operations Menu, CIU100 |
Type 1 against a listed CICS APPLID and press Enter, to
start the Collector on
the specified region. 1 |
CINT transaction Operations Menu, CIU100 |
If more than one CICS region
is listed on the Operations Menu, you can type 1 against
the first CICS APPLID in the
list ("ALL") and press Enter to start the Collector on
all the regions. 2 |
3270 terminal |
CINT <start_options> 3 |
Console |
F cicsjob, CINT <start_options> 4 |
Application program |
EXEC CICS START TRANSID('CINT') FROM('<start_options>') 5 |
Note: - If you enter action code 1 against a CICS region, you are asked to confirm that you
want the Collector to
start recording data.
- If you enter action code 1 against ALL,
you are asked to confirm that you want the Collector to
start recording data on all the regions.
- The start options are as follows:
- START
- Starts the Collector on
the local CICS region; that
is, the region to which the 3270 terminal is connected. The type of
data collected (interdependency or affinity) depends on what you have
specified for the Data to Collect region-specific
option on the Collector General
Options screen, CIU260, shown in Collector General
Options screen, CIU260.
- STARTALL
- Starts the Collectors on
all the monitored CICS regions.
For each region, the type of data collected depends on what you have
specified for the Data to Collect region-specific
option on the Collector General
Options screen, CIU260.
- STARTAFF
- Starts the collection of affinity data on the local CICS region. This command overrides what you
have specified for the Data to Collect region-specific
option. In other words, even if you have specified the type of Data
to Collect as interdependency, the CINT STARTAFF command
causes affinity, not interdependency, data to be collected.
- STARTALLAFF
- Starts the collection of affinity data on all the monitored CICS regions. This command overrides
what you have specified, for each region, on the Data to Collect region-specific
option. In other words, even if, for some regions, you have specified
the type of Data to Collect as interdependency, the
CINT STARTALLAFF command causes affinity data to be collected on all
the regions.
- STARTINT
- Starts the collection of interdependency data on the local CICS region. This command overrides
what you have specified for the Data to Collect region-specific
option. In other words, even if you have specified the type of Data
to Collect as affinity, the CINT STARTINT command causes
interdependency, not affinity, data to be collected.
- STARTALLINT
- Starts the collection of interdependency data on all the monitored CICS regions. This command overrides
what you have specified, for each region, on the Data to Collect region-specific
option. In other words, even if, for some regions, you have specified
the type of Data to Collect as affinity, the CINT
STARTALLINT command causes interdependency data to be collected on
all the regions.
- STARTBOTH
- Starts the collection of both affinity data and interdependency
data on the local CICS region.
This command overrides what you have specified for the Data
to Collect region-specific option. In other words,
even if you have specified the type of Data to Collect as
affinity, the CINT STARTBOTH command causes both affinity data and
interdependency data to be collected.
- STARTALLBOTH
- Starts the collection of both affinity data and interdependency
data on all the monitored CICS regions.
This command overrides what you have specified for the Data
to Collect option in each region. In other words,
even if you have specified, for each region, the type of Data
to Collect as affinity, the CINT STARTALLBOTH command
causes both affinity data and interdependency data to be collected
for all the regions.
- cicsjob is the name of your CICS startup job. The <start_options>
are described in note 3 .
- This command, issued from a program initiated during
the third stage of CICS initialization
(that is, a program specified in the second part of the PLTPI list
for the CICS region), starts
the Collector during CICS initialization. The <start_options>
are described in note 3 . A PLTPI program
to start the Collector, CIUSTART,
is supplied with CICS IA. For
more information, see Starting and
stopping CICS IA from the PLT.
On each region, the data that is collected depends on
the following options:
- The start option (such as START, STARTAFF, STARTINT, or STARTALLAFF)
that you specify, as listed earlier.
- The region-specific options that you specify. For example, if
you are collecting dependency data, data is collected only for the
(CICS and non-CICS) API commands
that you choose to be monitored (by specifying Y for the command type
on the CICS Resources Options
screen, CIU240, and the DB2/MQ/IMS/RMI Trace Resource
Options screen, CIU250. See Collector CICS Resources Options screen,
CIU240 and Collector DB2/MQ/IMS
Resource Options screen, CIU250).
Similarly, if
you are collecting affinity data, data is collected only for the CICS API commands that you choose
to be monitored (by specifying Y for the command type on the CICS Affinities Options screen,
CIU270. See Collector Affinities
Options screen, CIU270).
In addition, data
collection is filtered by the region-specific options that you set
on the General Options screen, CIU260. See "Transid prefix", "Program
exclude list", and "Transaction exclude list", under Specifying region-specific options: general.
For a complete list of the program commands that are not
monitored, see What is not monitored.
Each time the Collector is
started, a new data space is created. You specify its size on the Collector's Regional
Resource Options screen, CIU260—see Collector General
Options screen, CIU260. You can also specify that data
from the VSAM dependency or affinity files (for example, from previous CICS IA runs)
is to be loaded into the data space when it is created. For more information
about the Regional Resource Options screen, see Specifying region-specific options.
Note: If there are a large number of data records to be loaded into
the data space when it is created (for example, from previous CICS IA runs),
the Operations Menu screen might be frozen for some appreciable
time, until the records have been loaded.