Using CETR HELP panels

If you press the help key (PF1), the following panels are displayed:

Figure 196. CETR transaction: HELP panel (1)
  CETR                 Help: CICS Trace control facility


   FUNCTION OF THE MAIN PANEL.

    This panel displays the current state of CICS Internal, Auxiliary
    and GTF trace and the settings of the master system and user trace
    flags.  The current values are obtained from the system on initial
    entry and subsequently every time ENTER or a PF key is pressed.
    The values can be altered by over-typing and pressing ENTER.

    The APPLID of the CICS system being queried is displayed in the top
    right corner of the screen.



   Further help information follows:

           1. Data entry and alteration.
           2. Description of fields.
           3. Function key use on the main panel.


  PF 3=End  8=Next  ENTER=End
Figure 197. CETR transaction: HELP panel (2)
  CETR                 Help: CICS Trace control facility


   (1) DATA ENTRY AND ALTERATION.

    This is achieved by simply over-typing the existing data, and then
    pressing ENTER.

    Abbreviations may be used, provided they are not ambiguous. The minimum
    possible abbreviations are listed in capitals to the right hand side of
    the input fields. For example STO may be entered for STOPPED, but ST
    would not be allowed as it could mean STARTED or STOPPED.

    Erased or blank fields will redisplay the current level settings as
    known to CICS. These will be the levels current when ENTER was last
    pressed.  They may have been changed from the previously displayed
    values by other activity in the system.

    All input will be validated when ENTER is pressed, and no internal
    settings will be made until all errors have been removed.



  PF 3=End  7=Back  8=Next  ENTER=End
Figure 198. CETR transaction: HELP panel (3)
  CETR                 Help: CICS Trace control facility

   (2) DESCRIPTION OF FIELDS.

   The values that can be set from the main panel are:-

    Internal Trace Status     -  Whether tracing to the main storage trace
                                 table is required.
    Internal Trace Table Size -  The size of the main storage trace table.
    Auxiliary Trace Status    -  Whether tracing to the current auxiliary trace
                                 data set is required.
    Auxiliary Trace Dataset   -  The current data set. A = DFHAUXT, B = DFHBUXT.
    Auxiliary Switch Status   -  Whether a switch to the alternate extent is
                                 required at next or all end-of-extents.
    GTF Trace Status          -  Whether CICS is writing its trace data to GTF.
                                 Note that GTF must have been started to MVS.
    Master System Trace Flag  -  This flag must be on if CICS system-requested
                                 entries are to be written for STANDARD tracing
                                 tasks.
    Master User Trace Flag    -  This flag must be on if user-requested trace
                                 entries are to be produced.


  PF 3=End  7=Back  8=Next  ENTER=End
Figure 199. CETR transaction: HELP panel (4)
  CETR                 Help: CICS Trace control facility


   (3) FUNCTION KEY USE ON THE MAIN PANEL.

           Key     Name        Function

           ENTER   Change      Execute any changes.
           PF1     Help        Display this help information.
           PF3     Quit        Terminate the transaction.
           PF4     Components  Display or set STANDARD or SPECIAL trace levels
                               for individual CICS components.
           PF5     Ter/Trn     Query or set current trace status for terminal  
                               or transaction.
           PF6     JVM         Query or set current JVM trace options  
           PF9     Messages    Display any messages created, these can be
                               warning (informative) messages, or errors.







  PF 3=End  7=Back  ENTER=End

HELP panels for components

If you press the help key (PF1) while viewing the component trace options screen, the following panels are displayed:

Figure 200. CETR transaction: Component trace HELP panel (1)
  CETR             Help: CICS Component Trace

    FUNCTION OF THE COMPONENT TRACE PANEL

     The component trace panel is used to inquire and set the STANDARD and
     SPECIAL trace levels for the individual components of the CICS system.

     Every component of CICS has a number of trace points.  Associated with
     each is a trace level.  These levels are numbers from one to thirty-two.
     For the trace entry associated with the trace point to be made, the
     associated level must be active (except for exception traces).

     Each CICS task is either a STANDARD tracing task or a SPECIAL tracing
     task.  This distinction is made at task attach time when the STANDARD or
     SPECIAL attributes of the terminal id and transaction id are examined.
     These can be set on the Terminal and Transaction Trace panel of CETR.

    Further help information follows:
          1. Data entry and alteration 1
          2. Data entry and alteration 2
          3. Meanings of Component abbreviations.
          4. Function key use on the component trace panels.

  PF 3=End  8=Next  ENTER=End
Figure 201. CETR transaction: Component trace HELP panel (2)
  CETR             Help: CICS Component Trace

   (1) DATA ENTRY AND ALTERATION 1

   From this panel detailed tracing levels can be set for each component.
   Each level is specified by a number between one and three, the
   presence of the number indicates that the level is set, the omission
   of a number indicates that the level is not set.

   Multiple consecutive levels are displayed as xx-yy, where xx is the
   lower of the consecutive values, and yy is the higher.  For example,
   if 1-3 was displayed, then trace levels 1,2 and 3 would all be set.

   There is more than one page of components.  Function keys PF7 and PF8
   can be used in the usual way to switch pages. The page may only be
   switched when the displayed page contains no errors.

   Changes to the level settings are automatically validated when the
   current page is changed, but these levels are only set within CICS when
   ENTER is pressed. Until this time it is possible to quit from the
   program (PF3) without altering internal values.


  PF 3=End  7=Back  8=Next  ENTER=End
Figure 202. CETR transaction: Component trace HELP panel (3)
  CETR             Help: CICS Component Trace

   (2) DATA ENTRY AND ALTERATION 2

   The level settings may be changed by simply over-typing the existing
   data and then pressing ENTER.

   To set a single level enter the number. To set consecutive levels
   enter the first and last levels separated by a hyphen.

   Erased or blank fields will redisplay the current level settings as
   known to CICS. These will be the levels set when ENTER was last pressed.

   All levels may be set by entering ALL and none by entering OFF.

   To provide identical level settings for more than one component:
    - type the setting(s) for the first component, do not press ENTER.
    - type  =  in fields where you want this setting duplicated.

   NOTE: Although levels up to 32 may be set for most components, only
         levels 1,2 and 3 are currently used.


  PF 3=End  7=Back  8=Next  ENTER=End
Figure 203. CETR transaction: Component trace HELP panel (4)
  CETR             Help: CICS Component Trace

   (3) MEANINGS OF COMPONENT ABBREVIATIONS.

   AP . . . Application domain            IE . . . ECI over TCP/IP domain       
   BA . . . Business Application Manager  II . . . IIOP domain                  
   BM . . . Basic Mapping Support         IS . . . ISC                          
   BR . . . Bridge                        KC . . . Task Control                 
   CP . . . CPI-C interface               KE . . . Kernel                       
   DC . . . Dump compatibility layer      LC . . . Local Catalog domain         
   DD . . . Directory manager             LD . . . Loader domain                
   DH . . . Document Handler domain       LG . . . Log Manager domain           
   DM . . . Domain Manager domain         LM . . . Lock Manager domain          
   DP . . . Debugging Profiles domain     ME . . . Message domain               
   DS . . . Dispatcher domain             MN . . . Monitoring domain            
   DU . . . Dump domain                   NQ . . . Enqueue Manager              
   EI . . . Exec interface                OT . . . Object Transaction domain    
   EJ . . . Enterprise Java domain        PA . . . Parameter Manager            
   EM . . . Event Manager domain          PC . . . Program control              
   FC . . . File control                  PG . . . Program Manager domain       
   GC . . . Global Catalog domain         Start of changePI . . . Pipeline Manager domainEnd of change      
   IC . . . Interval control              PT . . . Partner Management           

   PF 3=End  7=Back  8=Next  ENTER=End
Figure 204. CETR transaction: Component trace HELP panel (5)
  CETR             Help: CICS Component Trace

   (4) MEANINGS OF COMPONENT ABBREVIATIONS.

   RI . . . RMI                           WB . . . Web Domain                   
   RM . . . Recovery Manager              XM . . . Transaction manager          
   RX . . . RRMS domain                   XS . . . Security domain              
   RZ . . . Request Streams                                                     
   SC . . . Storage control                                                     
   SH . . . Scheduler Services domain                                           
   SJ . . . JVM domain                                                          
   SM . . . Storage manager domain                                              
   SO . . . Sockets domain                                                      
   ST . . . Statistics domain                                                   
   SZ . . . Front End Prog Interface                                            
   TC . . . Terminal control                                                    
   TD . . . Transient data                                                      
   TI . . . Timer domain                                                        
   TR . . . Trace domain                                                        
   TS . . . Temporary storage                                                   
   UE . . . User exit interface                                                 
   US . . . User domain                                                         

   PF 3=End  7=Back  8=Next  ENTER=End
Figure 205. CETR transaction: Component trace HELP panel (6)
  CETR             Help: CICS Component Trace

   (5) FUNCTION KEY USE ON THE COMPONENT TRACE PANELS.

           Key     Name       Function

           ENTER   Change     Execute any Changes.
           PF1     Help       Display this help information.
           PF3     Quit       Return to main Trace Control panel.
           PF7     Backward   Scroll backward one page.
           PF8     Forward    Scroll forward one page.
           PF9     Messages   Display any messages created,
                              these can be warning
                              (informative) messages, or errors.









  PF 3=End  7=Back  ENTER=End

HELP panels for terminal and transaction trace

If you press the help key (PF1) while viewing the terminal and transaction trace screen, the following panels are displayed:

Figure 206. CETR transaction: Terminal and transaction HELP panel (1)
  CETR                 Help: CICS Terminal and Transaction Trace

   FUNCTION OF THE TERMINAL AND TRANSACTION PANEL.

    This panel has two main functions.

    (1) To allow STANDARD/SPECIAL tracing to be set for tasks to be run from
        particular terminals or with particular transaction ids.  It is also
        possible to suppress tracing for particular transaction ids.
        STANDARD tracing tasks use the STANDARD component flags.
        SPECIAL tracing tasks use the SPECIAL component flags.
        See the help information for the component panel for more detail.

    (2) To allow the setting of VTAM EXIT and ZCP tracing.

    The current settings will be displayed if transaction id, terminal id
    or netname are specified without other values.

    Further help information follows:
           1. VTAM EXIT trace.
           2. ZCP trace.
           3. Function key use on the terminal and transaction panel.

  PF 3=End  8=Next  ENTER=End
Figure 207. CETR transaction: Terminal and transaction HELP panel (2)
  CETR                 Help: CICS Terminal and Transaction Trace

   (1) VTAM EXIT trace.

       CICS VTAM EXIT tracing consists of entries on GTF made by the CICS
       supplied VTAM exits that run asynchronously with the rest of CICS.
       The exits that are related directly to a particular terminal have their
       tracing activated by specifying the terminal id and/or netname and
       setting ON in the Terminal VTAM Exit Trace field.

       There are also non-terminal related exits for which tracing is enabled by
       specifying SYSTEM in the VTAM Exit override field.  A setting of ALL in
       the exit override field will turn on exit tracing for all non-terminal
       exits, and for all terminal exits for all terminals.

   NOTES:
    (a) Setting trace for any terminal related exit will also turn on trace of
        all non-terminal related exits.
    (b) CICS GTF tracing need not be STARTED (main panel) to use this facility.
    (c) An unknown netname is assumed to be an autoinstall terminal.
    (d) Pressing PF6 cancels all tracing from all exits.
    (e) Connection name in the termid field causes setting of all sessions.

  PF 3=End  7=Back  8=Next  ENTER=End
Figure 208. CETR transaction: Terminal and transaction HELP panel (3)
  CETR                 Help: CICS Terminal and Transaction Trace

   (2) ZCP TRACE

       ZCP trace is the activate scan trace facility.  Turning it on
       for a particular terminal means that the activate scan routine
       of the terminal control program (DFHZCP) will start to monitor
       the activate scan queue for the Terminal Control Table Terminal
       Entry (TCTTE) for that terminal.

       When the TCTTE is found, indicating that there is activity on the
       terminal, a trace entry is made for the activate scan ZCP routine.











  PF 3=End  7=Back  8=Next  ENTER=End
Figure 209. CETR transaction: Terminal and transaction HELP panel (4)
  CETR                 Help: CICS Terminal and Transaction Trace

   (3) FUNCTION KEY USE ON THE TERMINAL AND TRANSACTION PANEL.

           Key     Name       Function

           ENTER   Change     Execute any Changes.
           PF1     Help       Display this help information.
           PF3     Quit       Return to main Trace Control panel.
           PF6     Cancel     Cancel all exit tracing. This turns off
                              VTAM EXIT tracing for all terminals and
                              for all the non-terminal EXITs.
           PF9     Messages   Display any messages created.











  PF 3=End  7=Back  ENTER=End

HELP panels for JVM trace options

If you press the help key (PF1) while viewing any of the JVM trace options screens, the following panels are displayed:

Figure 210. CETR transaction: JVM trace options HELP panel (1)
CETR               Help: JVM Trace Options                                      
                                                                                
    FUNCTION OF THE JVM TRACE OPTIONS PANEL                                     
    
     The JVM Trace Options panel is used to inquire and set the STANDARD and    
     SPECIAL trace levels for tracing the JVM in the CICS system. It also       
     allows setting of the JVM Trace Options used for each trace level.         
                                                                                
     There are 4 trace levels defined, LEVEL 0, LEVEL 1, LEVEL 2 and USER.      
     LEVEL 0, LEVEL 1 and LEVEL 2 are intended to correspond to trace levels    
     0, 1, and 2 for JVMs, and the USER level can be used to specify deeper     
     levels of tracing or complex trace options.                                
                                                                                
     The default value for these options can be overridden by SIT parameters:   
     JVMLEVEL0TRACE, JVMLEVEL1TRACE, JVMLEVEL2TRACE and JVMUSERTRACE.           
                                                                                
    Further help information follows:                                           
          1. Data entry and alteration                                          
          2. Function key use on the JVM Trace Options panels. 
                                                                                
  PF 3=End  8=Next  ENTER=End   
Figure 211. CETR transaction: JVM trace options HELP panel (2)
CETR             Help: JVM Trace Options                                      
                                                                                
   (1) DATA ENTRY AND ALTERATION                                                
                                                                                
   The fields are spread over 2 screens, Level 0 and 1 on the first and         
   Level 2 and User on the second screen.  PF7 and PF8 are used to move         
   between them.  The page may only be switched when the displayed page         
   contains no errors.                                                          
                                                                                
   For each level of tracing there are 2 ON / OFF fields to set tracing         
   for STANDARD and SPECIAL transactions.                                       
                                                                                
   There is a 240 character "free-form" field to set the JVM Trace Options      
   to use.  The meaning of these options is defined by documentation for        
   the JVM.  PF6 can be used to reset all the Trace Option fields               
   to the CICS defined default values.                                           

   Changes to the ON / OFF fields are validated when the current page           
   is changed, but all values are only set within CICS when ENTER               
   is pressed. Until this time it is possible to quit from the program          
   (PF3) without altering internal values.                                      
                                                                                
                                                                                
  PF 3=End  7=Back  8=Next  ENTER=End  
Figure 212. CETR transaction: JVM trace options HELP panel (3)
CETR             Help: JVM Trace Options                                      
                                                                                
   (2) FUNCTION KEY USE ON THE JVM TRACE OPTIONS PANELS.                        
                                                                                
           Key     Name       Function                                          
                                                                                
           ENTER   Change     Execute any Changes.                              
           PF1     Help       Display this help information.                    
           PF3     Quit       Return to main Trace Control panel.               
           PF6     Reset      Set all Option strings back to                    
                              default values.                                   
           PF7     Backward   Scroll backward one page.                         
           PF8     Forward    Scroll forward one page.                          
           PF9     Messages   Display any messages created,                     
                              these can be warning                              
                              (informative) messages, or errors.                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
  PF 3=End  7=Back  ENTER=End  

Related tasks
Using CICS supplied transactions
CETR--trace control
Using component trace options
Using Transaction and terminal-related trace options
Using JVM trace options
[[ Contents Previous Page | Next Page Index ]]