CL Command Reference - CHGUSRTRC
CL Command List > CHGUSRTRC Reference
Description:
The Change User Trace Buffer (CHGUSRTRC) command changes the user trace buffer associated with the specified job. Each user trace buffer is a user space (*USRSPC) object in library QUSRSYS by the name QP0Znnnnnn, where ĄŻnnnnnnĄŻ is the job number of the job using the user trace.
The user trace supports user-generated trace records written using the Qp0zUprintf, Qp0zDump, Qp0zDumpStack, and Qp0zDumpTargetStack APIs.
The trace records written to the user trace buffer with the Problem Determination APIs can be formatted and placed into a file or written to the stdout file by using the DMPUSRTRC (Dump User Trace Buffer) CL command.
User trace buffer spaces can be deleted by using the DLTUSRTRC (Delete User Trace Buffer) CL command.
Examples:
Example 1: Changing the User Trace Buffer Size for the Current Job
CHGUSRTRC JOB(*) MAXSTG(100) CLEAR(*YES)
This command changes the user trace buffer size for the current job to 100 kilobytes.
Example 2: Clearing the User Trace Buffer for a Specific Job
CHGUSRTRC JOB(123581/DEPT2/WS1) CLEAR(*YES)
This command clears the user trace buffer for job WS1, which is associated with the user profile DEPT2, and has the job number 123581.