gtpo1m2sOperations

ZCNTM-Start Macro Counting for the Real-Time Trace Utility

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