Start of change

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.

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 

CIU7000I 5655-U86 (C) Copyright IBM Corp. 2001,2011 
F1=Help       F2=          F3=Exit       F4=Options      F5=Start           F6=Stop  13 
F7=Stats      F8=          F9=           F10=            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 or STOPPED).
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.

 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 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
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.
End of change