/
TRACE_FILE_LINES - UDM Server configuration option

TRACE_FILE_LINES - UDM Server configuration option

Jan 31, 2024

 Description

The TRACE_FILE_LINES option specifies the maximum number of lines to write to the trace file.

When the maximum number of lines has been reached, the trace file will wrap around and start writing trace entries after the trace header lines.

Tracing is activated, and a trace file is generated, when the MESSAGE_LEVEL option is set to TRACE.

Usage

Method

Syntax

IBM i

UNIX

Windows

z/OS

Configuration File Keyword

trace_file_lines number

Values

IBM i

The current record length is 384 characters.
 
As allocated on the AS/400 (i5), the maximum number of records is 509,000. Increasing TRACE_FILE_LINES beyond this value requires manual adjustment of the file size via the CHGPF command.
 

Note

  1. The file is not created until the first time Universal Data Mover Server trace is used.

  2. Deleting the trace file will reset the maximum number of records to 509,000.

  3. To clear the trace file without resetting the maximum number of records the file may contain, use the RMVM FILE(UNVTMP510/UNVTRCUDM) MBR(*ALL) command. Substitute the default library designated during product installation if different from UNVTMP510.

  4. WARNING: Setting this number of records larger than the maximum number of records allocated to the trace file will result in a prompt sent to QSYSOPR. Unless a default response is set for this message (CPA5305), the PROCESS WILL HANG waiting for the QSYSOPR response.

 
Default is 200,000.
 
If space is limited in the ASP where the trace file is located, set this to a smaller value. To avoid trace file wrapping, set this to a larger value. Please read the trace_file_lines information in the UNVCONF(UDMS) file member before increasing this value.

UNIX

The average size of a trace file line is 50 characters.
 
Default is a very large value of 200,000. If space is limited in the trace file directory (specified with the TRACE_DIRECTORY option), set this to a smaller value.

z/OS

The average size of a trace file line is 50 characters.
 
The trace file wrapping is only supported with sequential data sets that have a fixed record format. Partitioned data sets or variable record formats are not supported.
 
Default is 200,000.