TRACE_FILE_LINES - UDM Manager configuration option

Owned by Stonebranch (Deactivated)
Jul 15, 2024
2 min read

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

Command Line, Short Form

n/a





Command Line, Long Form

-tracefilelines number


(tick)

(tick)

(tick)

Environment Variable

UDMTRACEFILELINES=number

(tick)

(tick)

(tick)


Configuration File Keyword

trace_file_lines number

(tick)

(tick)

(tick)

(tick)

STRUDM Parameter

TRCLINES(number)

(tick)




Values

number is the maximum number of lines.

Default is 200,000.


IBM i

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

Note

  1. The file is not created until the first time Universal Data Mover Manager 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 that the file may contain, use the RMVM FILE(*CURLIB/UNVTRCUDM) MBR(*ALL) command. Substitute an appropriate library for *CURLIB if needed.

 
Setting a 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.

UNIX

The average size of a trace file line is 50 characters.

z/OS

This option has no effect when the UNVTRACE ddname allocates a JES SYSOUT data set.
 
The average size of a trace file line is 50 characters.