# jCL TR

Tags: jcl

# Description

The command traces jCL program execution and displays each command (source line) before it is executed.

TR {ON}
TR OFF

1
2

The TR command will help you to test and debug your jCL programs.A general purpose trace program may be provided by creating a jCL program called TRACE in the file defined by the JEDIFILENAME_MD environment variable. The TRACE program should look like this:

TRACE
001 PQN
002 TR ON
003 (%1 %2)

1
2
3
4

Run the TRACE program like this:

TRACE jcl_file jcl_program

If the target program relies on the initial content of the PIB, the following line will have to be inserted into the program like this:

002 MV %1 %2,*

to move the PIB parameters to their required positions - otherwise the word TRACE will appear in %1 and the jCL program name (normally in %1) will be in %2.

# Example

PQN
TR
MV %21 ","," "
MV %98 1,A
S21
U147F
T MTS
S23
U147F
D D2
T "Today"s date is ", %23
T "the time is ",%21
TR OFF

1
2
3
4
5
6
7
8
9
10
11
12
13

will output:

MV %21 ","," "
MV %98 1,A
S21
U147F
S23
U147F
T "Today"s date is ", %23
Today"s date is 01/01/95
T "the time is ",%21
the time is 19:30:32

1
2
3
4
5
6
7
8
9
10

Line 2 turns the trace on. Line 13 turns it off.

Back to jCL.