Part 10: Job History SMF data collection

A JOB_HIST SMF record is generated for each job submitted. Each record contains job-related and SMF data. This data is collected and then exported for analysis.

The following SMF data is collected:

Date and time of the job selected
System on which the job submitted
JES2 node
System ID
Original service class
Original input system
Service class name
Resource group name
Reporting class name
Scheduling environment name
Job preparation time
Original MSGCLASS
Input priority

You can find more information about the JOB_HIST SMF record in the DTMSMFJH mapping macro.

Activating JOB_HIST SMF records

JOB_HIST SMF data collection is enabled, is default. You must still make sure that the current SMFPRMxx member of PARMLIB permits the ThruPut Manager SMF records to be written.

Identifying JOB_HIST records

JOB_HIST records are identified by subtype 19. The subtype is displayed in the SMFJHSTP field in the DTMSMFJH mapping macro.

TM SMF TMSS Initialization Statement

The TM SMF TMSS initialization statement defines SMF data collection parameters. Use this statement to identify which SMF user record type to use to write ThruPut Manager SMF data, and which data to collect. For more information about implementing SMF data collection, see SMF-data-collection-for-job-analysis.

You can use the TM SMF statement to control the writing of Job History SMF records. By default, they are enabled.

Important

The DTMSMFJH mapping macro describes the Job History SMF data. For details of the SMF record, refer to this macro.

CSV format

A CSV file produced by the utility is a text file containing comma-delimited data. Each record of the file contains information about a specific job.

The Dates are in mm-dd-yyy format; times of day are in hh:mm:ss format. All other times (for example, accumulated CPU time) are in seconds.

The following fields appear on every line in the listed order:

Field	Description
Date	Date on which the initiator selected the job
Time	Time when the initiator selected the job
DateTime	Both the date and time
HHMMS0	Time in HHMMS0 format
DateHHMM	Date and time in MM/DD/YY HHMM format
HHMM	Time in HH:MM format
HHM0	Time in HH:M0 format
DateHr	Date and hour in MM/DD/YY HH:00 format
SMFSID	System identification
Sysplex	Sysplex name
JESplex	JESPlex name
JES2Mbr	JES2 member name
LPAR	LPAR or virtual machine name
SMFJHJBN	Job name
SMFJHJNM	JES job identifier
SMFJHT30_AST	Device allocation start time
SMFJHT30_PPS	Problem program start time
SMFJHT30_SIT	Time (from midnight) when the initiator selected the job
SMFJHT30_STD	Date on which the initiator selected the job
SMFJHRST	Time when the reader recognized the job card
SMFJHRSD	Date on which the reader recognized the job card
SMFJHT30_USR	Programmer's name
SMFJHT30_GRP	RACF group ID
SMFJHT30_RUD	RACF user ID
SMFJHT30_CL8	Job class
SMFJHT30_COR	JES job correlator
SMFJHNTFY	TSO user ID
SMFJHSHNV	Original scheduling environment
SMFJHWSCN	Original service class
SMFJHOICL_8	Original input class
SMFJHREPC	Original reporting class
SMFJHOrgInpSid	Original input system
SMFJHOrgInpDev	Input device name
SMFJHOrgInpNde	Input node name
SMFJHInpRmtNum	Remote number
SMFJHAcf2_Lid	ACF2 logon ID
SMFJHAcf2_Sid	ACF2 system ID
SMFJHAcf2_Uid	ACF2 user ID
SMFJHOMCL	Original MSGCLASS
SMFJHOIPR	Input priority
SMFJHSHLD	TYPRUN=HOLD specified (Y/N)
SMFJHRJBS	Job Binding Services (JBS) managed job (Y/N)
SMFJHRJLS	Job Limiting Services (JLS) managed job (Y/N)
SMFJHRJCS	Job Chaining Services (JCS) managed job (Y/N)
SMFJHRJTS	Job Timing Services (JTS) managed job (Y/N)
SMFJHRJSS	Job Setup Services (JSS) managed job (Y/N)
SMFJHRDJC	Dependent Job Control (DJC) managed job (Y/N)
SMFJHXNET	NET managed job (Y/N)
SMFJHXDBS	Drive Booking Services (DBS) managed job (Y/N)
SMFJHXVVS	Virtual Volume Staging (VVS) managed job (Y/N)
SMFJHXHSM	Hierarchical Storage Manager (HSM) managed job (Y/N)
SMFJHOafSysCnt	Load original affinity system name count (up to 32)
SMFJHOafSysNam_1	Original affinity system name 1
SMFJHOafSysNam_2	Original affinity system name 2
SMFJHOafSysNam_3	Original affinity system name 3
SMFJHOafSysNam_4	Original affinity system name 4
SMFJHOafSysNam_5	Original affinity system name 5
SMFJHOafSysNam_6	Original affinity system name 6
SMFJHOafSysNam_7	Original affinity system name 7
SMFJHOafSysNam_8	Original affinity system name 8
SMFJHOafSysNam_9	Original affinity system name 9
SMFJHOafSysNam_10	Original affinity system name 10
SMFJHInpSysNam	Input system name build by using the TM input system number
SMFJHJOBAC_1	Job accounting field 1
SMFJHJOBAC_2	Job accounting field 2
SMFJHJOBAC_3	Job accounting field 3
SMFJHJOBAC_4	Job accounting field 4
SMFJHSGCtr	SLM Control Center name
SMFJHSGTyp	SLM Work Type
SMFJHT30_AIS	DASD I/O start subchannel count for the address space
SMFJHT30_TEX	Total number of blocks transferred
SMFJHT30_SCC	Job termination condition code: Sccc,is an abnormal system end of task (abend) in the job step, where ccc is the system abend code. Uccc,a user abend in the job step, where ccc is the user abend code. cccc, a normal job completion with a return code cccc.
SMFJHTRstrtCt	Count of job restarts due to IPL or operator command (SLM jobs only)
SMFJHT30_CPT	Job CPU time under TCB
SMFJHT30_CPS	Step CPU time under SRB
SMFJHT30_ICU	Initiator CPU time under TCB
SMFJHT30_ISB	Initiator CPU time under SRB
SMFJHT30_IIP	Processor time used to process I/O interrupts
SMFJHT30_RCT	Processor time used by region control task
SMFJHT30_CEP	Cumulative CPU time consumed for an address space or job while enqueue promoted
SMFJHT30_ICU_Step_Term	CPU TCB time spent by the initiator
SMFJHT30_ICU_Step_Init	CPU TCB time spent by the initiator
SMFJHT30_ISB_Step_term	CPU SRB time spent by the initiator
SMFJHT30_ISB_Step_Init	CPU SRB time spent by the initiator
SMFJHT30_RGN	Region size established (in 1 KB units) rounded up to a 4-KB boundary
IEFUSI_Reg_Limit	Storage flag for IEFUSI changed region limit values for the extended private area (Y/N)
IEFUSI_Set_MEMLIMIT	Storage flag for IEFUSI set MEMLIMIT value (Y/N)
SMFJHT30_CSU_L	CPU service units
SMFJHT30_SRB_L	SRB service units
SMFJHT30_RES	System resources manager (SRM) transaction residency time
SMFJHT30_WLM	Workload name
SMFJHT30_SCN	Service class name
SMFJHT30_GRN	Resource group name
SMFJHT30_RCN	Reporting class name
SMFJHT30_PFL	Scheduling environment name
SMFJHT30_JQT	Job preparation time
SMFJHT30_RQT	Time job delayed due to system affinity, scheduling environment state or ThruPut Manager resource hold
SMFJHT30_HQT	Time job was ineligible to run due to reasons not included in SMF30JHT_RQT such as job held
SMFJHT30_SQT	Time between conversion and problem program start that the job was eligible to run
SMFJHT30FSCRPEX	Job service class association was modified by a system operator before the job initiation for non-SLM jobs. (Y/N)
SMFJHFSCRDEX	Service class reset by operator when running the job for both SLM and non-SLM jobs (Y/N)
SMFJHTFFSJOB	SLM START command used to force selection of SLM managed job (Y/N)
SMFJHFFJOBRST	Job restarted by the system operator (Y/N)
SMFJHT30_PTM	Number of non-specific tape mounts
SMFJHT30_TPR	Number of specific tape mounts

Creating a CSV format file

Use the DTMCSVJH utility program to read the Job History SMF records and intelligently process the SMF data to build a CSV format file. You can download the CSV file to a personal computer to process with spreadsheet software products such as Microsoft Excel.

Here is a sample of the JCL required that you should modify to conform with your installation standards:

//jobname JOB …

//S1      EXEC PGM=DTMCSVJH,PARM=’nnn’

//SMFIN   DD DSN=smfrecs,DISP=SHR

//CSV     DD DSN=csvdata,DISP=(,CATLG,DELETE),

//            UNIT=SYSDA,

//            SPACE=(appropriate space parameters)

In this example:

EXEC statement—Specify the three digit ThruPut Manager SMF record number (nnn) as provided on the TM SMF initialization statement in the TMSS parameters.
SMFIN DD statement—Specify the data set name of the file containing ThruPut Manager Job History SMF records. Concatenated DD statements are permitted.
CSV DD statement—Specify the data set name of the CSV output file. The format of the file is as follows: RECFM=VB, LRECL=4096, BLKSIZE=27920. It is an EBCDIC file that should be translated to ASCII when downloaded to a personal computer. Provide SPACE parameters appropriate to the amount of data.