| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Trace Common Programming Interface Communications (TRCCPIC) command controls tracing of all CPI Communications that occur in the job in which the command is entered. The command sets a trace on or off, and traces (1) CPI Communications calls issued by a program and (2) data that is sent and received.
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 TRCCPIC 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, QACM0TRC. (2) The user must have specific authority from the security officer to use this command.
| 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 a CPI Communications trace is started or ended.
The possible values are:
| Top |
Specifies the maximum amount of storage (in kilobytes) used for the created trace records.
The possible values are:
| Top |
Specifies the action taken when the maximum storage specified is full.
The possible values are:
| Top |
Specifies the maximum length (in bytes) of user data that can be saved for each trace entry in the storage area. If the value specified is greater than the length of data received or sent across the communications line, only the actual data is traced. If the value specified is less than the data length received or sent, only the data length specified on this parameter is traced.
The possible values are:
| Top |
Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
The possible values are:
| Top |
Specifies the qualified name of the physical file to which the trace output is directed. If the file already exists, the system uses it. If the file does not exist, the system creates it. If the file is created, the text is "Output file for TRCCPIC." The possible library values are:
| Top |
Specifies the name of the member in the physical file that receives the trace output. If the file is created by the system, a member is created with the name specified on this parameter. If the file exists but the member does not, a member with the specified name is created.
Element 1: Member to Receive Output
Element 2: Operation to Perform on Member
| Top |
Example 1: Starting Trace Operation
TRCCPIC MAXSTG(350) DTALEN(256)
This command traces the CPI Communications calls of the current job. The trace file contains 350KB 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
TRCCPIC SET(*OFF) OUTPUT(*OUTFILE) OUTFILE(TRACELIB/CPICTRACE)
OUTMBR(TRACEMBR)
This command stops the trace and directs the output to the database file CPICTRACE in library TRACELIB. The output is directed to the member TRACEMBR.
| Top |
*ESCAPE Messages
| Top |