Delete User Trace (DLTUSRTRC)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Delete User Trace Buffer (DLTUSRTRC) command deletes the user trace buffer and records for a specified job.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| JOB | Job name | Single values: * Other values: Qualified job name |
Optional, Positional 1 |
| Qualifier 1: Job name | Generic name, name, *ALL, *CURRENT | ||
| Qualifier 2: User | Generic name, name, *ALL, *CURRENT | ||
| Qualifier 3: Number | 000000-999999, *ALL |
| Top |
Job name (JOB)
Specifies the jobs for which the user trace buffers are to be deleted.
The possible values are:
- *
- The user trace buffer for the job that the command is running in is deleted.
The possible Job Name Qualifier values are:
- *ALL
- The user trace buffers for all jobs that match the specified user name and job number are deleted.
- *CURRENT
- The user trace buffers for all jobs with the current job's name are deleted.
- job-name
- Specify the name of the job whose user trace buffer is being deleted.
- generic*-job-name
- Specify the generic job name of the jobs whose user trace buffers are being deleted.
The possible User Name Qualifier values are:
- *ALL
- The user trace buffers for all jobs that match the specified job name and job number are deleted.
- *CURRENT
- The user trace buffers for all jobs with the current job's user name are deleted.
- user-name
- Specify the name of the user of the job whose user trace buffer is being deleted.
- generic*-user-name
- Specify the generic user name of the jobs whose user trace buffers are being deleted.
The possible Job Number Qualifier values are:
- *ALL
- The user trace buffers for all jobs that match the specified job name and user name are deleted.
- job-number
- Specify the six-digit number of the job whose user trace buffer is being deleted.
| Top |
Examples
Example 1: Delete User Trace Buffer for Current Job
DLTUSRTRC
This command deletes the user trace buffer for the current job.
Example 2: Delete User Trace Buffers for a Specific User
DLTUSRTRC JOB(*ALL/JSMITH/*ALL)
This command deletes all user trace buffers for jobs that have a user name of JSMITH.
| Top |
Error messages
*ESCAPE Messages
- CPFA98D
- The User Trace buffer associated with job &3/&2/&1 could not be deleted.
| Top |