CL Command Reference - ADDTRCFTR
CL Command List > ADDTRCFTR Reference
Description:
The Add Trace Filter (ADDTRCFTR) command adds a new trace filter to the system. A trace filter identifies the trace flow (call/return) data that is to be collected during a trace session, and is meant to limit the amount of data collected by specifying a compare value. If the data in the trace record matches the compare value, then the data will be collected. If not, the data is discarded. The filter is specified on the STRTRC (Start Trace) command.
Restrictions:
. You must have service (*SERVICE) special authority, or be authorized to the Service trace function of Operating System through iSeries Navigator¡¯s Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform trace operations.
Examples:
Example 1: Adding a Trace Filter for a Program Trigger
ADDTRCFTR FTR(PGMFTR)
PGMTRG(MYLIB/MYPGM MYMODL *PEP *PGM *ENTRY)
This command adds a new trace filter named PGMFTR. If this filter is used in the Start Trace (STRTRC) command, the collection of data will begin when the program entry of MYMODL module of MYPGM is called.