| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SET | Trace option setting | *ON, *OFF, *END | Optional, Positional 1 |
| MAXSTG | Maximum storage to use | 1-16000, 200 | Optional, Positional 2 |
| TRCFULL | Trace full | *WRAP, *STOPTRC | Optional, Positional 3 |
| DTALEN | User data length | 0-4096, 128 | Optional, Positional 4 |
| OUTPUT | Output | *PRINT, *OUTFILE | Optional |
| OUTFILE | Output file | Qualified object name | Optional |
| Qualifier 1: Output file | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| OUTMBR | Output member options | Element list | Optional |
| Element 1: Member to receive output | Name, *FIRST | ||
| Element 2: Replace or add records | *REPLACE, *ADD |
| Top |
Specifies whether an ICF trace is started, stopped, or ended.
| Top |
Specifies the maximum amount of storage (in kilobytes) to be used for generated trace records. This parameter is valid only if *ON is specified for the Trace option setting (SET) parameter.
| Top |
Specifies whether new trace records replace old trace records with new records or to stop the trace function when all of the storage specified for the Maximum storage to use (MAXSTG) parameter has been used. This parameter is valid only if *ON is specified for the Trace option setting (SET) parameter.
| Top |
Specifies the maximum length (in bytes) of user data that is traced. This parameter is valid only if *ON is specified for the Trace option setting (SET) parameter.
| Top |
Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
| Top |
Specifies the name and library of the physical file to which the trace ICF output is directed. If the database file specified already exists, its record format must match the record format of the IBM-supplied output file, QAIFTRCF.
Qualifier 1: Output file
Qualifier 2: Library
| Top |
Specifies the name of the member in the physical file that receives the trace output. If the file specified for the Output file (OUTFILE) parameter is created by the system, a member is created for the file with the name specified. If the OUTFILE exists but the OUTMBR does not, a member with the specified name will is added. This parameter is valid only if SET(*OFF) is specified.
Element 1: Member to receive output
Element 2: Replace or add records
| Top |
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.
| Top |
*ESCAPE Messages
| Top |