Allocating a trace medium

Overview

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.

Allocation methods

Two methods are available to allocate a medium. The method chosen depends on whether a started task or batch job will be used:

  • dynamic medium allocation for a started task (STC). This uses the MODIFY command. Note: Use dynamic allocation for started tasks only.
  • direct medium allocation for a batch job by means of an entry in the DD statement BSATRACE.

Dynamic allocation

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)

-

Examples

F stcname,TR ALLOC 'SYSOUT(P,TRACE,STD)'

F stcname,TR ALLOC 'SUBSYS(B93P,STD,TRACE)'

F stcname,TR ALLOC 'BSA.TEST.TRACE'

Result for the STC

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.

Direct allocation

To allocate a medium for a batch job, specify the medium directly in the DD statement BSATRACE.

Examples

//BSATRACE DD SYSOUT=(P,TRACE,STD)

//BSATRACE DD SUBSYS=(B93P,STD,TRACE)

//BSATRACE DD DSN=BSA.TEST.TRACE,DISP=SHR

Result for batch

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.