Working with Dumps › Formatted Displays Category › Program Call Trace › Filter Selection

Filter Selection

Filter Selection provides the CA SymDump for CICS Formatted Trace Facility user with the ability to quickly display only selected entries within a trace, making an overwhelming array of entries manageable. Use the following PF keys to control the display:

• PF4 from the Trace display displays the mask display, and allows you to modify the mask to suit your specific needs. Trace entries that match your filter criteria are displayed for your review, all others are hidden! When displaying the Filter Selection Mask using PF4, you are still within the Trace display you were in when you pressed PF4.
• PF3 or PF9 returns to where you were. If Filter Selection is in effect the new Filter values are used.

The following sample screen shows the CA SymDump for CICS Trace, in Abbreviated Mode:

--------------  CA SymDump for CICS V9.0   FORMATTED TRACE TABLE  --------------                                                    
COMMAND ===>                                             MODE: A SCROLL: PAGE                                                     
000047 00031 QR    PG 0901 PGPG  ENTRY INITIAL_LINK          ASMDEMO                                                              
000048 00031 QR    LD 0001 LDLD  ENTRY ACQUIRE_PROGRAM       200E0AF8                                                             
000049 00031 QR    LD 0002 LDLD  EXIT  ACQUIRE_PROGRAM/OK    A0D11230,20D11230,2C88,0,REUSABLE,ESDSA,OLD_COPY                     
000050 00031 QR    AP 1940 APLI  ENTRY START_PROGRAM         ASMDEMO,CEDF,FULLAPI,EXEC,NO,200431C0,00000000 , 00000000,1,NO       
000051 00031 QR    SM 0C01 SMMG  ENTRY GETMAIN               367,YES,00,TASK                                                      
000052 00031 QR    SM 0C02 SMMG  EXIT  GETMAIN/OK            00140478                                                             
000053 00031 QR    AP 00E1 EIP   ENTRY HANDLE-CONDITION                                  0004,00140488 ...h,08000204 ....         
000054 00031 QR    PG 0700 PGHM  ENTRY SET_CONDITIONS        20D13BCD,20D13BCA,001404F4,00140488,ASSEMBLER,80,AMODE31             
000055 00031 QR    PG 0701 PGHM  EXIT  SET_CONDITIONS/OK     0                                                                    
000056 00031 QR    AP 00E1 EIP   EXIT  HANDLE-CONDITION      OK                          00F4,00000000 ....,00000204 ....         
000057 00031 QR    AP 00E1 EIP   ENTRY READQ-TS                                          0004,00140488 ...h,08000A04 ....         
000058 00031 QR    TS 0C01 TSMB  ENTRY MATCH                 DEMAU052                                                             
000059 00031 QR    TS 0C02 TSMB  EXIT  MATCH/OK              ,,,DEMAU052,,00000000,,ANY,NO,NO                                     
000060 00031 QR    TS 0201 TSQR  ENTRY READ_INTO             DEMAU052,00140610 , 00000000 , 00000024,1,EXEC                       
000061 00031 QR    TS 0202 TSQR  EXIT  READ_INTO/OK          00140610 , 00000024 , 00000024,1,NO                                  
000062 00031 QR    AP 00E1 EIP   EXIT  READQ-TS              OK                          00F4,00000000 ....,00000A04 ....         
000063 00031 QR    AP 1942 APLI  *EXC* Program-Check         START_PROGRAM,ASMDEMO,CEDF,FULLAPI,EXEC,NO,200431C0,00000000 , 000000
000064 00031 QR    AP 0790 SRP   *EXC* PROGRAM_CHECK                                                                              
000065 00031 QR    DS 0010 DSBR  ENTRY INQUIRE_TASK                                                                               
000066 00031 QR    DS 0011 DSBR  EXIT  INQUIRE_TASK/OK       ESSENTIAL_YES                                                        
000067 00031 QR    DS 0002 DSAT  ENTRY CHANGE_MODE           QR                                                                   
                                                                                                                                  
PF1 Help       2            3 End         4 Mask      5 Repeat     6 Return On                                                    
PF7 Backward   8 Forward    9 All Trace  10 Left     11 Right     12 Retrieve                                                     

Important!

• If you enter a space on the first character of the task number, the filter entry is ignored. This allows you to quickly deactivate and activate entries.
• You can repeat any given filter entry by entering R(n) in column 1 of any given filter entry. Multiple filter entries are cumulative.

PFKEYS PF key assignments for the MASK display follow.

* PF1/PF13

Invoke CA SymDump for CICS HELP facility for this function.

* PF2/PF14

No function.

* PF3/PF15

Exit mask display.

* PF4/PF16

No function.

* PF5/PF17

No function.

* PF6/PF18

No function.

* PF7/PF19

No function.

* PF8/PF20

No function.

* PF9/PF21

Toggle to turn filtering on or off and exit mask display.

* PF10/PF22

No function.

* PF11/PF23

No function.

* PF12/PF24

No function.

In order to use the CA SymDump for CICS Trace effectively, it is essential that you understand the order in which the display screen is built. This is done as follows:

1. Format starts with the current line number the display is positioned on.
2. The Mode and Line overrides are applied.
3. The Filter Criteria are applied, if filtering (PF9) is turned on.
4. Any line commands such as the FIND, are then applied to the results of the previous steps.

The significance of this is that if you are trying to filter on a string that only shows up if the trace MODE is set to FULL, and you have the MODE set to ABBREVIATED, your filter will fail and no entries display. In a similar fashion, if you enter a FIND on a string that is contained only in entries that are excluded by your filter, you will not get a hit on your find even though you know that entries in the trace contain that string! Paying close attention to these issues help ensure your success with the trace.