SMF data collection for Job Analysis
This topic describes the SMF data collection facilities provided by ThruPut Manager to monitor activity during Job Analysis.
SMF Monitoring of ThruPut Manager Activity
A ThruPut Manager facility is provided for an installation to gather statistical information about ThruPut Manager's activity while analyzing jobs. An SMF record containing this information is generated for each job.
The data collected includes:
- CPU time used to interpret job.
- CPU time used to analyze job.
- Number of catalog LOCATEs.
- Number of DD statements.
- Number of DASD volumes and tape volumes.
Activating Data Collection
JEF data can be collected and made available automatically. To activate SMF data collection, you must include an initialization statement:
TM SMF TYPE(smf-record) [ANALYZER | ANALYZER(table-id[,subtable-id])] [DBS][DCS]
[SLM]
Is a number from the range 128 to 255, representing the SMF record number to be used.
Indicates that the Job Analyzer is to collect the default SMF data. See the following table ThruPut Manager SMF Performance Record.
Indicates that the Job Analyzer is to collect data in addition to the default data.
Is a number from the range 1-9, identifying the ThruPut Manager table containing the desired Token names for the additional data.
Is an optional 1-24 character name identifying the portion of the ThruPut Manager table that contains the desired Token names.
Indicates that the DBS application is to collect SMF data. Refer to the Drive Booking Services: System Programming Guide.
Indicates that the DCS application is to collect SMF data. Refer to the Dataset Contention Services: System Programming Guide.
Indicates that SLM data is to be recorded. For further details, refer to the Setup Guide to ThruPut Manager AE Essentials.
The mapping macro DTMSMFPR is provided to assist you in analyzing the collected data.
Summary of ThruPut Manager SMF Record
The following table is intended for use as a guide only. If there is a discrepancy between this summary and the mapping macro DTMSMFPR, the macro is correct. This table reflects only the data collected by default.
ThruPut Manager SMF PERFORMANCE RECORD | |||
|---|---|---|---|
For specific mapping, refer to macro DTMSMFPR | |||
Name | Type | Length | Description |
SMFTMLEN | binary | 2 | Record length |
SMFTMSEG | binary | 2 | Segment descriptor |
SMFTMFLG | binary | 1 | System indicator |
SMFTMRTY | binary | 1 | Record type |
SMFTMTME | binary | 4 | Time since midnight (in 100ths of seconds) record was sent to SMF writer |
SMFTMDTE | packed | 4 | Date (in the form yyddd) record was sent to SMF writer |
SMFTMSID | char | 4 | System identification |
SMFTMWID | char | 4 | Subsystem identifier |
SMFTMSTP | binary | 2 | Record subtype: 15 for ThruPut Manager 6 for DCS |
SMFTMJBN | char | 8 | Job name |
SMFTMRST | binary | 4 | Reader start time (in 100ths of seconds) |
SMFTMRSD | packed | 4 | Reader start date (yyddd) |
SMFTMJNM | char | 8 | JES job identifier |
SMFTMINT | binary | 4 | CPU time used by interpreter and Job Ana- lyzer initiation |
SMFTMJAT | binary | 4 | Total CPU time used by Job Analyzer |
SMFTMCTA | binary | 4 | Number of catalogs allocated during Job Analysis |
SMFTMLRQ | binary | 4 | Number of catalog locates required |
SMFTMLCM | binary | 4 | Number of catalog locates using catalog management |
SMFTMLCA | binary | 4 | Number of catalog locates using catalog lookaside |
SMFTMNDD | binary | 4 | Number of DD statements |
SMFTMNDA | binary | 4 | Number of DASD volumes |
SMFTMTC | binary | 4 | Number of tape cartridge volumes |
SMFTMJST | char | 4 | Job status (OKAY, FAIL, or FLSH) |
SMFTMACS | char | 1 | ACS support indicator (Y for active, N for inactive) |
SMFXFENO | binary | 4 | Number of XFE extensions |
SMFTMELP | binary | 8 | Elapsed time in Analyzer |
SMFTMNOM | binary | 1 | Number of this record |
SMFTMNON | binary | 1 | Total number of records |
If the field SMFTMNON is greater than 1, there is more than one SMF record for this job. If the records are sorted in ascending order by SMFTMNOM, the last record has been processed when SMFTMNOM equals SMGTMNON (i.e. m of n records).
Record Subtypes
Some ThruPut Manager applications allow you to collect SMF data specific to the application. The primary ThruPut Manager SMF record mapped by DTMSMFPR contains a subtype indicator in the field SMFTMSTP:
- 15 indicates a ThruPut Manager Analyzer record.
- 6 indicates a DCS record. For details about the use of this subtypes, refer to the Dataset Contention Services: System Programming Guide.
Collecting More Than Default JEF Data
The TM SMF initialization statement allows you to collect more than the default JEF data. The additional data is added to the SMF record in XFE format, except that the field XFENEXT is an offset, not an address. The offset is relative to the start of the SMF record, including the RDW.
To extract the additional data, you must create a ThruPut Manager table containing the tokens you wish to extract. ThruPut Manager tables are described in the Table (TBL) Function section.
The table is defined in the usual manner, except that any Token name containing the underscore (_) character must be enclosed in quotes.
Here is a sample table:
SUBTABLE(SMFDATA)
$JOBNAME,$INCLASS
$INSYSID
JLSLIMIT
‘$UNIT_CART_ALL’
If this table were called table 9 to match the SMF exit number, the load statement could look like this:
Now modify the TM SMF initialization statement to point to the table:
The XFEs are appended to the end of the standard ThruPut Manager SMF data. The DTMSMFPR macro has been updated to reflect this.