TRACK
The TRACK (TRA) service provides a record of services invoked during the session and writes service output to a data set or SYSOUT.
Syntax
The parameters are defined as follows:
Parameter | Description |
|---|---|
xx | is a user-specified suffix You can track up to 32 services by placing the service names in a member in the BBPARM library data set. The member is named $$INTKxx, where xx is the user-specified suffix. |
class | specifies the SYSOUT class to which tracking output is routed |
dsname | allows specification of a data set name to which output is routed The data set must be preallocated with a record format of VBA and a logical record length of 137. |
ALL | initiates tracking for all user-invoked services |
START | initiates tracking for all user-invoked services |
STOP | terminates tracking |
FREE | deallocates tracking output If routed to SYSOUT, tracking output is passed to JES for immediate printing. |
Examples
To initiate the recording of all services and their output to the preallocated data set myid.output, type
TRACK,START,myid.OUTPUT
To initiate tracking of services specified in member $$INTK01, type
TRACK,01,A
The output will be written to SYSOUT class A.
To initiate tracking of all services and record the output in data set myid.output, type
TRACK,ALL,myid.OUTPUT
To stop tracking and free an output data set, type
TRACK,FREE
To stop tracking (leaving an output data set allocated), type
TRACK,STOP
$$INTKxx control statements
A $$INTKxx member is read from the BBPARM data set under two conditions:
- During initialization, when $$INTK00 is read and processed if present.
- Whenever a two-character suffix (xx) is specified as the first parameter on a TRACK command.
A $$INTKxx member can contain a TRACK command or a list of up to 32 services that are to be tracked. Each service must be listed on a separate line beginning in column 1.
When the $$INTKxx member contains a TRACK command, the second parameter specifies the SYSOUT class or data set name for the tracking output. If the first parameter is a suffix, it is ignored. If the first parameter is ALL, all services are tracked.
Syntax rules
- List each service on a separate statement.
- Begin each entry in column 1.
- Enter up to 32 services to be tracked.
Examples
The following statement in $$INTK00 will cause all services to be tracked and the tracking output to be written to a SYSOUT class T data set.
TRACK,ALL,T
The following statements will cause only the CSA and RSM services to be tracked. The tracking output will be written to data set MY.TRACK.DS. The TRACK command can be on any line. If multiple TRACK commands are present, only the last one will be used.
CSA
RSM
TRA,xx,MY.TRACK.DS
Usage notes
- Tracking provides a record of command input and output. You can request tracking for all services or up to 32 specific services. You can direct the tracking output to a SYSOUT data set or an existing cataloged data set.
- The tracking facility is controlled by the TRACK service. See TRACK for a description of this service.
- Tracking output is formatted with headings and time stamps. The output format is VBA, and the logical record length is 137 bytes.
- Tracking output is controlled by the second parameter on the TRACK command or by the TRACK DD statement if present. By default, output is written to SYSOUT class A.
Related topic