BPLTRACE started task parameters
To perform the task of gathering trace data, the BPLTRACE started task uses the following parameters:IMSID, JOB, DT, WT, and GT. There are four additional parameters in the BPLTRACE PROC that must also be specified, but these parameters (SBPLLINK, PARMLIB, GTFPROC, and RGN) should be set in the actual PROC JCL, and should not need to be specified as part of the START command.
The following parameters are available for the BPLTRACE started task.
- IMSID
- The IMSID of an IMS DB/DC or DBCTL subsystem to be
monitored. Either the IMSID or JOB parameter must be
specified, but not both.
When monitoring DEDB lookaside buffer pools, IMS RESLIB must be specified in STEPLIB/JOBLIB DD of the IMS subsystem or IMS RESLIB must be concatenated to LINKLIST.
- JOB
- The name of an IMS batch (DLI or DBB region type) job to be monitored. Either the IMSID or JOB parameter must be specified, but not both.
- DT
- Delay time. The number of minutes to wait before starting to look for the IMS subsystem or batch job name. The number of minutes can range from 0 to 9999. Zero (or no specification) results in no delay time.
- WT
- Wait time. The number of minutes to wait for the named JOB to start (after the delay time). The number of minutes can range from 0 to 9999. Zero (or no specification) results in no wait time.
- GT
- GTF time. The number of minutes to gather GTF data. The number of minutes can range from 1 to 9999.
Tip: For batch DLI or DBB jobs,
BPLTRACE stops the trace activity automatically when the job step
ends.