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.
The DT parameter allows you to gather GTF data at a later time. For example, to gather data from an IMS control region during heavy nighttime BMP processing, start BPLTRACE at 4:00 PM with DT=600; this delays the start of GTF for 10 hours, until 2:00 AM the following morning.
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.
When monitoring a DLI or DBB batch job, when BPLTRACE is started and the delay time has expired, it searches for an IMS batch subsystem with JOB=jobname specified. If the job name is not found, BPLTRACE searches the active jobs 10 times per minute until the wait time expires.
For example, to gather data for a DLI batch job that is expected to start four hours from the current time, use a WT=210 and DT=60. BPLTRACE will wait 3.5 hours to begin looking for the job, and continues searching for the next hour. If the job is not found at the end of the WT period, BPLTRACE issues a warning message and ends.
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.