Displaying the CICS IA Command Flow Options panel

With the CICS® IA Command Flow Options panel you can control the Command Flow data collection.

About this task

You can use the CICS IA Command Flow Options panel to perform the following tasks:
  • Start and stop the collection of the Command Flow data in the selected region or regions.
  • Submit the batch jobs for loading some predefined data sets (GDG, CSV) and DB2® tables, or flushing data sets (LogStream). (This option is reserved for future use.)
  • Configure the initial part of the Command Flow data collection options.
  • Show information about the current state of the CINC collector.
  • Show the start (and stop) date and time of the last data collection and last Command Flow data loading into GDG. (This option is reserved for future use.)
  • Display the CICS IA Command Flow ApplID list panel, CIUA02, which helps you to configure the second part of the Command Flow data collection options.
  • Display the CICS IA User Command Flow Statistics panel, CIUA03, which helps you to view the Command Flow data statistics for all the regions from the user's regions configuration.
  • Start of changeDisplay the CICS IA Command Flow Application Data Collection panel, CIUA0A, to view or change the Application Data collection options.End of change

Procedure

  1. At a CICS terminal, type the transaction identifier CINC.
  2. Press Enter. Panel CIUA01 is displayed; see Figure 1.

Figure 1. Command Flow Options panel, CIUA01
CIUA01           CICS IA Command Flow Options         1  ApplID   IYDZZ41A 
 
Command Flow state  .  .  .  . :  STOPPED                2             
Date/Time of last start.  .  . : 2011/03/25 09:16:18PM   3     
Date/Time of last stop .  .  . : 2011/03/25 09:17:36PM   4  
  
Command Flow Id  .  .  .  .  . : TESTUSR1           5 

UserID  .  .  .  .  .  .  .  . : CICSUSER           6  
TermID  .  .  .  .  .  .  .  . : *___               7  
                   
Transaction list .  .  .  .  . : TWEB TSTC          8 
                                          (Up to 5 transaction IDs) 
User Journal Name.  .  .  .  . : CIUMTJNL            9 

Journal Copy Criteria  .  .  . : LAST     (LAST, USER or CFID)      10 

User Exit Name.  .  .  .  .  . : _________                           11 
Dynamic Call  .  .  .  .  .  . : Y             (Yes/No)              12 
Tasks before Stopping  .  .  . : 0             (0-9999)              13 
Records before Stopping.  .  . : 0             (0-9999999)           14   


CIU7000I 5655-Y22 (C) Copyright IBM Corp. 2001,2012 
F1=Help       F2=          F3=Exit       F4=Options      F5=Start           F6=Stop  15 
F7=Stats      F8=          F9=           F10=Applications  16            F11=               F12=Cancel    

The meaning of each part of the CICS IA Command Flow Options panel, CIUA01, is as follows:

 1  The 8-character APPLID of the CICS region on which the CICS IA Command Flow Utility is running.

 2  The current state of the Command Flow data collection process on all the regions for the user's regions configuration:
RUNNING
The Command Flow Collector is running on all the regions.
PARTLY STA
The Command Flow Collector is running on some of the regions.
STOPPED
The Command Flow Collector is stopped on all the regions
START FAIL
An error was detected during the Command Flow Collector start process.
STOP FAIL
An error was detected during the Command Flow Collector stop process.
INCOMPLETE
The Command Flow start (or stop) process was not completed. Press F6 (stop) to reset this status.
NO APPLIDS
The Command Flow APPLID list is empty.

 3  The date and time when the Command Flow data collection process was last started. The time shown is the local time, and the date is given in the format specified by the Global Options Menu panel of the CINT transaction.

 4  The date and time when the Command Flow data collection process was last stopped. The time shown is the local time, and the date is given in the format specified by the Global Options Menu panel of the CINT transaction.

 5  The name of the Command Flow trace that is to be captured.

 6  The user identifier associated with CICS transactions, for which you want to collect the Command Flow data.
Note: Wildcard * is not allowed in the user ID field. The CICS IA Command Flow utility allows you to capture CICS, DB2, MQ, and IMS commands in a chronological order for one or more transactions. You can capture information for you given transaction or transactions. You can also individually load and view the data that you have captured.

 7  The terminal identifier associated with CICS transactions, for which you want to collect the Command Flow data.

 8  The list of transaction identifiers, for which you want to collect the Command Flow data. You can enter up to five transaction IDs and you can use wildcard characters.

 9  The journal name for trace data. The length of the name can be up to 8 characters. The default journal name is CIUMTJNL.

 10  The LAST, USER or CFID criteria:

 11  The 8-character user modifiable exit name that you can use to add data to a user Command Flow records.

 12  Capturing the dynamic calls. Specify Y (Yes) or not N (No). The default value of this field is Y.

 13  The number of CICS tasks processed before stopping the collector. The default value of this field is 0. This value is used to indicate that there is no limit to the number of tasks for which command flow data is collected.

 14  The number of CICS IA journal records collected before stopping. The default value of this field is 0. This value is used to indicate that there is no limit to the number of journal records collected.

 15  The control keys that you can use to select functions that control the operation of the CICS IA User Command Flow Utility and provide help information about it. Actions are summarized in Table 1.
Table 1. The User Command Flow Utility control keys on the Command Flow Options panel
Action Function key
Getting help information about the CICS IA User Command Flow Utility. F1
Starting the Command Flow data collection. The data collecting is started for all the CICS regions from the user's regions configuration of the CICS IA User Command Flow Utility. All the changed user command flow options are saved. F5
Stopping collecting Command Flow data on all the CICS regions from the user regions configuration. F6
Displaying the statistics of the Command Flow data collection on all the CICS regions from the user's regions configuration. (The CICS IA User Command Flow Statistics panel, CIUA03, is displayed.) F7
Accessing to the second part of the Command Flow options in order to view or change it. (The CICS IA Command Flow ApplID list panel, CIUA02, is displayed.) This function does not preserve the Command Flow options changes made on the CIUA01 panel. F4
Saving all the changed Command Flow options and returning to CICS.
Note: The changes of the Command Flow options are rejected if the Command Flow Collector is running.
F3
Saving all the changed Command Flow options without returning to CICS.
Note: The changes of the Command Flow options are rejected if the Command Flow Collector is running.
Enter
Returning to CICS without saving any changed Command Flow options. F12
Accessing Application Data collection options in order to view or change them. The CICS IA Command Flow Application Data Collection panel, CIUA0A, is displayed.
Note: This function does not preserve the Command Flow options changes made on the CIUA01 panel.
F10

 16  Accessing Application Data collection options to view or change them. (The CICS IA Command Flow Application Data Collection panel, CIUA0A, is displayed.) This function does not preserve the Command Flow options changes made on the CIUA01 panel.

Notes:
  1. Multiple users on the same CICS region can use the CICS IA Command Flow Utility concurrently. The current state of the CINC collector represents personal working status of the Command Flow data collection process for every user associated with the CINC transaction. The information about the current state includes working status itself (running or stopped) and the date and time when the Command Flow data collection process was last started by a user. (This option is reserved for future use.)
  2. You can start the collection of the Command Flow data only when the current state of the CINC collector is stopped for you. The type of the data collected depends on what you have specified for the Command Flow options on the CICS IA Command Flow Options and CICS IA Command Flow ApplID list panels.

  1. Press F3 (or F12) to close the CICS IA Command Flow Options panel. Closing the panel does not affect the state of the CINC collector.

Task Task

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


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