Use this command to start the macro counting function of the real-time
trace (RTT) utility. The RTT utility counts or traces the use of
specific macros and related system activity. The ZCNTM command creates
a list of the sleected macros and provides a total of executions for each
macro during the count period.
Use the ZTRAC command to start the macro tracing function. Use the
ZSTOP command to stop the macro tracing or macro counting function.
Requirements and Restrictions
Each ZCNTM command must have a corresponding ZSTOP command. If you
enter a second ZCNTM command before the count period is ended with a ZSTOP
command, the second ZCNTM command is rejected.
Format
- symmacopt
- is the symbolic name for the macro trace option. Specify one or
more of the following:
- ENBK
- counts enter-type macros and the BACKC macro.
- CRET
- counts the DEFRC and DLAYC, and create-type macros.
- CTRL
- counts the EXITC, LMONC, MONTC, and WAITC macros.
- FILE
- counts file-type macros and the UNFRC macros.
- FIND
- counts find-type macros.
- DATA
- counts the FLIPC, GETCC, and RELCC macros.
- POOL
- counts get file storage-type macros and the RELFC macro.
- SEND
- counts the CRASC macro and send-type macros.
- RTAP
- counts the real-time tape macros.
- GTAP
- counts the AMSSC and FDCTC macros, and the general tape macros.
- MISC
- counts miscellaneous macros.
- SON
- counts SON macros.
- nummacopt
- is the numeric value for the macro trace option. Specify one of the
following:
- 0
- counts SXSVC macros.
- 1
- counts enter-type macros and the BACKC macro.
- 2
- counts the DEFRC and DLAYC, and create-type macros.
- 3
- counts the EXITC, LMONC, MONTC, and WAITC macros.
- 4
- counts file-type macros and the UNFRC macros.
- 5
- counts find-type macros.
- 6
- counts the FLIPC, GETCC, and RELCC macros.
- 7
- counts get file storage-type macros and the RELFC macro.
- 8
- counts the CRASC macro and send-type macros.
- 9
- counts the real-time tape macros.
- A
- counts the AMSSC and FDCTC macros, and the general tape macros.
- B
- counts miscellaneous macros.
- D
- counts SON macros.
- F
- counts 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 macro options. This is the same as entering
ZCNTM F, using the numeric F for all macro options.
- Note:
- You must leave a blank space after the ALL parameter for the command to
process correctly.
Additional Information
All output from the RTT utility is written to the real-time tape
(RTL/RTA). Use the offline diagnostic output formatter (DOF) utility to
process the RTT output.
Examples
In the following example all macros are counted.
+--------------------------------------------------------------------------------+
|User: ZCNTM ALL |
| |
|System: RTT IN |
| |
+--------------------------------------------------------------------------------+
In the following examples macros issued from programs beginning with the
names ABC, EFC, and EFG are counted. The first example uses the
symbolic macro parameter and the second example uses the numeric macro
parameter. These are examples using the P trace mode.
+--------------------------------------------------------------------------------+
|User: ZCNTM SEND PABC/EFC/EFG |
| |
|System: RTT IN |
| |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|User: ZCNTM 8PABC/EFC/EFG |
| |
|System: RTT IN |
| |
+--------------------------------------------------------------------------------+
Related Information