CL Command Reference - TRCICF
CL Command List > TRCICF Reference
Description:
The Trace Intersystems Communications Functions (TRCICF) command is used to start and stop the tracing of language operations and Intersystem Communications Functions (ICF) issued by your program. TRCICF can be started from the command entry display or from a CL program.
As trace records are collected, they are stored in an internal trace storage area. When the trace is ended, the trace records can be directed to a spooled output file or a database physical file.
If the Start Service Job (STRSRVJOB) command is entered before the TRCICF command, the job that is traced is the one specified on the STRSRVJOB command. The trace output from the serviced job is returned to the servicing job after the trace is set off or after the serviced job has ended.
Restrictions:
1. The record format of the database output file must match the record format of the IBM-supplied output file, QAIFTRCF.
2. The user must have specific authority from the security officer to use this command.
Examples:
Example 1: Starting Trace Operation
TRCICF MAXSTG(350) DTALEN(256)
This command traces the ICF input/output operations of the current job. The trace file contains 350K of storage and wraps to the beginning if that amount of storage is filled with trace records. In addition, this command traces up to 256 bytes of user data on each input/output operation.
Example 2: Stopping Trace Operation
TRCICF SET(*OFF) OUTPUT(*OUTFILE) OUTFILE(TRACELIB/ICFTRACE) OUTMBR(TRACEMBR)
This command stops the trace and directs the output to the database file ICFTRACE in library TRACELIB. The output is directed to the member TRACEMBR.