Starting the collection of data

You can start collecting dependency data, affinity data or both on a particular region only when the Collector is stopped on that region.

To start collecting data on a specified CICS® region, use one of the methods shown in Methods for starting data collection by the Collector.

Table 1. Methods for starting data collection by the Collector
Where 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:
  1. If you enter action code 1 against a CICS region, you are asked to confirm that you want the Collector to start recording data.
  2. 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.
  3. The start options are:
    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.
  4. cicsjob is the name of your CICS startup job. The <startup_options> are as described for the CINT command issued from a 3270 terminal, under  3  above.
  5. 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 <startup_options> are as described under  3  above. 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.

Using one of the methods listed in Methods for starting data collection by the Collector causes the Collector to record transaction dependencies or affinities, until you pause or stop data collection.

On each region, the data that is collected depends on:
  1. The start option (START, STARTAFF, STARTINT, STARTALLAFF, and so on) that you specify, as noted above.
  2. 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.

Concept Concept

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


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