Trace full

1-16000 K

The valid range for the maximum number of bytes used for storing collected trace information.

Specifies whether new trace records replace old trace records or whether the trace is stopped when the maximum storage that you specified has been reached. This prompt appears only if you have selected *ON for the Trace option setting prompt.

*WRAP

When the trace storage area is full, new trace information is written over the old trace information, starting at the beginning of the storage area. This is the default value.

*STOPTRC

No new trace information is saved when the trace storage area is full. You must reissue the TRCCPIC command, specifying (*OFF) for the SET parameter, to retrieve the output of the trace information collected in the trace storage area.

User data length

Specifies the maximum length of user data to be saved for each trace record in the storage area. This prompt affects only the tracing of user data on the Send_Data and Receive calls. This parameter does not affect the tracing of log data on Set_Log_Data, Send_Error, or Deallocate calls. This prompt appears only if you specified *ON on the Trace option setting prompt.

128

The number of bytes for the user data length. This is the default value.

0-4096

The valid range of bytes for the user data length.

Trace Common Programming Interface (CPI) Communications continues to collect trace records until you stop the trace or until the trace storage area becomes full. The amount of trace storage depends on the value that is specified on the Trace full prompt. If the trace storage area becomes full and the collection of trace records stops, you must enter the TRCCPIC command again to create output. The output that is created by the TRCCPIC command is directed either to the spooled printer file, QSYSPRT, or to a database output file that you specify. If the output file that you specify already exists, it must have the same attributes as the system-supplied file, QACM0TRC.

You can stop a trace procedure in one of the following ways:

vUsing the System Menu

vTyping TRCCPIC *OFF on the command line

vAdding the TRCCPIC command to a CL or a REXX program

vTyping TRCCPIC on the command line and pressing F4 (Prompt)

Type TRCCPIC on the command line and press F4. Specify *OFF for the Trace option setting and you are prompted for the OUTPUT parameter.

Solving communication problems using the system problem log

Error conditions that are communications-related can make entries in the system problem log. You can access the log to see the lists of problems that are detected by the system or by the user.

To access the system problem log, type WRKPRB on any AS/400 command line, and press F4.

Tips: You can select a subset of the problems that are listed in the problem log by selecting the problem status. A problem that is listed in the log has one of the following as a status:

vOPENED: The problem was identified; problem analysis has not been run.

vREADY: The system has run problem analysis; the problem is ready to be prepared.

vPREPARED: The system added information that relates to the problem.

vSENT: The problem was sent to the service support location.

Chapter 8. Troubleshooting communications problems 83