TRACE76

The TRACE76 control statement traces selected fields from MVS control blocks and summarizes the traced data in sets.

TRACE76
{FIELD=(name1,...,name109)}
[,SAMPLE={1000|nnnn}]
[,SAMPSET={60|nn}]

A set is a user-specified number of samples and contains maximum, minimum, and end snapshot values for each of the fields specified. The sum of their values and the sum of their squares are also included so that an average value and a standard deviation can be calculated.

Related topics

EXCEPTS

Exception-Trace-Detail-Report

GRAPH

WLMGRAPH

Graphics-Trace-Detail-Report

REPORT

Traceable-data-fields

Extractor-control-statements

Monitoring modes	One TRACE76 statement can be specified for each monitoring mode, continuous (CPM) or intermittent (IPM).
Sampler and record types	The TRACE76 statement controls the TRAS sampler, which produces SMF type 76 records.
Analyzer statements and reports	EXCEPTS GRAPH WLMGRAPH	Exception Trace Detail Report Graphics Trace Detail Report
	Important The EXCEPTS Analyzer statement must have TRACE=YES defined. The GRAPH and WLMGRAPH Analyzer statements must have TYPE=TRACE defined.
Other BMC Software products	The TRACE76 control statement is used by the BMC AMI Ops Monitor for CMF Extractor only.

Parameters

Parameters of the TRACE76 control statement are as follows:

FIELD=	name of the data field to be traced This parameter is required. You can specify up to 109 fields. Valid data field names are described in the topic that discusses traceable data fields. Important Measures and trace values provided in the topic that discusses traceable data fields contain variable information, such as device addresses, which reflects how the fields are reported in a graph. In defining measures, specify the full name of the measure—do not define the variable information.
SAMPLE=	rate, in milliseconds, between data gathering cycles The default is 1000 (1 second).
SAMPSET=	number of samples per set The default is 60.

SAMPLE and SAMPSET Usage Notes

These parameters directly impact the amount of ECSA that is required for the TRACE76 sampler. At initialization, the CMF Extractor obtains a pool of ECSA in the amount specified in the CSA parameter of the REPORT control statement. Increasing the SAMPLE or SAMPSET values, or decreasing the INTERVAL value on the REPORT control statement, reduces the ECSA requirement.

Calculating CSA

Use this equation to calculate CSA required by the TRACE76 sampler:

((W * 20 * N) + (X * 32 * N) + J) * 40

N—(INTERVAL * 60000)/(SAMPLE *SAMPSET)
W—number of two-byte fields to trace
X—number of four-byte fields to trace
J—number of fields

Example

REPORT CPM,INTERVAL=30,CSA=50,SMFRECID=240,RUNTIME=60
TRACE76 SAMPLE=1000,SAMPSET=60,FIELD=(CCVUTILP,LSCTMTE)

Fields CCVUTILP and LSCTMTE will be sampled every second, with 60 samples making up a one-minute sample set. The SMF 76 trace records, containing 30 sample sets, will be written each 30 minutes.

This example assumes one two-byte and one four-byte field and uses the previously mentioned equation to calculate CSA:

N = (30 * 60000) / (1000 * 60) = 30

1 * 20 * 30        =    600
1 * 32 * 30        =    960
((600 + 960) + 2) * 40 = 62480
                       = 62K