The default writes trace output to the system log (SYSLOG) and the job log (JESMSGLG) of a started task (STC) or batch job.
First, allocate a medium for the BSA trace. Next, activate the BSA trace via BSA trace keywords. See details below.
Two methods are available to allocate a medium. The method chosen depends on whether a started task or batch job will be used:
To dynamically allocate a medium for a started task (STC), you can either use online option 2.7 of the BSA Service Manager for the Dynamic Trace Facility, or use the following MODIFY command:
F stcname,TR ALLOC 'output medium'
Enter the name of the started task in use and replace medium by the medium you want to allocate – an output class, a subsystem or a dataset. You can enter a total of 128 characters for the entire MODIFY command.
Replace... |
with ... |
Details |
Parameters |
started task name |
the started task (STC) |
the name of the started task in use |
- |
'output medium' |
an output class |
SYSOUT(c[,ext,form]) |
Replace c with the output class. In addition, you can enter the extension and the format. |
|
a subsystem |
SUBSYS(s[,form,ext]) |
Replace s with the subsystem ID. In addition, you can enter the format and the extension. |
|
a dataset |
the name of the dataset you want to use (if you want to suppress trace output, enter dummy or nullfile) |
- |
F stcname,TR ALLOC 'SYSOUT(P,TRACE,STD)'
F stcname,TR ALLOC 'SUBSYS(B93P,STD,TRACE)'
F stcname,TR ALLOC 'BSA.TEST.TRACE'
Once the output medium has been successfully allocated (message 9152I), the requested trace data and all product messages will be logged on the specified medium from this point on. The trace output is displayed under the DD statement BSATRACE.
To allocate a medium for a batch job, specify the medium directly in the DD statement BSATRACE.
//BSATRACE DD SYSOUT=(P,TRACE,STD)
//BSATRACE DD SUBSYS=(B93P,STD,TRACE)
//BSATRACE DD DSN=BSA.TEST.TRACE,DISP=SHR
Once the output medium has been successfully allocated (message 9152I), the requested trace data and all the product messages will be logged onto the specified medium from this point on. The trace output is displayed under the DD statement BSATRACE.