gtpo1mgfOperations

ZTRAC-Start Macro Tracing for the Real-Time Trace Utility

Use this command to start the macro tracing function of the real-time trace (RTT) utility. The RTT utility counts or traces the use of specific macros and related system activity. When you enter the ZTRAC command, the RTT utility traces any macros, including fast wait and fast link (non SVC) macros. The amount of trace data collected is determined by the parameters specified.

Use the ZCNTM command to start the macro counting function. Use the ZSTOP command to stop the macro tracing or macro counting function.

Requirements and Restrictions

Each ZTRAC command must have a corresponding ZSTOP command. If you enter a second ZTRAC command before the count period is ended with a ZSTOP command, the second ZTRAC command is rejected.

Format




symoutopt
is the symbolic name for the output trace option. Specify one or more of the following:

MIN
specifies the minimum output, which includes the:
  • Macro name and parameters
  • Address of the macro in a program
  • Contents of register 8 (R8) and R9
  • Condition code at the time the macro was processed
  • Terminal address.

REGS
includes the application registers in the output.

ECBW
includes the entry control block (ECB) work area in the output.

ECBR
includes the ECB contents relevant to the macro group in the output. If you specify this value, the output generated for each macro varies with each macro. See Table 13 for more information about the additional output generated for each macro.

CORE
includes the main storage blocks attached to the ECB in the output. If you specify this value, the output generated for each macro varies with each macro. See Table 13 for more information about the additional output generated for each macro.

USER
includes the user work area (expanded ECB) in the output.

symmacopt
is the symbolic name for the macro trace option. Specify one or more of the following:

ENBK
traces enter-type macros and the BACKC macro.

CRET
traces the DEFRC and DLAYC, and create-type macros.

CTRL
traces the EXITC, LMONC, MONTC, and WAITC macros.

FILE
traces file-type macros and the UNFRC macros.

FIND
traces find-type macros.

DATA
traces the FLIPC, GETCC, and RELCC macros.

POOL
traces get file storage-type macros and the RELFC macro.

SEND
traces the CRASC macro and send-type macros.

RTAP
traces the real-time tape macros.

GTAP
traces the AMSSC and FDCTC macros, and the general tape macros.

MISC
traces miscellaneous macros.

SON
traces SON macros.

numoutopt
is the numeric value for the output trace option. Specify one or a combination of the following:

00
specifies the minimum output, which includes the:
  • Macro name and parameters
  • Address of the macro in a program
  • Contents of register 8 (R8) and R9
  • Condition code at the time the macro was processed
  • Terminal address.

01
includes the application registers in the output.

02
includes the ECB work area in the output.

04
includes the ECB contents relevant to the macro group in the output. If you specify this value, the output generated for each macro varies with each macro. See Table 13 for more information about the additional output generated for each macro.

08
includes the main storage blocks attached to the ECB in the output. If you specify this value, the output generated for each macro varies with each macro. See Table 13 for more information about the additional output generated for each macro.

10
includes the user work area (expanded ECB) in the output.

1F
includes all output options in the output.

You can combine numeric output options; that is, you can add the values through binary arithmetic and enter that sum for the trace output value. For example, if you want to collect the ECB work area (02) and the ECB areas relevant to the macro (04), specify 06 for the output option.

nummacopt
is the numeric value for the macro trace option. Specify one of the following:

0
traces SXSVC macros.

1
traces enter-type macros and the BACKC macro.

2
traces the DEFRC and DLAYC, and create-type macros.

3
traces the EXITC, LMONC, MONTC, and WAITC macros.

4
traces file-type macros and the UNFRC macros.

5
traces find-type macros.

6
traces the FLIPC, GETCC, and RELCC macros.

7
traces get file storage-type macros and the RELFC macro.

8
traces the CRASC macro and send-type macros.

9
traces the real-time tape macros.

A
traces the AMSSC and FDCTC macros, and the general tape macros.

B
traces miscellaneous macros.

D
traces SON macros.

F
traces all macros.

You cannot combine numeric macro options. If you want to specify more than one macro option for a command, use the symbolic macro option values.

Alniata
specifies the A trace mode. The A trace mode limits the RTT utility to activity assoiated with messages from specified terminals, where lniata is the line number, interchange address, and terminal address (LNIATA). If you specify this parameter, the RTT utility is activated whenever the specified macro is issued by a program activated as a result of a message from one of the identified terminals. Keep the following in mind when specifying the value for lniata:
  • Specify 2, 4, or 6 hexadecimal characters. A 2-character value represents a line number for LNIATAs. A 4-character value represents a line/interchange for LNIATAs. A 6-character value represents the entire LNIATA.
  • You can specify multiple LNIATAs on the same command (separated by the / character), but the LNIATAs must all have the same length. SLC link numbers may be specified as a line number, right-justified, and padded by zeros to meet the 4-character or 6-character length requirement.
  • You can specify synchronous data link control (SDLC) pseudo LNIATAs in the same way as actual LNIATAs. You can specify locally attached 3270s in the same way as line numbers. The IA and TA are both X'00'. You can specify SDLC pseudo line numbers for SDLC SNA devices, which must be 6 characters long. The pseudo LNIATA is used to refer to an SDLC SNA device (network control program (NCP), line, cluster controller, or logical unit).
  • References can be made to different devices on the same command.
  • SDLC pseudo line numbers can to intermixed with LNIATAs on the same command. The SDLC pseudo line numbers must be 6 characters long. The LNIATAs can be 2, 4, or 6 characters long. Any SDLC pseudo line numbers specified are not counted in the maximum number of LNIATAs that can be specified.
  • If you do not specify particular address parameters, you can use the ALL parameter to trace input from all terminal addresses (including SDLC pseudo lines).

Ffileaddr
specifies the F trace mode. The F trace mode limits the RTT utility to activity associated with specified file addresses, where fileaddr is a 4- or 8-byte file address. If you specify this parameter, the RTT utility is activated whenever file-type macros use the identified file addresses. You can specify the ALL parameter to trace all ECBs that reference file addresses and these file addresses can be 4- or 8-byte file addresses. You can specify multiple file addresses (separated by the / character); however, the specified file addresses must have the same length: all 4- or 8-byte addresses.

Ppgm
specifies the P trace mode. The P trace mode limits the RTT utility to activity of the macros issued by specified programs, where pgm is the 1- to 4-character name of the program to be traced or counted. If you specify this parameter, the RTT utility is activated whenever the specified macro is issued by the identified program. You can specify multiple program names (separated by the / character) on one command; however, all the names must be the same length: all 1, 2, 3, or 4 characters.

Ssnanode
specifies the S trace mode. The S trace mode limits the RTT utility to activity associated with messages from specified SNA node names, where snanode is the 1- to 8-character node name of the SNA logical unit (LU). Keep the following in mind when specifying the value for snanode:
  • The node names must be associated with the CPU running the RTT utility.
  • You can specify multiple SNA node names on the same command (separated by the / character), but length of the command, including the action code and end-of-message (EOM) character does not exceed the device limit.
  • You can use the ALL parameter to trace all ECBs generated by SNA input or output.

DISPLAY
displays all symbolic parameters.

ALL
specifies all output options and all macro options. This is the same as entering ZTRAC 1FF, using the numeric values 1F for all output options and F for all macro options.

Notes:

  1. You must leave a blank space after the ALL parameter for the command to process correctly.

  2. Use caution when specifying the amount of trace output to be collected, especially in an online environment. If you request a trace of all output for all macro activity for all ECBs (ZTRAC ALL or ZTRAC 1FF), storage capacity and printout resources may be immediately depleted as the RTT utility tries to collect the maximum trace output for every macro process. The TPF system issues the AB0007 system error when this occurs. See Messages (System Error and Offline) for more information about the AB0007 system error.

Additional Information

Examples

In the following examples tracing occurs when an ECB communicates with SLC link number 4A, and with terminals 3B attached to the pseudo SLC line number 50, interchange 01. The first example uses the symbolic parameters and the second example uses the numeric parameter. These are examples using the A trace mode.

+--------------------------------------------------------------------------------+
|User:   ZTRAC ECBR/REGS/ENBK A00004A/50013B                                     |
|                                                                                |
|System: RTT IN                                                                  |
|                                                                                |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|User:   ZTRAC 051A00004A/50013B                                                 |
|                                                                                |
|System: RTT IN                                                                  |
|                                                                                |
+--------------------------------------------------------------------------------+

The trace output for these examples is:

In the following examples one specified file record is traced. The first example uses the symbolic parameters and the second example uses the numeric parameter. These are examples using the F trace mode.

+--------------------------------------------------------------------------------+
|User:   ZTRAC CORE/FILE F020C0311                                               |
|                                                                                |
|System: RTT IN                                                                  |
|                                                                                |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|User:   ZTRAC 084F020C0311                                                      |
|                                                                                |
|System: RTT IN                                                                  |
|                                                                                |
+--------------------------------------------------------------------------------+

The trace output for these examples is:

In the following examples programs beginning with the names ABC, EFC, and EFG are traced. The first example uses the symbolic parameters and the second example uses the numeric parameter. These are examples using the P trace mode.

+--------------------------------------------------------------------------------+
|User:   ZTRAC REGS/SEND PABC/EFC/EFG                                            |
|                                                                                |
|System: RTT IN                                                                  |
|                                                                                |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|User:   ZTRAC 018PABC/EFC/EFG                                                   |
|                                                                                |
|System: RTT IN                                                                  |
|                                                                                |
+--------------------------------------------------------------------------------+

The trace output for these examples is:

In the following examples tracing occurs on all entries generated from the single LU with a node name of DEVICE1 or DEVICE2. The first example uses the symbolic parameters and the second example uses the numeric parameter. These are examples using the S trace mode.

+--------------------------------------------------------------------------------+
|User:   ZTRAC CORE/CTRL SDEVICE1/DEVICE2                                        |
|                                                                                |
|System: RTT IN                                                                  |
|                                                                                |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|User:   ZTRAC 083SDEVICE1/DEVICE2                                               |
|                                                                                |
|System: RTT IN                                                                  |
|                                                                                |
+--------------------------------------------------------------------------------+

The trace output for these examples is:

Related Information