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.
  • Configure the initial part of the Command Flow data collection options.
  • Show information about the current state of the CINC collector.
  • 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.
  • Display the CICS IA Command Flow Application Data Collection panel, CIUA0A, to view or change the Application Data collection options.

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   IYDZT51B 
 
Command Flow state  .  .  .  . :  STOPPED                2             
Date/Time of last start.  .  . : 2014/03/22 03:15:34PM   3     
Date/Time of last stop .  .  . : 2014/03/22 03:15:48PM   4  
  
Command Flow Id  .  .  .  .  . : MYCMDID           5 

Traced user USERIDs .  .  .  . : CICSUSER           6  CINC Authority: GENERAL   8 
Traced terminal TermIDs.  .  . : *___               7  
                   
Traced transaction IDs .  .  . : TWEB TR*  T+AN TR%N T++N  (Max 5 transact. IDs)      9 
Exclude lists .  .  .  .  .  . : Transaction               Program             10 
User Journal Name.  .  .  .  . : CIUMTJNL            11 
Journal Copy Criteria  .  .  . : LAST     (LAST, USER or CFID)      12 
User Exit Name.  .  .  .  .  . : _________                           13 
Dynamic Call  .  .  .  .  .  . : Y             (Yes/No)              14 
Tasks before Stopping  .  .  . : 0             (0-9999)              15 
Records before Stopping.  .  . : 0             (0-9999999)           16   


CIU7000I 5655-Y22 (C) Copyright IBM Corp. 2001,2014 
F1=Help       F2=          F3=Exit       F4=Options      F5=Start           F6=Stop  17 
F7=Stats      F8=          F9=           F10=Applications  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 ID associated with CICS transactions, for which you want to collect the Command Flow data.
Note: A PRIVELEGED CINC User can use %, +, and Wildcard *. Wildcard * can be used only as a suffix.

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

 8  The CINC user can be defined as a GENERAL user or a PRIVILEGED user. PRIVILEGED users can use wildcards to collect data for more than one user ID. The default value is General.

 9  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.

 10  The names for program and transaction exclude lists that are to be used by command flow collector. The exclude list format is the same with Dependency/Affinity collector (CINT). If the transaction name in the list of collected transactions does not contain wildcards, the transaction exclude list will not be applied to it.

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

 12  The LAST, USER or CFID criteria:
  • LAST specifies that the CIUJLCPY job must copy Command Flow records collected at the last Command Flow run.
  • USER specifies that the CIUJLCPY job must copy all the Command Flow records for the USER.
  • CFID specifies that the CIUJLCPY job must copy the Command Flow records that were collected for a specified Command Flow ID.

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

Start of change 14  Capturing the dynamic calls. Specify Y (Yes) or not N (No). The default value of this field is Y. The Y value instructs the IA collector to use a special CICS TS XPI, IDENTIFY_PROGRAM, to identify the program name. If a command is detected and that command belongs to a program that is not known to CICS TS, CICS TS returns the name of the top-level program instead. In this case, IA collector records the top-level program name and marks the record with -1 (X’FFFFFFFF’) as a command offset.End of change

 15  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.

 16  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.

 17  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
Note:
  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.
  3. Natural programs control flow is collected if SYSRDC exit is active and scheduled at least once. It is recommended to use CIUXPROG exclude list to exclude unnecessary entries from the Command Flow collection.

  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.